Skip to content

初始化代理操作手冊

這個手冊用於倉庫裡的第一輪重要會話,也就是正式開始增量開發之前的初始化階段。

目標

先搭出穩定的工作面,讓後續會話不必重新推導啟動命令、當前狀態和任務邊界。

必需產出

初始化階段至少應該留下這些工件:

  • 一個根指令檔案,例如 AGENTS.mdCLAUDE.md
  • 一個機器可讀的功能面,例如 feature_list.json
  • 一個持久進度工件,例如 claude-progress.md
  • 一個標準啟動輔助腳本,例如 init.sh
  • 一個記錄基礎腳手架狀態的初始安全提交

檢查清單

  1. 定義標準啟動路徑
  2. 定義標準驗證路徑
  3. 建立進度日誌並寫下初始狀態
  4. 把工作拆成功能,並給出狀態字段
  5. 建立第一個乾淨的 baseline commit

成功標準

一個完全沒有前文聊天上下文的新會話,應該能回答:

  • 這個倉庫是做什麼的
  • 怎麼啟動
  • 怎麼驗證
  • 還有什麼沒做完
  • 下一步最佳動作是什麼