方法對照表
這個表把最常見的長時 coding-agent 失敗模式,對應到最先該補的工件或規則。
| 失敗模式 | 實際表現 | 首要修復 | 主要工件 |
|---|---|---|---|
| 冷啟動混亂 | 新會話花大量時間重新摸索狀態和啟動方式 | 讓倉庫成為唯一事實來源 | claude-progress.md |
| 範圍蔓延 | 一次啟動多個功能,最後沒有一個完整收尾 | 限制當前活躍範圍 | feature_list.json |
| 提前宣佈完成 | 代碼改了就說“完成了”,但沒有可運行證據 | 把完成綁定到驗證證據 | clean-state-checklist.md |
| 啟動脆弱 | 每輪會話都要重新學怎麼啟動項目 | 統一啟動與驗證路徑 | init.sh |
| 交接薄弱 | 下一輪看不出哪裡可用、哪裡壞了、接下來做什麼 | 明確寫交接摘要 | session-handoff.md |
| 評審主觀 | 質量判斷依賴個人記憶和感覺 | 用固定維度做評分 | evaluator-rubric.md |
使用原則
優先補最能直接消除當前失敗模式的那個工件,不要一出問題就把更多規則堆進一個超長 instruction 檔案裡。