36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
---
|
||
title: "Git-as-Audit-Log"
|
||
type: concept
|
||
tags: [version-control, git, audit, multi-agent]
|
||
sources: [autonomous-project-management]
|
||
last_updated: 2026-04-22
|
||
---
|
||
|
||
## 定义
|
||
将所有状态变更（包括 [[Shared State Coordination]] 中的 STATE.yaml 变更）作为 Git 提交处理，从而获得完整可追溯的决策和执行历史的方法。
|
||
|
||
## 核心实践
|
||
每次对 STATE.yaml 的修改都触发一个 Git 提交：
|
||
```bash
|
||
# 状态更新后
|
||
git add STATE.yaml
|
||
git commit -m "task(id=xxx): updated status from in_progress to done"
|
||
```
|
||
|
||
## 价值
|
||
1. **完整历史追溯**：任意时刻可回滚到任何历史状态
|
||
2. **决策上下文保留**：每次变更的 commit message 即变更理由的记录
|
||
3. **团队协作基础**：多成员可查看、review 状态变更历史
|
||
4. **自动化 CI/CD 集成**：可基于 Git 状态变更触发后续流程
|
||
|
||
## 在 [[autonomous-project-management]] 中的角色
|
||
- 规则明确：All state changes committed to git
|
||
- 每个 PM 子 Agent 负责自己 STATE.yaml 的 Git 提交
|
||
- 结合 [[Git-as-Audit-Log]] 和 [[Shared State Coordination]]，实现自文档化的项目协调
|
||
|
||
## Commit Message 约定
|
||
建议格式：`[type](task_id): description`
|
||
- `type`: started / updated / completed / blocked / unblocked
|
||
- `task_id`: 对应 STATE.yaml 中的任务 ID
|
||
- `description`: 变更的具体内容
|