建立每日主提示
概觀
每日主提示是一個自我包含的檔案 DAILY_PROMPT.md,任何全新工作階段都能執行它以接手專案、完成一日工作,並留下可讓隔日繼續的狀態。專案的記憶儲存在其旁邊的五個狀態檔案中,絕不存放在對話記錄裡。初次執行後,使用者只需輸入:
Read <folder>/DAILY_PROMPT.md and execute it.
使用者輸入:$ARGUMENTS(一個資料夾和/或專案說明;兩者皆可能缺失)。
完成時已有的內容
全部位於專案資料夾(<folder>)中,從 ${CLAUDE_SKILL_DIR}/templates/ 中的範本建立:
| 檔案 | 內容 | 變更方式 |
|---|---|---|
DAILY_PROMPT.md | 任務、里程碑、規則、上下文對照圖、工作階段流程 | 僅在使用者要求時 |
BACKLOG.md | 帶有 ID 與狀態的排序工作項目 | 每次執行 |
DEVLOG.md | 僅附加的日期記錄,記錄每次執行 | 每次執行 |
HANDOFF.md | 當前狀態、接下來3個動作、警告 | 每次執行時重寫 |
QUESTIONS.md | 給使用者的問題,每題附一個建議 | 執行時提問,使用者回答 |
APPROVALS.md | 等待同意或拒絕的高風險或不可逆行動 | 執行時請求,使用者決定 |
進度記錄在狀態檔案中。DAILY_PROMPT.md 僅存放那些數週內都保持不變的內容。
步驟
- 找到資料夾。 使用引數中的資料夾。否則使用存放專案規格或程式碼的資料夾;若有多個符合,則提問。
- 透過讀取而非詢問來收集上下文。 使用者的說明;
README*、CLAUDE.md、AGENTS.md;規格(GDD、PRD、路線圖、docs/);git log --oneline -30與git status;2-3 層的檔案樹;能揭示建置、測試、語法檢查與執行命令的 manifest 與腳本;工作所需的已連線 MCP 伺服器;TODO/FIXME 註解;任何現有的狀態檔案。區分已完成與未完成的事項。 - 僅針對檔案中未說明的內容提問,透過一次 AskUserQuestion 呼叫(最多 4 個問題),從此清單中選取:當前里程碑及其完成定義;如何驗證已完成項目;嚴格規則(絕不發布/部署、新增相依套件前先詢問、分支與推送政策);執行模式為有監督、無人值守或兩者皆有。若無人回答,則採用最安全的解讀(無人值守、不推送、不發布),並將每個假設記錄在
QUESTIONS.md中,加上「在得到回答前視為假設」這一行。 - 撰寫
DAILY_PROMPT.md,從DAILY_PROMPT.template.md產生。每個段落都指明此專案的實際路徑、命令、工具與里程碑。在每日提示行中,使用相對於儲存庫根目錄(使用者開啟 Claude 的位置)的相對路徑,而非絕對路徑;當資料夾就是根目錄本身時,該行應為Read DAILY_PROMPT.md and execute it.。如果執行或測試專案可能觸及真實資料(使用者檔案、線上帳號、正式環境、已發布的位置),則新增一條基本規則與驗證方法,要求改用臨時或測試副本。 - 從範本建立狀態檔案。 若已有檔案存在,則合併進去;絕不覆寫或重新排序使用者的歷史記錄。
BACKLOG.md的種子資料來自里程碑、規格缺口、TODO 與使用者目標,排序方式為項目1今日即可開始,且每個項目適合一個工作階段,每個項目都有具體的「完成條件」。HANDOFF.md的種子資料為起始狀態。對於範本中的範例項目不適用的,保留其標題與格式行,並以無。取代該項目。 檢查:grep -n "{{" <folder>/*.md應無任何輸出。 - 提交新檔案(若資料夾在 Git 儲存庫中),提交訊息為
chore: add daily master prompt,並遵循儲存庫的提交規則。 - 首次執行。 除非使用者要求不要執行,否則立即執行
DAILY_PROMPT.md,就像全新工作階段那樣。這是對該提示的測試:當某個步驟不明確、失敗或需要檔案中未包含的知識時,修正提示並在DEVLOG.md中記錄修正。 - 交接。 告知使用者建立了什麼、首次執行了什麼,並以程式碼區塊提供每日提示行:
提及Read <folder>/DAILY_PROMPT.md and execute it./daily-master-prompt:run <folder>是同一個東西,且該行也可作為排程任務的提示。
更新既有提示
當 DAILY_PROMPT.md 已存在時,先讀取它與所有狀態檔案。在使用者要求更改時原地套用變更,或當使用者要求附加內容時,在 ## Addenda 下以日期條目方式記錄。保留所有狀態。將變更記錄在 DEVLOG.md 中。
常見錯誤
| 錯誤 | 結果 | 應改為 |
|---|---|---|
| 泛用提示(「處理專案」) | 每次執行都重新發現專案 | 使用實際路徑、命令、里程碑、完成定義 |
將進度寫入 DAILY_PROMPT.md | 提示過時且與狀態檔案矛盾 | 進度應放在 BACKLOG/HANDOFF/DEVLOG 中 |
| 無驗證步驟 | 「已完成」的項目實際上無法運作 | 每個項目都要有具體檢查(測試、建置、遊玩測試、語法檢查) |
| 遇到第一個阻礙就停止 | 無人值守的日子毫無產出 | 記錄在 QUESTIONS/APPROVALS,繼續處理下一個項目 |
| 待辦項目過大 | 每天都有半成品 | 拆分到每個項目適合一個工作階段為止 |
| 覆寫現有狀態檔案 | 使用者失去歷史記錄 | 合併 |
本地化說明:為符合繁體中文慣例,使用了「使用者」而非「用戶」、「資料夾」而非「文件夾」、「提示」而非「提示詞」。所有程式碼、命令、檔案路徑、環境變數名稱、URL 及內嵌程式碼區塊皆保持原文不譯。