file-todos

file-todos 技能提供了一種穩健、透明且持久的方法來管理工作項目、功能需求和技術債。透過利用 .claude/todos/ 目錄，該系統將帶有 YAML 前置資料的 Markdown 檔案轉換為可查詢的專案狀態資料庫。它專為在優先考慮程式碼文件化和可審計性的環境中工作的開發人員和代理程式而設計。此技能允許系統性地擷取來自調查、程式碼審查和 PR 回饋的發現，確保在開發週期中不會遺失複雜任務。

• 支援使用問題 ID、狀態追蹤和優先級別建立標準化待辦事項檔案，以進行有效的分類。

• 支援問題之間的相依性管理，確保任務按正確的邏輯順序完成。

• 在主動開發期間促進詳細的工作日誌記錄，提供行動、學習成果和技術調整的時間順序記錄。

• 與 /triage 等自動化斜線指令整合，以實現快速審批和優先順序排序工作流程。

• 使用 Markdown 和 YAML 進行儲存，使其完全納入版本控制，可透過 grep 等標準工具進行搜尋，且易於移植。

• 當任務需要超過 15-20 分鐘的精力、研究或多步驟規劃時，請使用此技能。

• 若要建立新的待辦事項，請複製 assets/todo-template.md 並填寫必要章節，包括問題陳述、擬議解決方案和驗收標準。

• 請務必確保狀態欄位（pending, ready, complete）和相依性列表準確無誤，以便進行自動化篩選和管線整合。

• 依賴工作日誌來記錄檔案層級的變更、執行的指令和關鍵技術見解，為未來的程式碼審查或偵錯會話提供背景資訊。

• 對於 15 分鐘以下的瑣碎任務，建議採取標準化的立即行動，而非建立正式的追蹤檔案。