在 Continue（VS 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
本文面向在 Continue（VS 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.md，Continue 会自动加载项目级 Skill |
| 项目级斜杠命令 | .continue/prompts/planning-with-files.prompt | Markdown 格式的 prompt 文件，注册/planning-with-files命令，调用后引导 Agent 进入三文件规划流程 |
Continue 同时支持两种安装位置：
- 项目级（project-level）：
<repo>/.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 驱动，其前端的 frontmatter（name、description、invokable: true）决定了命令在 IDE 中的注册与显示。加载后 prompt 会引导 Agent 完成以下动作：
- 检查三个规划文件是否存在：
task_plan.md、findings.md、progress.md（位于项目根目录）； - 缺失则创建：手动创建，或运行初始化脚本——
- macOS/Linux：
bash .continue/skills/planning-with-files/scripts/init-session.sh - Windows：
powershell -ExecutionPolicy Bypass -File .continue/skills/planning-with-files/scripts/init-session.ps1
- macOS/Linux：
- 填写
task_plan.md：Goal（一句话）、Phases（3~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.md；task_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 | 创建隔离规划目录（可带名称，也可自动命名） |
--autonomous | v3 自主模式：写入.mode、.nonce、重置.stop_blocks，并自动为计划生成 SHA-256 attestation |
--gated | v3 门控模式（隐含 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、## Phases（Phase 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_DISABLED=1环境变量可作为一次性/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 适配：通过只读 SQLite（
mode=ro）查询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 Code，session-catchup.py --metadata "$(pwd)"可帮你拿到“上次规划文件更新之后还有多少未同步片段”的聚合提示。
5.3 验证安装与排查
安装后可用以下方式确认集成就绪：
- 重启 Continue 后输入
/planning-with-files，观察是否出现命令补全； - 确认
.continue/skills/planning-with-files/SKILL.md的 frontmatter（name: 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），仅供参考
