文件化任务规划

技能简介

该技能通过创建和维护三个核心Markdown文件，将任务规划、研究发现和进度记录持久化到磁盘，突破上下文窗口限制，支持复杂多步骤任务的长期执行与自动会话恢复。

业务背景

复杂任务执行过程中，系统自动将规划、发现和进度写入本地Markdown文件，突破单次对话的上下文限制。即使会话被意外清空，也能从磁盘恢复完整工作记忆，确保多步骤调研、方案设计等长周期任务不中断、可追溯。

落地案例：产品经理启动竞品分析任务后，系统在项目目录生成三份文档：task_plan.md列明调研维度与截止日期，findings.md自动汇总每次搜索的关键结论，progress.md记录已完成阶段。三天后因误操作执行了清屏，运行恢复脚本即可续接上次进度，无需重复检索已确认的信息。

能做什么

• 自动生成task_plan.md、findings.md、progress.md三类规划文件
• 在每次工具调用前后自动检查并更新规划状态
• 检测/clear后的会话中断，自动恢复未同步的上下文
• 强制实施”先规划后执行”的工作流
• 记录所有错误避免重复失败

使用说明

1. 安装：将技能文件克隆至${CLAUDE_PLUGIN_ROOT}目录，确保scripts文件夹包含session-catchup.py等脚本
2. 初始化项目：进入目标项目目录，从templates复制三个模板文件到项目根目录
3. 会话恢复：若之前执行过/clear，运行对应系统的session-catchup.py脚本检查未同步变更
4. 开始任务：填写task_plan.md的任务阶段，执行过程中每2次搜索/浏览操作后立即保存关键发现至findings.md
5. 持续更新：每个阶段完成后更新进度状态，所有错误必须记入plan文件

输入与输出

见下方输入与输出表格。

风险提示

• 规划文件必须放在项目目录而非技能安装目录，位置错误会导致功能失效
• Windows环境需预装PowerShell或Python以执行恢复脚本
• 未执行会话恢复直接继续任务可能丢失前期上下文
• Hooks依赖Bash/Glob/Grep等工具权限，受限环境可能无法触发自动检查

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/othmanadi/planning-with-files/SKILL.md
来源类型：GitHub仓库