初始化代理操作手冊
這個手冊用於倉庫裡的第一輪重要會話,也就是正式開始增量開發之前的初始化階段。
目標
先搭出穩定的工作面,讓後續會話不必重新推導啟動命令、當前狀態和任務邊界。
必需產出
初始化階段至少應該留下這些工件:
- 一個根指令檔案,例如
AGENTS.md或CLAUDE.md - 一個機器可讀的功能面,例如
feature_list.json - 一個持久進度工件,例如
claude-progress.md - 一個標準啟動輔助腳本,例如
init.sh - 一個記錄基礎腳手架狀態的初始安全提交
檢查清單
- 定義標準啟動路徑
- 定義標準驗證路徑
- 建立進度日誌並寫下初始狀態
- 把工作拆成功能,並給出狀態字段
- 建立第一個乾淨的 baseline commit
成功標準
一個完全沒有前文聊天上下文的新會話,應該能回答:
- 這個倉庫是做什麼的
- 怎麼啟動
- 怎麼驗證
- 還有什麼沒做完
- 下一步最佳動作是什麼