Planning with Files：给长任务增加可恢复的文件化计划

一、技能作用

Planning with Files 使用 task_plan.md、findings.md 和 progress.md 作为长任务的持久工作记忆，并在部分客户端提供可选 Hook 与完成门禁。

二、能解决什么

它把阶段、证据、失败和下一步记录在上下文窗口之外，并帮助 Agent 在压缩或新会话后重新读取状态。

三、推荐上手方式

先在多步骤任务中手动尝试三文件模式，再决定是否启用 Hook；安装插件后运行文档中的 doctor 检查，并确认文件写入位置。

四、环境与前置条件

普通 Skill 可用于多种兼容 Agent，但插件 Hook 与命令存在差异；它需要在任务目录创建和更新 Markdown 文件。

五、适合谁

适合调查、迁移、重构，以及需要大量工具调用或跨会话完成的任务。

六、局限与安全边界

小任务使用三文件会增加噪音，过期记录还可能误导后续会话；项目正式文档仍应作为事实来源。 不要在计划文件里保存密钥或原始凭据；允许访问 Agent 会话存储前检查恢复行为，并按项目需要避免把临时记录提交到 Git。

七、项目与许可

仓库内容按 MIT 提供，具体以项目当前 LICENSE 为准。项目地址：https://github.com/OthmanAdi/planning-with-files

把目标拆成输入、动作和输出，再逐步加入检查点。

保留示例、失败条件和复核标准，教程才真正可复用。