36 lines
1.1 KiB
Markdown
36 lines
1.1 KiB
Markdown
# GIT-SOP
|
|
|
|
## 目标
|
|
- 降低冲突。
|
|
- 保证“先同步再提交”。
|
|
- 避免长期共享记忆被多人同时频繁改写。
|
|
- 保证 task/agent/daily 记录优先 append-only。
|
|
- 建立稳定的 promote 流程。
|
|
|
|
## 标准流程
|
|
1. 修改前同步
|
|
- `git fetch --prune origin`
|
|
- `git pull --rebase`
|
|
- 确认当前分支与远端一致。
|
|
|
|
2. 写入阶段
|
|
- 优先写私域和过程态目录：`agents/<id>/`、`tasks/<id>/`、`daily/`。
|
|
- 原始观察不直接进入 `shared/long-term/`。
|
|
|
|
3. 提交阶段
|
|
- 小步提交，一次提交只做一类修改。
|
|
- commit message 建议包含 `task:<id> agent:<id> scope:<lane>`。
|
|
|
|
4. push 后语义
|
|
- push 仅表示“已提交到远端”，不代表群体立即可见。
|
|
- 必须等待远程服务完成 `fetch + qmd update`。
|
|
|
|
5. promote 阶段
|
|
- 仅把稳定事实从 `task/agent/daily` 提炼至 `shared/long-term/`。
|
|
- promote 提交应附来源路径与证据引用。
|
|
|
|
## 冲突处理
|
|
- `daily/RUNLOG/inbox`：按 append-only 思路合并。
|
|
- `shared/long-term/*`：禁止自动粗暴合并，必须人工审阅。
|
|
- 无法确认语义一致时，先保留原始记录，再单独提交整理。
|