81 lines
2.4 KiB
Markdown
81 lines
2.4 KiB
Markdown
# 收尾模板
|
||
|
||
<!--
|
||
用途：一轮实现或一个 Plan 结束后形成可交付摘要，并把下一轮仍重要的信息留痕。
|
||
触发：准备结束当前任务、切换上下文、交付结果前。
|
||
-->
|
||
|
||
## 目标
|
||
|
||
确认当前任务已经形成可交付结果，并把后续工作所需的信息留痕。
|
||
|
||
## 先读
|
||
|
||
- `AGENT_RULES.md`
|
||
- `memory-bank/active-context.md`
|
||
- `memory-bank/progress.md`
|
||
|
||
## 规则
|
||
|
||
- 如本轮来自 `main_loop.py claim` 且任务状态变更，优先通过
|
||
`main_loop.py finish` 留痕
|
||
- 如本轮来自 `main_loop.py claim` 且结果为 `done`，`finish` 之后还必须
|
||
完成当前 Plan 变更归档/提交；未归档不得声明 Plan 完成
|
||
- 未验证内容必须显式说明
|
||
- 只写对下一轮仍重要的信息
|
||
- 不手工改写 `workflow-state` 或 `plan-status` 状态块
|
||
|
||
## 执行步骤
|
||
|
||
1. 核对已完成项与未完成项
|
||
2. 核对已运行验证与未运行验证
|
||
3. 如本轮来自 `main_loop.py claim`，核对 `main_loop.py finish`
|
||
是否已经写回 `plan-status`
|
||
4. 如本轮来自 `main_loop.py claim`，核对 `workflow-state.phase`
|
||
是否与当前结果一致
|
||
5. 如需回写上下文，更新 `active-context`、`progress` 上半部分和 `decisions`
|
||
6. 如本轮来自 `main_loop.py claim` 且结果为 `done`，按项目归档机制只归档
|
||
当前 Plan 相关差异
|
||
7. 复核剩余差异是否属于其他 session / 其他 Plan，且未混入本轮交付单元
|
||
8. 输出本轮摘要与下一步
|
||
|
||
## 状态留痕复核
|
||
|
||
- 如本轮来自 `main_loop.py claim`，`main_loop.py finish` 是否已经写回
|
||
`plan-status`
|
||
- 如本轮来自 `main_loop.py claim`，`workflow-state.phase` 是否与当前结果一致
|
||
- 如本轮来自 `main_loop.py claim` 且结果为 `done`，当前 Plan 相关差异
|
||
是否已经归档/提交，或是否已说明无当前 Plan 差异
|
||
- 如为代码类执行，`workflow-state` 中是否保留了
|
||
`executor=executing-plans` 与既定 `constraints`
|
||
|
||
## 输出协议
|
||
|
||
```markdown
|
||
## Completed
|
||
- ...
|
||
|
||
## Not Completed
|
||
- ...
|
||
|
||
## Verification
|
||
- ...
|
||
|
||
## Risks
|
||
- ...
|
||
|
||
## Next Steps
|
||
- ...
|
||
```
|
||
|
||
## 停止条件
|
||
|
||
- 如已领取 Plan 但状态未写回，先完成留痕再收尾
|
||
- 如当前 Plan 结果为 `done` 但相关差异未归档/提交，停止并完成归档；
|
||
只能报告“状态已写回，交付未完成”
|
||
- 如验证不足以支持交付，停止并标记风险
|
||
|
||
---
|
||
|
||
**最后更新**：{{DATE}}
|