planning-with-files
基于文件的持久化规划技能，让AI编码代理在断线、崩溃后能恢复工作。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：planning-with-files。 它的用途是：基于文件的持久化规划技能，让AI编码代理在断线、崩溃后能恢复工作。 完整的 Skill 内容见：https://321skill.com/skills/planning-with-files/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我分析这个项目的代码结构，并制定一个重构计划。” 它会自动创建 `task_plan.md` 文件来记录分析步骤和重构策略，并在 `progress.md` 中跟踪执行进度。即使中途关闭了对话窗口，重新打开后，AI也能读取这些文件，从上次中断的地方继续工作。
介绍
这是一个专为AI编码代理设计的持久化规划技能。它解决了AI代理在长周期任务中因上下文丢失、对话被清空或意外崩溃而导致工作进度中断的核心痛点。通过将规划、发现和进度以文件形式（task_plan.md, findings.md, progress.md）保存在磁盘上，代理可以随时从上次中断的地方恢复工作，极大提升了任务执行的可靠性和连续性。
使用方式非常简单。在支持的AI代理（如Cursor、Claude Desktop等）中安装此技能后，代理在接到复杂任务时会自动创建并维护这些规划文件。用户可以通过查看这些文件来了解代理的工作思路和当前进展。技能还提供了可选的“完成门控”模式，确保代理只有在真正完成计划后才停止，避免了过早结束任务的问题。
它非常适合需要AI代理处理耗时较长、步骤复杂的开发任务的用户，例如重构大型代码库、进行系统性的代码审计、或从零开始构建一个完整的项目模块。对于依赖AI代理进行深度协作的开发者来说，这是一个提升工作效率和可控性的关键工具。
与同类规划工具相比，其核心优势在于“基于文件的持久化”。许多代理的规划功能依赖于易失的对话上下文或内存，而本技能将规划实体化为磁盘文件，不仅抗干扰能力强，还允许用户手动查看和干预，实现了人机协作的透明化。
核心特点
核心区别在于将规划过程持久化到磁盘文件，而非仅存在于易失的对话上下文中。这使得AI代理能够抵御上下文丢失、对话重置和程序崩溃，并能通过文件实现人机协作的透明化与可干预性。
注意事项
不适合处理极其简单、无需规划的即时性任务，可能会增加不必要的开销。
常见问题
planning-with-files 和普通让AI写计划有什么区别？
普通计划在对话清空后就丢失了。本技能将计划写入磁盘文件，即使AI重启或对话重置，也能读取文件恢复工作状态。
安装后AI代理会自动使用这个技能吗？
是的，在支持的AI代理中安装后，当遇到复杂任务时，代理通常会主动调用此技能来创建和维护规划文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/planning-with-files/raw/index.md 读取 planning-with-files 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/planning-with-files/raw/index.md（查看排版版本）