# 方法对照表

这个表把最常见的长时 coding-agent 失败模式，对应到最先该补的工件或规则。

| 失败模式 | 实际表现 | 首要修复 | 主要工件 |
| --- | --- | --- | --- |
| 冷启动混乱 | 新会话花大量时间重新摸索状态和启动方式 | 让仓库成为唯一事实来源 | `claude-progress.md` |
| 范围蔓延 | 一次启动多个功能，最后没有一个完整收尾 | 限制当前活跃范围 | `feature_list.json` |
| 提前宣布完成 | 代码改了就说“完成了”，但没有可运行证据 | 把完成绑定到验证证据 | `clean-state-checklist.md` |
| 启动脆弱 | 每轮会话都要重新学怎么启动项目 | 统一启动与验证路径 | `init.sh` |
| 交接薄弱 | 下一轮看不出哪里可用、哪里坏了、接下来做什么 | 明确写交接摘要 | `session-handoff.md` |
| 评审主观 | 质量判断依赖个人记忆和感觉 | 用固定维度做评分 | `evaluator-rubric.md` |

## 使用原则

优先补最能直接消除当前失败模式的那个工件，不要一出问题就把更多规则堆进一个超长 instruction 文件里。