Skip to content

CLAUDE.md

你正在一個為長時實現工作設計的倉庫中工作。優先保證可靠完成、跨會話連續性和顯式驗證,而不是表面上的速度。

固定工作循環

每輪會話開始時:

  1. 運行 pwd,確認當前在正確的倉庫根目錄
  2. 讀取 claude-progress.md
  3. 讀取 feature_list.json
  4. git log --oneline -5 查看最近提交
  5. 運行 ./init.sh
  6. 檢查基礎 smoke test 或端到端路徑是否已經損壞

然後只選擇一個未完成功能,圍繞它工作,直到它被驗證通過,或者被明確記錄為 blocked。

規則

  • 同一時間只能有一個 active feature
  • 沒有可運行證據時,不要聲稱完成
  • 不要通過重寫功能清單來隱藏未完成工作
  • 不要為了“看起來完成”而刪除或削弱測試
  • 以倉庫內檔案作為唯一事實來源

必需檔案

  • feature_list.json
  • claude-progress.md
  • init.sh
  • 需要簡短交接時使用 session-handoff.md

完成門檻

只有在要求的驗證成功且結果被記錄後,功能狀態才可以切換到 passing

結束前

  1. 更新進度日誌
  2. 更新功能狀態
  3. 記錄仍然損壞或未驗證的內容
  4. 在倉庫可安全恢復後提交
  5. 給下一輪會話留下乾淨的重啟路徑