用途:为多步骤、跨多次工具调用的 AI 智能体任务提供基于文件的持久化规划,把上下文窗口视为易失的 RAM、把文件系统视为持久的磁盘,重要信息写入磁盘。
主要能力:维护 task_plan.md(阶段、进度、决策与 Next Step)、findings.md(研究与发现)、progress.md(会话日志与测试结果);遵循“先建计划”“每两次查看/浏览/搜索操作后立即保存发现”“决策前先读计划”“阶段完成后更新状态并记录错误”等规则;提供 3-Strike 错误协议(诊断修复、换方法、重新思考,三次失败后升级给用户)。
使用方式:安装后复制 templates 下的三个模板到所选任务目录;复杂任务前用 scripts/init-session.sh "Task Name" 初始化并取得 PLAN_ID,用 scripts/set-active-plan.sh 切换活动计划,用 scripts/resolve-plan-dir.sh 解析计划目录,用 scripts/check-complete.sh 检查阶段是否完成;并行任务需为每个宿主固定 PLAN_ID 或使用独立 worktree,可用 PWF_PLAN_ROOT 指定绝对根路径;scripts/attest-plan.sh 用 SHA-256 锁定 task_plan.md,scripts/plan-doctor.sh 做自检;Claude Code 中可配合 /plan-goal、/plan-loop 与 PreCompact 钩子使用。
适用场景:3 步以上的多步骤任务、研究任务、构建项目、跨大量工具调用的任务;简单问答、单文件编辑、快速查询不建议使用。
限制:会话恢复不读取智能体会话存储,仅在用户明确要求时用 session-catchup.py 的 --metadata 或 --replay 模式;replay 内容视为不可信数据;该技能无网络上传路径;计划文件位于所选任务目录,安装目录仅存脚本与模板。部分安装路线(仅 skill 安装)不包含 commands/,斜杠命令可能不可用,需按手动回退步骤执行。