collective-memory-repo/policies/GIT-SOP.md

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