Planning with Files 持久化任务规划
把任务计划、研究结论和进度写进文件，让 Agent 在长任务、清空上下文或中断后继续工作。
技能说明
适合多步骤开发、研究和长期任务。通过 task_plan.md、findings.md 和 progress.md 及钩子恢复上下文；安装路线不同，是否包含命令和钩子也不同，建议安装后运行 plan-doctor 检查。
关于此技能
为多步骤开发、研究和长期任务建立可恢复的文件化工作记忆。通过任务计划、研究结论和进度日志，让 Agent 在上下文清空、崩溃或压缩后继续工作。
核心能力
三文件工作记忆
用 task_plan.md、findings.md 和 progress.md 分别记录目标阶段、研究结论和执行进度。
跨会话恢复
通过会话恢复和提示注入，把磁盘上的计划重新带回后续对话。
完成检查和钩子
提供完成门禁、计划诊断、计划校验和多平台钩子，降低长任务漏项风险。
适用场景
复杂开发任务
适合需要多轮工具调用、测试和分阶段交付的软件任务。
研究与自动化项目
适合需要持续记录资料、决定和进度的长期工作。
使用步骤
- 01
第一步：安装
通用 Agent Skills 路线可运行 npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g；Claude Code 可使用插件路线获得完整命令和钩子。
- 02
第二步：启动计划
让 Agent 识别复杂任务并建立 task_plan.md、findings.md 和 progress.md。
- 03
第三步：持续记录
把新发现写入 findings.md，把实际动作和测试写入 progress.md，并更新任务阶段。
- 04
第四步：检查安装
若依赖钩子工作，安装后运行 plan-doctor，确认计划注入和完成检查真的生效。
常见问题
所有安装方式都包含完整功能吗？+
不是。仓库说明插件路线包含命令和钩子，通用 skills 路线主要提供技能文件；项目级安装还可能受信任设置和钩子注册影响。
它会修改项目文件吗？+
会在工作区写入规划文件和日志；仓库说明这些文件默认应按项目需要加入忽略规则，使用前要确认团队是否希望保留它们。
安全吗？+
仓库提供安全策略，重点关注计划文件进入模型上下文、路径穿越、软链接和安装脚本等问题；仍应先审查钩子源码再安装。
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g