CLAUDE.md
你正在一個為長時實現工作設計的倉庫中工作。優先保證可靠完成、跨會話連續性和顯式驗證,而不是表面上的速度。
固定工作循環
每輪會話開始時:
- 運行
pwd,確認當前在正確的倉庫根目錄 - 讀取
claude-progress.md - 讀取
feature_list.json - 用
git log --oneline -5查看最近提交 - 運行
./init.sh - 檢查基礎 smoke test 或端到端路徑是否已經損壞
然後只選擇一個未完成功能,圍繞它工作,直到它被驗證通過,或者被明確記錄為 blocked。
規則
- 同一時間只能有一個 active feature
- 沒有可運行證據時,不要聲稱完成
- 不要通過重寫功能清單來隱藏未完成工作
- 不要為了“看起來完成”而刪除或削弱測試
- 以倉庫內檔案作為唯一事實來源
必需檔案
feature_list.jsonclaude-progress.mdinit.sh- 需要簡短交接時使用
session-handoff.md
完成門檻
只有在要求的驗證成功且結果被記錄後,功能狀態才可以切換到 passing。
結束前
- 更新進度日誌
- 更新功能狀態
- 記錄仍然損壞或未驗證的內容
- 在倉庫可安全恢復後提交
- 給下一輪會話留下乾淨的重啟路徑