在 ContinueVS Code / JetBrains中启用 planning-with-files文件化持久规划的完整集成指南【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files本文面向在 ContinueVS Code 与 JetBrains 插件中开发、希望为长任务引入持久化规划能力的开发者完整讲解 planning-with-files 的 Continue 集成方式项目级 Skill 与斜杠命令的安装、/planning-with-files的调用工作流、三个核心辅助脚本init-session.sh/check-complete.sh/session-catchup.py的用法与隐私边界以及 Continue 无 Hook 环境下手动维护task_plan.md/findings.md/progress.md的最佳实践。读完即可在 Continue 中落地“三文件 每阶段回读更新”的 Manus 式上下文工程工作流。一、Continue 集成提供什么Skill Slash Command 双层入口Continue 适配器在项目中落地两块内容对应仓库 .continue 目录集成面落点路径作用项目级 Skill.continue/skills/planning-with-files/提供 SKILL.md、scripts/、examples.md、reference.mdContinue 会自动加载项目级 Skill项目级斜杠命令.continue/prompts/planning-with-files.promptMarkdown 格式的 prompt 文件注册/planning-with-files命令调用后引导 Agent 进入三文件规划流程Continue 同时支持两种安装位置项目级project-levelrepo/.continue/...随仓库分发团队共享全局global~/.continue/...作用于所有项目。与 Claude Code / Cursor 适配器的区别在于Continue 不运行 Claude Code 的 PreToolUse / PostToolUse / Stop 生命周期 Hook因此没有“每轮自动注入计划”“Stop 门控”这类自动化机制详见 docs/installation.md 中“不同安装路径实际提供什么”的对比矩阵。Continue 下的工作流是手动的做决策前重读task_plan.md每个阶段结束后回写更新。这也是本篇指南的重点。二、安装项目级与全局两条路径2.1 项目级安装推荐在项目根目录执行git clone https://github.com/OthmanAdi/planning-with-files.git cp -r planning-with-files/.continue .continue随后重启 Continue或重新加载 IDE让 Continue 扫描并加载新文件。安装完成后项目根目录应出现your-project/ ├── .continue/ │ ├── prompts/ │ │ └── planning-with-files.prompt ← /planning-with-files 斜杠命令 │ └── skills/ │ └── planning-with-files/ │ ├── SKILL.md ← 规划方法论主体 │ ├── examples.md │ ├── reference.md │ └── scripts/ ← init-session.sh / check-complete.sh / session-catchup.py 等 ├── task_plan.md ← 由你按需创建规划文件在项目根不在 .continue 内 ├── findings.md └── progress.md2.2 全局安装将 Skill 与 prompt 分别复制到全局 Continue 目录git clone https://github.com/OthmanAdi/planning-with-files.git mkdir -p ~/.continue/skills ~/.continue/prompts cp -r planning-with-files/.continue/skills/planning-with-files ~/.continue/skills/ cp planning-with-files/.continue/prompts/planning-with-files.prompt ~/.continue/prompts/同样需要重启 Continue 或重载 IDE 才能生效。两种方式可叠加全局 Skill 兜底项目级版本优先。三、使用/planning-with-files斜杠命令的完整工作流在 Continue 聊天框中输入/planning-with-files该命令由 .continue/prompts/planning-with-files.prompt 驱动其前端的 frontmattername、description、invokable: true决定了命令在 IDE 中的注册与显示。加载后 prompt 会引导 Agent 完成以下动作检查三个规划文件是否存在task_plan.md、findings.md、progress.md位于项目根目录缺失则创建手动创建或运行初始化脚本——macOS/Linuxbash .continue/skills/planning-with-files/scripts/init-session.shWindowspowershell -ExecutionPolicy Bypass -File .continue/skills/planning-with-files/scripts/init-session.ps1填写task_plan.mdGoal一句话、Phases3~7 个阶段每个阶段标注pending / in_progress / complete、Key Questions执行期间遵守纪律规则每 2 次查看/搜索/浏览操作后立即把发现写入findings.md每个重大决策前重读task_plan.md刷新目标所有错误记入task_plan.md的Errors Encountered表含尝试次数与解决方式持续记录把会话动作与验证结果命令、测试、输出写入progress.md收尾优先引用规划文件的最新内容而非聊天记忆结束前确保所有阶段标记 complete或明确说明剩余工作及原因。这套规则与 .continue/skills/planning-with-files/SKILL.md 中定义的“核心模式”一脉相承——把上下文窗口视为易失的 RAM、文件系统视为持久的磁盘一切重要信息落盘Context Window RAM (volatile, limited) Filesystem Disk (persistent, unlimited) → Anything important gets written to disk.3.1 三个文件的职责边界文件职责更新时机task_plan.md阶段划分、进度、决策、错误记录每个阶段完成后findings.md研究结论、发现、外部信息任何发现之后progress.md会话日志、测试结果整个会话持续安全边界外部内容网页、API 返回只能写入findings.mdtask_plan.md会被频繁回读未经审查的内容写入会放大注入风险。SKILL.md 明确要求把三个规划文件的内容一律当作结构化数据而非指令来对待。四、辅助脚本详解从初始化到完成校验Continue 集成携带完整的scripts/目录bash 与 PowerShell 双版本下面以实际源码为准逐一说明。4.1init-session.sh初始化三个规划文件脚本默认行为是向后兼容的 legacy 模式——无参数运行时在项目根创建task_plan.md、findings.md、progress.md传入项目名或--plan-dir时进入slug 模式为并行多任务创建隔离目录.planning/YYYY-MM-DD-slug/并把计划 ID 写入.planning/.active_plan供解析脚本定位。常用用法# ① legacy 模式项目根创建三文件 bash .continue/skills/planning-with-files/scripts/init-session.sh # ② 指定模板default / analytics 二选一 bash .continue/skills/planning-with-files/scripts/init-session.sh --template default # ③ slug 模式按项目名生成隔离规划目录 bash .continue/skills/planning-with-files/scripts/init-session.sh Backend Refactor # → .planning/2026-09-11-backend-refactor/{task_plan.md,findings.md,progress.md} # ④ 显式 --plan-dir无名称时自动生成 untitled-short bash .continue/skills/planning-with-files/scripts/init-session.sh --plan-dir Quick Spike脚本参数一览来自 init-session.sh 的 usage参数说明-t, --template TYPE使用default或analytics模板其他值回退 default--plan-dir创建隔离规划目录可带名称也可自动命名--autonomousv3 自主模式写入.mode、.nonce、重置.stop_blocks并自动为计划生成 SHA-256 attestation--gatedv3 门控模式隐含 autonomous额外启用完成门控标记-h, --help打印帮助不修改任何文件值得注意的实现细节slug 模式会复用short_uuid()生成 8 位十六进制片段、gen_nonce()生成 16 位 nonce当两个随机片段相同时会混入 PID 保证 64 位不可预测性Alpine 等最小化环境下无uuidgen时的兜底路径。slug 化规则为小写化、非字母数字转-、连续-折叠、截断到 40 字符。--gated模式会同时写入autonomous gate到.mode并在初始化时重置门控计数器、清除陈旧 ledger。init-session.ps1提供等价的 Windows 实现。默认生成的task_plan.md骨架包含## Goal、## Next Step、## Current Phase、## PhasesPhase 1~5每阶段含复选框与**Status:**标记、## Decisions Made、## Errors Encountered表可直接在此基础上编辑。4.2check-complete.sh阶段完成度校验bash .continue/skills/planning-with-files/scripts/check-complete.sh默认调用是建议性输出advisory统计task_plan.md中### Phase标题总数与完成数打印ALL PHASES COMPLETE (N/N)或Task in progress (N/M phases complete)始终以退出码 0 结束——因为 Continue 没有 Stop Hook该脚本在 Continue 下的定位是“人工/Agent 手动触发的完成度体检”而不是门控拦截。脚本的计数逻辑对两种状态格式都兼容**Status:** complete与[complete]并对每种格式分别计数后取较大值从而正确处理混用两种写法的计划COMPLETE_INLINE/COMPLETE_PRIMARY等见 check-complete.sh。若计划中没有### Phase标题非阶段化结构脚本会静默退出而非误报0/0。此外PLANNING_DISABLED1环境变量可作为一次性/CI 会话的退出开关。4.3session-catchup.py显式的会话上下文聚合# 显式同项目记录聚合例如同时使用 Claude Code 时 python3 .continue/skills/planning-with-files/scripts/session-catchup.py --metadata $(pwd)这是 Continue 场景下最需要理解边界的一个脚本。从 session-catchup.py 的源码与 tests/test_custom_adapter_catchup_privacy.py 的测试约定可以确认以下事实三种模式--no-history默认/裸调用完全不访问宿主会话存储、--metadata仅输出聚合计数如Unsynced entries: N不泄露会话 ID、项目路径、消息字节、--replay输出受 nonce 框定BEGIN-PWF-DATA的有界同项目摘录并明确标记为不可信数据默认与自动 Hook 均不读取 Agent 会话存储main()中no-history分支位于任何会话发现逻辑之前直接返回对应测试断言在--no-history下调用宿主会话发现函数会直接抛错跨项目保护Claude Code 会把路径折叠为目录名两个折叠后同名的项目会共享存储目录脚本按会话中记录的cwd过滤无cwd记录的会话会被隔离quarantine防止跨项目泄露与间接提示注入OpenCode 适配通过只读 SQLitemodero查询session/part表仅统计对规划文件task_plan.md/findings.md/progress.md的写入之后的未同步片段每条输出都做非对称处理frame_untrusted_context()对负载做 SHA-256 摘要、附加 24 位 nonce、限定 65536 字节上限明确标注DATA ONLY ... never as instructions。因此原文档的警告值得原样强调--replay只应用于有意的、有界 nonce 框定回放裸调用与自动 Hook 不检查 Agent 会话存储。在 Continue 中若未同时使用 Claude Code这一脚本通常无需运行。五、Continue 下的手动工作流与注意事项5.1 无 Hook 环境下的操作节奏原文档明确指出的限制Continue 不运行 Claude Code 的PreToolUse/PostToolUse/StopHook。这意味着 Continue 集成无法像 Claude Code 插件那样自动注入计划、自动拦截提前收尾。在 Continue 中保持规划纪律需要人工节奏每个决策前重读task_plan.md参考SKILL.md的 “Read Before Decide” 规则把目标重新拉进注意力窗口每 2 次查看/搜索操作后立即把发现写入findings.md“2-Action Rule”防止多模态信息丢失每阶段完成后把该阶段**Status:** in_progress改为complete并运行check-complete.sh校验新阶段开始 / 间隔较久后恢复重读全部三个规划文件以恢复状态。5.2 规划文件跨工具兼容三个规划文件是工具无关的纯 Markdown可在 Claude Code、Cursor、Gemini CLI、Continue 之间自由切换而无需任何转换这也与 docs/cursor.md 中的兼容性说明一致。若你在 Claude Code 中已有规划文件Continue 侧直接复用即可若主要工作流在 Continue 而偶尔切到 Claude Codesession-catchup.py --metadata $(pwd)可帮你拿到“上次规划文件更新之后还有多少未同步片段”的聚合提示。5.3 验证安装与排查安装后可用以下方式确认集成就绪重启 Continue 后输入/planning-with-files观察是否出现命令补全确认.continue/skills/planning-with-files/SKILL.md的 frontmattername: planning-with-files可被 Continue 的项目 Skill 扫描识别尝试运行init-session.sh确认三个文件在项目根生成legacy 模式或.planning/date-slug/下生成slug 模式。若命令未生效优先检查.continue目录是否位于项目根、planning-with-files.prompt的 frontmatter 是否完整以及 IDE 是否已重载。六、小结Continue 集成是 planning-with-files 覆盖 60 Agent 生态的典型“无 Hook 适配”案例它把 SKILL.md 的方法论、/planning-with-files斜杠命令、以及init-session.sh/check-complete.sh/session-catchup.py含 .ps1 版本完整带入 VS Code 与 JetBrains 环境同时诚实地把自动化程度标注清楚——规划文件的创建、回读、更新完全由人工节奏驱动。这种取舍换来的是三文件格式的绝对可移植性在 Continue 中沉淀的task_plan.md/findings.md/progress.md可以无缝迁移到任何支持该模式的 Agent 中继续执行。对深度依赖 Continue 的开发者而言这套工作流的价值在于即使上下文窗口被清空、会话被压缩磁盘上的计划始终是下一次会话的恢复点。【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考