工作計畫技能
工作計畫是帶有時間戳記的 markdown 檔案，能在自動壓縮後存活。它們是你處理多步驟工作的外部大腦。
檔案慣例
- 位置： 專案根目錄，已加入 gitignore
- 名稱：
WORKPLAN-YYYYMMDD-slug.md（例如WORKPLAN-20260228-auth-refactor.md） - 每個任務/階段一個檔案。 不要重複使用舊的工作計畫。每個不同的工作都請從頭開始。
操作
建立（/workplan 或 /workplan create）
-
先閱讀。 在撰寫計畫之前，請先閱讀所有相關檔案、問題、上下文。
-
確保
.gitignore包含WORKPLAN-*.md（若缺少則加入）。 -
在撰寫計畫前，選擇一個範圍模式：
- 擴張：「10 星版本是什麼？」大膽夢想，擴大範圍。
- 收緊：「讓這個無懈可擊。」範圍正確，最大化嚴謹度。
- 縮減：「能交付價值的最小範圍是什麼？」果斷刪減。
預設值：全新功能 = 擴張，錯誤修復/上線準備 = 收緊，時間有限 = 縮減。
-
使用以下模板建立檔案：
# 工作計畫：[標題]
建立日期：YYYY-MM-DD HH:MM
最後更新：YYYY-MM-DD HH:MM
狀態：進行中
模式：收緊 / 擴張 / 縮減
## 情境
[這項工作存在的原因。問題。根本原因。關鍵限制。問題/PR 的連結。]
## 路線圖
- [ ] 1. 步驟說明
- [ ] 2. 步驟說明
- [ ] 3. 步驟說明
## 決策
[記錄架構或方法決策，附上時間戳]
- [HH:MM] 因為 Z 選擇了 X 而不是 Y
## 發現的問題
[過程中所發現、原範圍未包含的事項]
- [HH:MM] 在處理步驟 2 時發現……
## 驗證記錄
[每個完成的項目都應有驗證條目]
- [HH:MM] 步驟 1：已驗證 - 執行 `npm test`，所有 42 個測試通過
- [HH:MM] 步驟 3：已驗證 - 手動測試登入流程，OAuth 和電子郵件皆正常運作
更新（/workplan update）
- 讀取專案根目錄中活躍的
WORKPLAN-*.md檔案。 - 更新「最後更新」時間戳。
- 勾選已完成的項目，並附上驗證時間戳。
- 加入任何新的發現或決策。
- 向使用者報告目前狀態。
關閉（/workplan close）
- 讀取活躍的工作計畫。
- 驗證所有項目都已勾選並附上驗證時間戳。
- 執行最終驗證（建置、測試、手動檢查）。
- 將狀態變更為「已完成」。
- 加入最終摘要：
## 已完成
關閉日期：YYYY-MM-DD HH:MM
所有 N 個項目已實作並驗證。建置通過。測試通過。
恢復（壓縮後）
當上下文已被壓縮，或你不確定進行到哪一步時：
- 尋找活躍的工作計畫：在專案根目錄中尋找
WORKPLAN-*.md。 - 讀取工作計畫檔案。
- 找出第一個未勾選的項目。
- 從那裡繼續。
規則
- 已驗證意味著經過測試。 不是「我認為它有效」。請實際執行、看到它通過，然後才標記為已驗證。包含你執行過的內容和結果。
- 每次變更都更新時間戳。 未來的你（在壓縮之後）依賴於此。
- 新的發現要立即記錄。 不要只保留在上下文中。
- 在使用者確認工作完成之前，絕不刪除計畫。
- 每個檢查清單項目只關注一個事項。 將大步驟分解成較小、可驗證的片段。
- 如果某個步驟未通過驗證， 請記錄失敗，保持未勾選狀態，並加入出錯的原因。