add-todo

add-todo 技能為 AI 驅動的開發環境提供了一種結構化的方式來記錄任務、錯誤與功能請求。透過在 TODOS.md 檔案中強制執行一致的語法，它使 /list-todos 和 /run-todos 等輔助技能能夠可靠地解析、排列優先順序並執行工作項目。此技能專為在 AI Coding Project Toolkit 框架內運作的軟體開發人員與 AI 代理所設計，確保專案狀態得到維護並具備可執行性。

• 自動檢查 TODOS.md 是否存在，若無則使用標準模板初始化。

• 引導使用者透過多步驟互動流程定義標題、優先順序 (P0-P2)、工作量 (低至高) 以及選填的詳細說明。

• 支援特定章節插入，允許使用者將任務分類至「進行中 (In Progress)」或「未來概念 (Future Concepts)」章節。

• 驗證輸入內容以確保語言具備操作性且格式專業，並在需求不明確時預設為安全值。

• 與專案的廣泛工作流程整合，提供排列優先順序與實作的明確後續步驟。

• 為獲得最佳效果，使用前請確認根目錄中存在 TODOS.md。

• 使用以動詞開頭（如 Add, Fix, Update）的描述性、行動導向標題。

• 嚴格遵循提示，以維持與自動化規劃指令稿的相容性。

• 此技能有助於追蹤高階專案目標與技術債，作為高階規格與底層程式碼執行之間的橋樑。

• 非常適合在主動開發期間使用，可防止在處理主要專案分支時遺漏錯誤修復或反覆運算改進。

• 內建錯誤處理機制可管理檔案權限與大型檔案情境，若 TODOS.md 超過標準操作大小，會建議執行歸檔練習。