planning-with-files：一种持久化的基于文件的规划技能，可防止 AI 编码代理在上下文清除时失去对复杂任务的跟踪

它解决了什么问题

AI 编码代理经常遭遇上下文丢失、崩溃或内存清除（例如使用 /clear 时），导致它们失去对复杂、多步骤任务的跟踪。该项目提供了一套持久化、基于文件的规划系统，使代理能够在会话之间保持状态和进度。

工作原理

系统实现了一个“技能”，强制代理在磁盘上维护三个特定的 Markdown 文件：task_plan.md、findings.md 和 progress.md。通过将计划和进度保存在对话历史之外，代理可以在崩溃或上下文清除后恢复其状态。它通过 SKILL.md 标准与 60 多个代理集成，并使用生命周期钩子在关键时刻将当前计划注入代理的上下文中。

适用人群

使用 AI 编码代理（如 Claude Code、Codex、Pi 或 Copilot）的开发者，正在处理需要结构化规划和持久化的长期、复杂软件工程任务。

亮点

• 上下文存活：防止在崩溃或手动上下文清除时丢失进度。
• 广泛兼容：通过 SKILL.md 标准可在 60+ 代理上安装。
• 自主与受限模式：包含可选的完成门控，防止代理在计划实际完成前停止。
• 防篡改保护：使用 SHA-256 哈希证明锁定计划，并在文件被篡改时阻止注入。
• 会话恢复：提供会话追赶命令，可快速恢复上下文。

摘要

一种持久化的基于文件的规划技能，适用于 AI 编码代理，利用 Markdown 文件防止上下文丢失并在会话之间跟踪进度。

标题

planning-with-files：一种持久化的基于文件的规划技能，可防止 AI 编码代理在上下文清除时失去对复杂任务的跟踪