planning-with-files：一個持久化的檔案式規劃技能，可防止 AI 程式編寫代理人在上下文清除時失去對複雜任務的追蹤

它解決了什麼問題

AI 程式編寫代理人常因上下文遺失、當機或記憶被清除（例如使用 /clear 時）而失去對複雜、多步驟任務的追蹤。此專案提供一套持久化、基於檔案的規劃系統，讓代理人能在不同會話之間維持其狀態與進度。

工作原理

此系統實作一個「skill」，強制代理人在磁碟上維持三個特定的 Markdown 檔案：task_plan.md、findings.md、progress.md。透過將計畫與進度存放於對話歷史之外，代理人在當機或上下文被清除後仍能恢復其狀態。它透過 SKILL.md 標準與超過 60 個代理人整合，並使用生命週期掛鉤在關鍵時刻將當前計畫注入回代理人的上下文。

目標對象

使用 AI 程式編寫代理人（如 Claude Code、Codex、Pi 或 Copilot）的開發者，且正在執行需要結構化規劃與持久性的長時間、複雜軟體工程任務。

重點特色

• 上下文存活：防止在當機或手動清除上下文時失去進度。
• 廣泛相容性：透過 SKILL.md 標準可安裝於 60+ 代理人。
• 自主與門檻模式：提供可選的完成門檻，防止代理人在計畫真正完成前停止執行。
• 防篡改保護：使用 SHA-256 雜湊驗證鎖定計畫，若檔案被篡改則阻止注入。
• 會話恢復：內建 session-catchup 指令，可快速恢復上下文。

---

摘要： 一個持久化的檔案式規劃技能，供 AI 程式編寫代理人使用，透過 Markdown 檔案防止上下文遺失，並在多個會話中追蹤進度。

標題： planning-with-files：一個持久化的檔案式規劃技能，可防止 AI 程式編寫代理人在上下文清除時失去對複雜任務的追蹤