📝 docs(main_loop): enforce plan archive completion gate

This commit is contained in:
csh
2026-05-28 08:57:01 +08:00
parent 0093fbf341
commit e87be183bc
4 changed files with 45 additions and 2 deletions
+6
View File
@@ -228,6 +228,10 @@ python {{PLAYBOOK_SCRIPTS}}/main_loop.py finish \
### Plan 完成归档契约
- 归档指按当前项目约定创建可回溯的交付记录;如项目使用 Git,
归档必须是一次 Git 提交(commit),不是仅更新 memory 或回复摘要
- `main_loop.py finish -status done` 只负责写回机器状态,不代表 Plan
已完成交付
- Plan `done` 后必须完成当前 Plan 变更的归档/提交,然后才能继续领取下一个
Plan;归档方式由项目约定决定
- 收尾顺序:
@@ -248,6 +252,8 @@ python {{PLAYBOOK_SCRIPTS}}/main_loop.py finish \
- 不得由 `main_loop.py finish` 自动执行提交或变更归档
- 不得把用户已有改动或其他 Plan 的改动混入当前 Plan 交付单元
- 如 Plan `done` 后没有当前 Plan 相关差异,必须在回复中说明无归档原因
- 如当前 Plan 相关差异仍未归档,只能声明“状态已写回,交付未完成”,
不得声明 Plan 完成
- `blocked` / `skipped` 不默认归档/提交代码改动;只有状态留痕或已验证的
局部成果需要保留时才归档/提交
- 继续领取下一个 Plan 前,必须确认当前 Plan 无遗留差异;如剩余差异属于