closing-the-loop

name	closing-the-loop
description	所有任务完成后激活。确认实现完整性 → roadmap 记录 → 跨项目经验提炼 → 分支收尾 → 本地 git commit。刚性技能。

此技能是刚性技能。任何一步都不能跳过。没有闭环，知识就无法积累，下一次任务仍然是冷启动。 未完成闭环 = 任务未交付。

Closing the Loop：闭环确认 + 经验提炼 + 收尾

技能类型：刚性

严格遵循。闭环是编码的一部分，不是可选的附加步骤。

---

核心哲学

每一次编码不只是完成当前任务，而是为未来所有项目积累资产。

没有闭环：每次任务 → 冷启动 → 从零开始
有闭环：  每次任务 → 命中已有模式 → 快速完成 → 回写新经验

---

钢印 5 项（逐项确认）

1. 确认实现完整性

对照 writing-plans 计划逐项核对：

• 所有任务组 TDD 三元组已完成？
• 所有子功能 8 维审查通过（P0=0, P1=0）？
• 所有子功能全量测试通过？
• 全场景集成测试通过？

任一项未完成 → 停止，退回 implementing 补全。

2. 代码仓库 Git Commit

cd {项目目录} && git add -A && git commit -m "{描述}"

只做本地 commit，不 push。（用户指定：代码之外的 Git 操作均在本地进行。）

判据：git status 干净。

3. Roadmap 追加

主代理执行（roadmap 需要全局视角）。向 knowledge-base/{项目名}/{项目名}-roadmap.md 追加：

§5 实现记录新增行

| 日期 | 步骤 | 做了什么 | 涉及文件 | 验证结果 |
|------|------|---------|---------|---------|
| 06-23 | N | {描述} | {文件列表} | ✅ 审查通过 / ✅ 测试通过 |

§2 阶段规划更新

• 完成的 Feature 打勾
• 新增的 Feature 追加

§3 接口清单更新（如有新增 API/技能/组件）

• 后端：新增 API 端点
• 前端：新增组件/路由
• 插件：新增技能/Hook

§4 封装方法索引更新（如有新增封装方法）

• 记录新增的 Service 方法、工具类、DTO 等

4. 跨项目经验提炼（§6）

判断本次任务是否有可跨项目复用的经验：

发现依赖版本陷阱？框架配置反模式？跨项目通用解法？技术坑？性能优化模式？
  ├─ 任一 → 委派 subagent 搜索 knowledge-base/通用编码经验.md
  │         ├─ 已有相关条目 → 合并追加
  │         └─ 无相关条目 → 新增条目（按 L2 格式：✅推荐 + ❌避免 + 代码对比）
  └─ 都没有 → roadmap §6 记录"本次无 L2 回写"

L2 回写用 subagent 委派（通用编码经验.md 可能数万行，节省主上下文）：

你是 closing-the-loop 回写子代理。请完成知识库经验提炼：

本次任务摘要：
- 做了什么：[描述]
- 涉及文件：[列表]
- 踩到的坑：[描述，如无写"无"]
- 跨项目经验：[描述，如无写"无"]

你的工作：
1. 读取 knowledge-base/通用编码经验.md
2. 判断本次经验是否已有相关条目
   - 已有 → 合并追加
   - 无 → 按 L2 格式新增
3. 更新 knowledge-base/{项目名}/{项目名}-roadmap.md §6（经验提炼）
4. 回报：修改了哪些文件 + 修改内容摘要

5. 分支收尾

所有任务完成后：

→ 展示选项：
  ├─ 合并到 main/master（直接合并或 PR）
  ├─ 保留分支（仍有后续工作）
  └─ 丢弃分支（实验性工作）
→ 清理 git worktree（如有使用）
→ 删除已合并的本地分支

---

Closing the Loop（mini）

配置变更、hotfix 等不产生新功能的任务，走精简版：

钢印项	完整版	mini 版
1. 实现完整性确认	✅	✅
2. Git commit（本地）	✅	✅
3. Roadmap 追加	✅	✅（仅 §5 一行）
4. L2 经验提炼	✅	❌（除非有新技术知识）
5. 分支收尾	✅	❌

---

Subagent 委派建议

操作	执行者	原因
Roadmap §5 实现记录追加	主代理	需要全局视角
Roadmap §2/§3/§4 更新	主代理	需要架构判断
L2 通用编码经验搜索+更新	Subagent	文件可能数万行
Git commit	Subagent	纯机械操作
分支合并/清理	Subagent	纯机械操作

---

Red Flags — 你在跳过闭环

你的想法	真相
"这次改动太小了，不值得记"	最宝贵的经验来自小改动。不记 = 下次还会踩。
"太累了，下次再回写"	现在不写 = 下次冷启动。现在的 2 分钟换下次的 20 分钟。
"roadmap 等有空再更新"	roadmap 是任务的最后一步。不更新 = 任务没完成。
"这个经验只对这个项目有用"	先判断再下结论。很多"项目专属"经验其实是跨项目通用的。
"分支不用收尾，留着就行"	未清理的分支会堆积。每次闭环检查一次。

---

完成标准

• 1. 所有子功能完成 + 审查通过 + 测试通过（对照 writing-plans）
• 2. 代码已 git commit（本地）
• 3. Roadmap §2/§3/§4/§5 已更新
• 4. L2 经验提炼已完成（有则回写，无则记录"本次无"）
• 5. Roadmap §6 已更新
• 6. 分支收尾选项已展示