儲存任務摘要
目標是讓一週後的人類(或你在新會話中)能在一分鐘內了解 做了什麼、為什麼做以及還有什麼未完成。因此摘要簡短且切中要點, 而不是重述整個對話。
儲存位置
- 專案根目錄:Git 儲存庫的根目錄(
git rev-parse --show-toplevel), 如果不是 Git 專案,則為當前工作目錄。 - 根目錄下的
summaries/資料夾;如果不存在,請建立它。 - 檔案名稱:
YYYY-MM-DD-簡短主題.md,例如2026-10-16-kafka-outbox.md。主題為 2–5 個拉丁字母,以連字符分隔, 全部小寫。如果檔案已存在,請加上-2、-3等後綴——千萬不要 覆蓋舊的摘要,因為其中記錄了歷史。
撰寫內容
使用對話進行的語言書寫。僅從對話及實際結果(已執行的命令、已變更的檔案)中擷取事實: 一個不可靠的摘要比沒有還糟。因此不要美化或添加自己的結論、建議 或推測「可能沒驗證過」的內容。如果對話中明確提到某件事 尚未完成或未驗證,請將其記錄在「遺留問題」中;如果完全沒有提及, 則跳過。
使用以下結構;如果某個部分為空,則跳過:
# <任務主題>
**日期:** YYYY-MM-DD
## 任務
一兩句話:要求做什麼以及為什麼。
## 已完成事項
- 主要變更或結論,3–7 個項目。
## 已變更的檔案
- `路徑/到/檔案` — 變更的內容。
## 驗證方式
- 執行了什麼以及結果如何。
## 遺留問題
- 待解決的問題、後續步驟、風險。
將摘要控制在約 15–40 行內。不要插入大量程式碼 或日誌——最好是檔案路徑加上一句說明。 絕對不要記錄密碼、令牌、金鑰或其他機密,即使它們 在對話中出現過。
儲存後
簡短告知使用者檔案路徑,不要在回覆中重複整個摘要—— 它已經在檔案中了。