planning-with-files

planning-with-files 技能為管理複雜、多步驟的任務提供了穩健的架構框架，透過將檔案系統視為外部的持久化工作記憶。該系統專為 AI 代理設計，透過在專案專用的 Markdown 檔案中維護狀態，解決了「中間遺失」現象，代理會定期讀取這些檔案以將目標保持在當前的注意力窗口內。此技能非常適合需要高結構化輸出及跨長期會話進行可驗證進度追蹤的開發人員、研究人員與專案經理。

• 啟用 3-file 模式 (task_plan.md, notes.md, 以及 deliverable.md) 來隔離關注點並有效管理記憶體使用。

• 強制執行基於階段的作業，確保目標、研究發現與最終產出在邏輯上具備可追溯的步驟。

• 包含任務規劃、研究筆記與狀態報告的標準化模板，減少認知負擔與上下文切換。

• 維護「遇到的錯誤」專區以記錄失敗軌跡與解決路徑，促進迭代學習與除錯能力。

• 在每個重要階段或操作後，推動對文件進行原子化、隨時可提交的更新，確保專案狀態始終與檔案系統同步。

• 使用者應在執行超過三個步驟或需要多工具協調的任務時啟用此技能，例如架構研究、複雜的程式碼重構或多階段軟體開發。

• 預期的輸入包括任務定義、研究查詢或功能需求；預期的輸出為結構化的 Markdown 檔案，作為專案的真理來源。

• 實際限制：使用者應避免將此技能用於簡單或單一操作的查詢，以免建立檔案的成本變得不必要。此技能依賴於「先讀後做」規則的嚴格執行，以確保代理在整個任務生命週期中保持目標的一致性。使用此方式可防止上下文堆疊，並確保大型研究發現能組織在外部筆記中，而非短暫的記憶緩衝區內。