# 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/*`：禁止自动粗暴合并，必须人工审阅。
- 无法确认语义一致时，先保留原始记录，再单独提交整理。