AdaL CLISylph AI集成 planning-with-files在终端 Agent 中使用持久化 Markdown 计划文件【免费下载链接】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本文面向在 AdaL CLISylph AI 终端环境中使用 planning-with-files 的开发者完整讲解四种安装方式、/skills与/plugin命令用法、目录结构与模板脚本并深入源码说明init-session.sh、check-complete.sh、session-catchup.py的实际行为与隐私边界。读完本文你可以在 AdaL 中独立完成安装 → 验证 → 初始化计划文件 → 日常维护 → 会话恢复的完整工作流。一、AdaL 与 planning-with-files为什么可以无缝配合AdaL 是 SylphAI 推出的终端 CLI 编程助手。它的 skills 机制兼容 Claude Code skills 格式因此 planning-with-files 这套把task_plan.md、findings.md、progress.md三个 Markdown 文件当作 Agent 磁盘上的工作记忆的模式可以原样跑在 AdaL 中不需要任何格式改造。在 README.md 的适配矩阵中AdaL CLI 被列入标准 Agent Skills一类通过SKILL.md开放标准发现技能属于无生命周期钩子的纯模式。这意味着在 AdaL 中planning-with-files 以显式脚本驱动为主——你或 Agent 本身按需调用init-session.sh、check-complete.sh、session-catchup.py等脚本而不是依赖 IDE 的自动钩子注入。二、安装四种方式覆盖 macOS / Linux / Windows方式一插件市场安装推荐AdaL 支持从 GitHub 拉取外部技能到本地插件缓存一次性添加市场后即可浏览安装# 添加市场一次性配置 /plugin marketplace add OthmanAdi/planning-with-files # 打开对话框浏览并安装 /plugin # 或直接安装 /plugin install planning-with-filesplanning-with-files方式二复制到个人 skills 目录个人目录对所有项目生效优先级最高git clone https://gitcode.com/GitHub_Trending/pl/planning-with-files.git mkdir -p ~/.adal/skills cp -r planning-with-files/skills/planning-with-files ~/.adal/skills/方式三复制到项目 skills 目录项目目录随 git 共享给团队git clone https://gitcode.com/GitHub_Trending/pl/planning-with-files.git mkdir -p .adal/skills cp -r planning-with-files/skills/planning-with-files .adal/skills/方式四WindowsPowerShellgit clone https://gitcode.com/GitHub_Trending/pl/planning-with-files.git New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.adal\skills Copy-Item -Recurse -Path planning-with-files\skills\planning-with-files -Destination $env:USERPROFILE\.adal\skills\说明复制的是skills/planning-with-files单技能目录其中包含SKILL.md、scripts/、templates/、reference.md、examples.md全套面。仓库根目录另有各语言的 i18n 变体如 skills/i18n/planning-with-files-zh如需中文版可复制对应目录。仓库本身是只读的上述操作只是把技能安装到你的 AdaL 环境中。三、技能位置与优先级AdaL 支持三种技能来源按优先级从高到低来源位置适用场景个人~/.adal/skills/自定义技能优先级最高项目.adal/skills/通过 git 共享的团队技能插件~/.adal/plugin-cache/来自 GitHub 的外部技能优先级最低安装后可用/skills命令验证技能是否被识别。该命令会列出全部三个来源的技能典型输出如下 Skills (Page 1/1) Personal (~/.adal/skills/): planning-with-files Project (.adal/skills/): (none) Plugins: (none)四、/plugin 命令速查命令说明/plugin marketplace add owner/repo添加市场一次性配置/plugin浏览可用插件与市场/plugin install pluginmarketplace安装插件/plugin uninstall pluginmarketplace卸载插件/plugin marketplace remove name移除市场五、安装后的目录结构以项目级安装为例安装完成后你的项目应长这样your-project/ ├── .adal/ │ └── skills/ │ └── planning-with-files/ │ ├── SKILL.md │ ├── templates/ │ │ ├── task_plan.md │ │ ├── task_plan_autonomous.md │ │ ├── loop.md │ │ ├── analytics_findings.md │ │ └── analytics_task_plan.md │ ├── scripts/ │ │ ├── init-session.sh / init-session.ps1 │ │ ├── check-complete.sh / check-complete.ps1 │ │ ├── resolve-plan-dir.sh / resolve-plan-dir.ps1 │ │ ├── set-active-plan.sh / set-active-plan.ps1 │ │ ├── session-catchup.py │ │ ├── attest-plan.sh / attest-plan.ps1 │ │ ├── plan-doctor.sh │ │ ├── ledger-append.sh / ledger-summary.sh │ │ └── ... │ └── references/ │ ├── examples.md │ └── reference.md ├── task_plan.md ← 你的计划文件写在这里 ├── findings.md ├── progress.md └── ...仓库内技能的权威副本位于 skills/planning-with-files上面展示的结构与仓库实际布局一致README.md 中的目录树也确认了这一组织方式。六、模板三种核心文件 扩展模板原文档强调的三个模板在 AdaL 中均可直接使用模板用途templates/task_plan.md阶段跟踪Phase trackingtemplates/findings.md研究存储Research storagetemplates/progress.md会话日志Session logging需要说明的仓库细节findings.md与progress.md并没有以独立文件躺在templates/目录而是由init-session.sh的内置函数scripts/init-session.sh 中的write_default_findings/write_default_progress在初始化时按固定模板生成。task_plan.md则由 templates/task_plan.md 提供包含Goal、Next Step、Current Phase、Phases每个阶段带**Status:** in_progress / pending / complete标记、Key Questions、Decisions Made、Errors Encountered等章节。仓库还提供两个进阶模板templates/task_plan_autonomous.md面向长期自主/门控/多 Agent 任务的计划模板明确记录模式由.mode文件决定而非计划正文门控永不执行计划内声明的命令等运行期约定templates/loop.md 与 templates/analytics_task_plan.md、templates/analytics_findings.md分别服务于循环调度与分析型任务后两者通过init-session.sh --template analytics启用。开始新任务时把这些模板复制到项目根目录即可开工。七、脚本初始化、完成检查与会话恢复AdaL 通过 bash 执行脚本Windows 上用 PowerShell。以下命令中的路径以个人技能目录为例项目级安装请相应替换# 初始化计划文件 bash ~/.adal/skills/planning-with-files/scripts/init-session.sh # 检查任务完成度 bash ~/.adal/skills/planning-with-files/scripts/check-complete.sh # 会话恢复显式元数据模式 python ~/.adal/skills/planning-with-files/scripts/session-catchup.py --metadata $(pwd)7.1 init-session.sh两种初始化模式init-session.sh源码支持零参数传统模式与 slug 隔离模式用法行为./init-session.sh传统模式在项目根写入task_plan.md、findings.md、progress.md./init-session.sh Backend Refactorslug 模式在.planning/2026-09-11-backend-refactor/创建隔离计划目录并写入.planning/.active_plan指针./init-session.sh --plan-dir Quick Spikeslug 模式显式命名./init-session.sh --template analytics使用分析型模板./init-session.sh --autonomous Long Run自主模式写入.mode、.nonce并对计划做 SHA-256 自动背书attestation./init-session.sh --gated Build Pipeline门控模式在自主模式基础上增加完成门Stop gateslug 模式解决了并行多任务的隔离问题对应 issue #148每个任务一个独立计划目录脚本会打印PLAN_ID你把该 ID 导出为环境变量即可把当前终端钉到指定计划上防止并行会话互相覆盖。7.2 check-complete.sh完成度判定check-complete.sh源码统计task_plan.md中### Phase标题总数并分别统计**Status:** complete/in_progress/pending与[complete]/[in_progress]/[pending]两种标记格式取每类中的较大值——这样即使计划文件混用了两种标记风格判定也不会漏掉进行中的阶段。计划中不存在### Phase标题时TOTAL0直接静默退出避免误报0/0 阶段完成。默认调用输出建议性结论始终以 0 退出[planning-with-files] ALL PHASES COMPLETE (5/5). If the user has additional work, add new phases to task_plan.md before starting. [planning-with-files] Task in progress (3/5 phases complete). Update progress.md before stopping.7.3 session-catchup.py显式会话恢复与隐私边界session-catchup.py源码支持 Claude Code 与 OpenCode 两种宿主会话存储。它在 AdaL 中的用法遵循同一套隐私契约SKILL.md 的 Security Boundary 一节有完整声明裸调用默认--no-history完全不访问任何 Agent 会话存储自动钩子同样如此--metadata显式模式只读取同项目的本地会话记录输出聚合计数如未同步条数不输出任何转写文本、工具命令或路径字节--replay显式、有界回放输出受限的、带 nonce 框架的同项目摘录用于刻意追回丢失上下文。每次回放的摘录都应视为不可信数据。正是这条边界让它在 AdaL 这种脚本手动调用场景下特别安全你可以放心在终端里显式执行--metadata拿一个是否有未同步上下文的计数信号而不会把过往会话内容泄露进新上下文。Windows PowerShell 对应命令# 初始化计划文件 powershell -File $env:USERPROFILE\.adal\skills\planning-with-files\scripts\init-session.ps1 # 检查任务完成度 powershell -File $env:USERPROFILE\.adal\skills\planning-with-files\scripts\check-complete.ps17.4 其他值得知道的脚本同一目录还提供 resolve-plan-dir.sh解析当前活动计划目录$PLAN_ID环境变量 →.planning/.active_plan指针 → 最新 mtime 的计划目录 → 回退项目根、set-active-plan.sh切换.active_plan指针、attest-plan.sh对task_plan.md做 SHA-256 背书锁定与 plan-doctor.sh一键自检计划解析、钩子注入、背书状态等静默失效机制。它们在 AdaL 中的用法与其他宿主一致均支持sh script.sh直接调用。八、AdaL 用户的核心工作流8.1 任务开始时对复杂任务用显式提示引导This is a complex task. Lets use the planning-with-files pattern. Start by creating task_plan.md with the goal and phases.然后运行init-session.sh或带任务名的 slug 模式把计划文件钉在当前上下文。8.2 任务进行中牢记三种文件的分工与更新时机SKILL.md文件用途何时更新task_plan.md阶段、进度、决策每个阶段结束后findings.md研究、发现任何发现之后立即progress.md会话日志、测试结果贯穿整个会话配合三条关键纪律先建计划再动手没有task_plan.md绝不开始复杂任务2 操作规则每 2 次视图/浏览器/搜索操作后立即把关键发现写入文件防止多模态信息丢失决策前先读计划做重大决策前重新读一遍task_plan.md把目标拉回注意力窗口这正是 Manus 处理约 50 次工具调用不跑偏的核心机制见 reference.md 中的注意力复诵原理。8.3 收尾时让 AdaL 周期性重读task_plan.md刷新目标用check-complete.sh验证所有阶段是否complete若所有阶段完成但用户追加了新需求就在task_plan.md增加新阶段如 Phase 6、Phase 7并在progress.md记录新会话条目后继续循环。九、在 AdaL 中使用 parallel-plan 模式进阶slug 模式天然适合 AdaL 中并行打开多个终端会话# 终端 A初始化后端重构任务使用脚本打印的 PLAN_ID ./scripts/init-session.sh Backend Refactor export PLAN_ID2026-09-11-backend-refactor # 从这个终端启动你的 AdaL 会话 # 终端 B初始化故障调查任务 ./scripts/init-session.sh Incident Investigation export PLAN_ID2026-09-11-incident-investigation # 从第二个终端启动另一个 AdaL 会话PLAN_ID是绑定而非提示issue #237 的结论一旦设置解析器要么解析到该计划、要么停止解析绝不会静默回退到别的计划。这正是多 Agent 并行任务防串线的关键。切换共享默认指针用set-active-plan.sh但它只适合顺序切换不能绑定并发会话。十、故障排查与帮助技能未生效先/skills确认planning-with-files已被 AdaL 识别钩子/注入异常、状态存疑运行 plan-doctor.sh 做一次性自检它专门排查静默失败的机制计划解析、注入、背书状态、安装面更多宿主适配说明见 README.md 的适配矩阵与各 IDE 文档如 docs/troubleshooting.md、docs/quickstart.md完整的行为契约、安全边界与反模式清单见 skills/planning-with-files/SKILL.md真实任务示例见 skills/planning-with-files/examples.md。【免费下载链接】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），仅供参考 AdaL CLI（Sylph AI）集成 planning-with-files：在终端 Agent 中使用持久化 Markdown 计划文件
AdaL CLISylph AI集成 planning-with-files在终端 Agent 中使用持久化 Markdown 计划文件【免费下载链接】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本文面向在 AdaL CLISylph AI 终端环境中使用 planning-with-files 的开发者完整讲解四种安装方式、/skills与/plugin命令用法、目录结构与模板脚本并深入源码说明init-session.sh、check-complete.sh、session-catchup.py的实际行为与隐私边界。读完本文你可以在 AdaL 中独立完成安装 → 验证 → 初始化计划文件 → 日常维护 → 会话恢复的完整工作流。一、AdaL 与 planning-with-files为什么可以无缝配合AdaL 是 SylphAI 推出的终端 CLI 编程助手。它的 skills 机制兼容 Claude Code skills 格式因此 planning-with-files 这套把task_plan.md、findings.md、progress.md三个 Markdown 文件当作 Agent 磁盘上的工作记忆的模式可以原样跑在 AdaL 中不需要任何格式改造。在 README.md 的适配矩阵中AdaL CLI 被列入标准 Agent Skills一类通过SKILL.md开放标准发现技能属于无生命周期钩子的纯模式。这意味着在 AdaL 中planning-with-files 以显式脚本驱动为主——你或 Agent 本身按需调用init-session.sh、check-complete.sh、session-catchup.py等脚本而不是依赖 IDE 的自动钩子注入。二、安装四种方式覆盖 macOS / Linux / Windows方式一插件市场安装推荐AdaL 支持从 GitHub 拉取外部技能到本地插件缓存一次性添加市场后即可浏览安装# 添加市场一次性配置 /plugin marketplace add OthmanAdi/planning-with-files # 打开对话框浏览并安装 /plugin # 或直接安装 /plugin install planning-with-filesplanning-with-files方式二复制到个人 skills 目录个人目录对所有项目生效优先级最高git clone https://gitcode.com/GitHub_Trending/pl/planning-with-files.git mkdir -p ~/.adal/skills cp -r planning-with-files/skills/planning-with-files ~/.adal/skills/方式三复制到项目 skills 目录项目目录随 git 共享给团队git clone https://gitcode.com/GitHub_Trending/pl/planning-with-files.git mkdir -p .adal/skills cp -r planning-with-files/skills/planning-with-files .adal/skills/方式四WindowsPowerShellgit clone https://gitcode.com/GitHub_Trending/pl/planning-with-files.git New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.adal\skills Copy-Item -Recurse -Path planning-with-files\skills\planning-with-files -Destination $env:USERPROFILE\.adal\skills\说明复制的是skills/planning-with-files单技能目录其中包含SKILL.md、scripts/、templates/、reference.md、examples.md全套面。仓库根目录另有各语言的 i18n 变体如 skills/i18n/planning-with-files-zh如需中文版可复制对应目录。仓库本身是只读的上述操作只是把技能安装到你的 AdaL 环境中。三、技能位置与优先级AdaL 支持三种技能来源按优先级从高到低来源位置适用场景个人~/.adal/skills/自定义技能优先级最高项目.adal/skills/通过 git 共享的团队技能插件~/.adal/plugin-cache/来自 GitHub 的外部技能优先级最低安装后可用/skills命令验证技能是否被识别。该命令会列出全部三个来源的技能典型输出如下 Skills (Page 1/1) Personal (~/.adal/skills/): planning-with-files Project (.adal/skills/): (none) Plugins: (none)四、/plugin 命令速查命令说明/plugin marketplace add owner/repo添加市场一次性配置/plugin浏览可用插件与市场/plugin install pluginmarketplace安装插件/plugin uninstall pluginmarketplace卸载插件/plugin marketplace remove name移除市场五、安装后的目录结构以项目级安装为例安装完成后你的项目应长这样your-project/ ├── .adal/ │ └── skills/ │ └── planning-with-files/ │ ├── SKILL.md │ ├── templates/ │ │ ├── task_plan.md │ │ ├── task_plan_autonomous.md │ │ ├── loop.md │ │ ├── analytics_findings.md │ │ └── analytics_task_plan.md │ ├── scripts/ │ │ ├── init-session.sh / init-session.ps1 │ │ ├── check-complete.sh / check-complete.ps1 │ │ ├── resolve-plan-dir.sh / resolve-plan-dir.ps1 │ │ ├── set-active-plan.sh / set-active-plan.ps1 │ │ ├── session-catchup.py │ │ ├── attest-plan.sh / attest-plan.ps1 │ │ ├── plan-doctor.sh │ │ ├── ledger-append.sh / ledger-summary.sh │ │ └── ... │ └── references/ │ ├── examples.md │ └── reference.md ├── task_plan.md ← 你的计划文件写在这里 ├── findings.md ├── progress.md └── ...仓库内技能的权威副本位于 skills/planning-with-files上面展示的结构与仓库实际布局一致README.md 中的目录树也确认了这一组织方式。六、模板三种核心文件 扩展模板原文档强调的三个模板在 AdaL 中均可直接使用模板用途templates/task_plan.md阶段跟踪Phase trackingtemplates/findings.md研究存储Research storagetemplates/progress.md会话日志Session logging需要说明的仓库细节findings.md与progress.md并没有以独立文件躺在templates/目录而是由init-session.sh的内置函数scripts/init-session.sh 中的write_default_findings/write_default_progress在初始化时按固定模板生成。task_plan.md则由 templates/task_plan.md 提供包含Goal、Next Step、Current Phase、Phases每个阶段带**Status:** in_progress / pending / complete标记、Key Questions、Decisions Made、Errors Encountered等章节。仓库还提供两个进阶模板templates/task_plan_autonomous.md面向长期自主/门控/多 Agent 任务的计划模板明确记录模式由.mode文件决定而非计划正文门控永不执行计划内声明的命令等运行期约定templates/loop.md 与 templates/analytics_task_plan.md、templates/analytics_findings.md分别服务于循环调度与分析型任务后两者通过init-session.sh --template analytics启用。开始新任务时把这些模板复制到项目根目录即可开工。七、脚本初始化、完成检查与会话恢复AdaL 通过 bash 执行脚本Windows 上用 PowerShell。以下命令中的路径以个人技能目录为例项目级安装请相应替换# 初始化计划文件 bash ~/.adal/skills/planning-with-files/scripts/init-session.sh # 检查任务完成度 bash ~/.adal/skills/planning-with-files/scripts/check-complete.sh # 会话恢复显式元数据模式 python ~/.adal/skills/planning-with-files/scripts/session-catchup.py --metadata $(pwd)7.1 init-session.sh两种初始化模式init-session.sh源码支持零参数传统模式与 slug 隔离模式用法行为./init-session.sh传统模式在项目根写入task_plan.md、findings.md、progress.md./init-session.sh Backend Refactorslug 模式在.planning/2026-09-11-backend-refactor/创建隔离计划目录并写入.planning/.active_plan指针./init-session.sh --plan-dir Quick Spikeslug 模式显式命名./init-session.sh --template analytics使用分析型模板./init-session.sh --autonomous Long Run自主模式写入.mode、.nonce并对计划做 SHA-256 自动背书attestation./init-session.sh --gated Build Pipeline门控模式在自主模式基础上增加完成门Stop gateslug 模式解决了并行多任务的隔离问题对应 issue #148每个任务一个独立计划目录脚本会打印PLAN_ID你把该 ID 导出为环境变量即可把当前终端钉到指定计划上防止并行会话互相覆盖。7.2 check-complete.sh完成度判定check-complete.sh源码统计task_plan.md中### Phase标题总数并分别统计**Status:** complete/in_progress/pending与[complete]/[in_progress]/[pending]两种标记格式取每类中的较大值——这样即使计划文件混用了两种标记风格判定也不会漏掉进行中的阶段。计划中不存在### Phase标题时TOTAL0直接静默退出避免误报0/0 阶段完成。默认调用输出建议性结论始终以 0 退出[planning-with-files] ALL PHASES COMPLETE (5/5). If the user has additional work, add new phases to task_plan.md before starting. [planning-with-files] Task in progress (3/5 phases complete). Update progress.md before stopping.7.3 session-catchup.py显式会话恢复与隐私边界session-catchup.py源码支持 Claude Code 与 OpenCode 两种宿主会话存储。它在 AdaL 中的用法遵循同一套隐私契约SKILL.md 的 Security Boundary 一节有完整声明裸调用默认--no-history完全不访问任何 Agent 会话存储自动钩子同样如此--metadata显式模式只读取同项目的本地会话记录输出聚合计数如未同步条数不输出任何转写文本、工具命令或路径字节--replay显式、有界回放输出受限的、带 nonce 框架的同项目摘录用于刻意追回丢失上下文。每次回放的摘录都应视为不可信数据。正是这条边界让它在 AdaL 这种脚本手动调用场景下特别安全你可以放心在终端里显式执行--metadata拿一个是否有未同步上下文的计数信号而不会把过往会话内容泄露进新上下文。Windows PowerShell 对应命令# 初始化计划文件 powershell -File $env:USERPROFILE\.adal\skills\planning-with-files\scripts\init-session.ps1 # 检查任务完成度 powershell -File $env:USERPROFILE\.adal\skills\planning-with-files\scripts\check-complete.ps17.4 其他值得知道的脚本同一目录还提供 resolve-plan-dir.sh解析当前活动计划目录$PLAN_ID环境变量 →.planning/.active_plan指针 → 最新 mtime 的计划目录 → 回退项目根、set-active-plan.sh切换.active_plan指针、attest-plan.sh对task_plan.md做 SHA-256 背书锁定与 plan-doctor.sh一键自检计划解析、钩子注入、背书状态等静默失效机制。它们在 AdaL 中的用法与其他宿主一致均支持sh script.sh直接调用。八、AdaL 用户的核心工作流8.1 任务开始时对复杂任务用显式提示引导This is a complex task. Lets use the planning-with-files pattern. Start by creating task_plan.md with the goal and phases.然后运行init-session.sh或带任务名的 slug 模式把计划文件钉在当前上下文。8.2 任务进行中牢记三种文件的分工与更新时机SKILL.md文件用途何时更新task_plan.md阶段、进度、决策每个阶段结束后findings.md研究、发现任何发现之后立即progress.md会话日志、测试结果贯穿整个会话配合三条关键纪律先建计划再动手没有task_plan.md绝不开始复杂任务2 操作规则每 2 次视图/浏览器/搜索操作后立即把关键发现写入文件防止多模态信息丢失决策前先读计划做重大决策前重新读一遍task_plan.md把目标拉回注意力窗口这正是 Manus 处理约 50 次工具调用不跑偏的核心机制见 reference.md 中的注意力复诵原理。8.3 收尾时让 AdaL 周期性重读task_plan.md刷新目标用check-complete.sh验证所有阶段是否complete若所有阶段完成但用户追加了新需求就在task_plan.md增加新阶段如 Phase 6、Phase 7并在progress.md记录新会话条目后继续循环。九、在 AdaL 中使用 parallel-plan 模式进阶slug 模式天然适合 AdaL 中并行打开多个终端会话# 终端 A初始化后端重构任务使用脚本打印的 PLAN_ID ./scripts/init-session.sh Backend Refactor export PLAN_ID2026-09-11-backend-refactor # 从这个终端启动你的 AdaL 会话 # 终端 B初始化故障调查任务 ./scripts/init-session.sh Incident Investigation export PLAN_ID2026-09-11-incident-investigation # 从第二个终端启动另一个 AdaL 会话PLAN_ID是绑定而非提示issue #237 的结论一旦设置解析器要么解析到该计划、要么停止解析绝不会静默回退到别的计划。这正是多 Agent 并行任务防串线的关键。切换共享默认指针用set-active-plan.sh但它只适合顺序切换不能绑定并发会话。十、故障排查与帮助技能未生效先/skills确认planning-with-files已被 AdaL 识别钩子/注入异常、状态存疑运行 plan-doctor.sh 做一次性自检它专门排查静默失败的机制计划解析、注入、背书状态、安装面更多宿主适配说明见 README.md 的适配矩阵与各 IDE 文档如 docs/troubleshooting.md、docs/quickstart.md完整的行为契约、安全边界与反模式清单见 skills/planning-with-files/SKILL.md真实任务示例见 skills/planning-with-files/examples.md。【免费下载链接】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），仅供参考