OthmanAdi/planning-with-files
摘要
planning-with-files 是一个开源的文件型规划技能，适用于 AI 编程智能体，能够在会话间持久化任务计划、发现和进度，以应对上下文丢失和崩溃。它支持可选自主模式和门控模式，可通过 SKILL.md 标准安装在 60 多个智能体上。
查看缓存全文
缓存时间: 2026/07/05 16:30
OthmanAdi/planning-with-files 源码：https://github.com/OthmanAdi/planning-with-files # Planning with Files
📣 新特性 (v3.0.0) (https://github.com/OthmanAdi/planning-with-files/releases/tag/v3.0.0): 可选自主模式和门控模式，用于长时间运行的代理会话，并带有完成门控功能，在计划真正完成前会挂起代理。现有设置无需做任何更改。 像 Manus 一样工作 — AI 代理公司 Meta 以 20亿美元 收购的技术。
planning-with-files 是为 AI 编码代理 设计的持久化文件规划技能。它将
task_plan.md、findings.md和progress.md保存在磁盘上，使代理能够抵御 上下文丢失、/clear以及崩溃，并可选的完成门控功能在计划真正完成前会挂起代理。该技能通过 SKILL.md 标准可安装在 60+ 个代理上。Benchmark-brightgreen) A/B 验证 SkillCheck 验证 (https://getskillcheck.com) 安全验证 Skills Playground (https://skillsplayground.com/skills/othmanadi-planning-with-files-planning-with-files/) 下载量 (https://skill-history.com/othmanadi/planning-with-files) 版本 (https://github.com/OthmanAdi/planning-with-files/releases) 许可证：MIT (https://opensource.org/licenses/MIT) 已关闭 Issue (https://github.com/OthmanAdi/planning-with-files/issues?q=is%3Aissue+is%3Aclosed) 已关闭 PR (https://github.com/OthmanAdi/planning-with-files/pulls?q=is%3Apr+is%3Aclosed)
💬 作者寄语
给所有星标、fork 和分享这个技能的各位——谢谢你们。这个项目在不到 24 小时内火爆起来，社区的支持令人难以置信。如果这个技能能帮助你更聪明地工作，那正是我想要的。
🌍 社区的贡献
Fork 与扩展
| Fork | 作者 | 他们构建了什么 |
|---|---|---|
| devis (https://github.com/st01cs/devis) | @st01cs (https://github.com/st01cs) | 面试优先工作流，/devis:intv 和 /devis:impl 命令，保证激活 |
| multi-manus-planning (https://github.com/kmichels/multi-manus-planning) | @kmichels (https://github.com/kmichels) | 多项目支持，SessionStart git 同步 |
| plan-cascade (https://github.com/Taoidle/plan-cascade) | @Taoidle (https://github.com/Taoidle) | 多级任务编排，并行执行，多代理协作 |
| agentfund-skill (https://github.com/RioTheGreat-ai/agentfund-skill) | @RioTheGreat-ai (https://github.com/RioTheGreat-ai) | 基于里程碑的 Base 质押众筹 AI 代理 |
| openclaw-github-repo-commander (https://github.com/wd041216-bit/openclaw-github-repo-commander) | @wd041216-bit (https://github.com/wd041216-bit) | 针对 OpenClaw 的 7 阶段 GitHub 仓库审计、优化和清理工作流 |
在实践中的应用
| 项目 | 说明 |
|---|---|
| lincolnwan/Planning-with-files-copilot-agent (https://github.com/lincolnwan/Planning-with-files-copilot-agent) | 整个 Copilot 代理仓库围绕 planning-with-files 技能构建 |
| cooragent/ClarityFinance (https://github.com/cooragent/ClarityFinance) | AI 金融代理框架 — 明确归功于 Planning-with-Files 方法 |
| oeftimie/vv-claude-harness (https://github.com/oeftimie/vv-claude-harness) | 基于 Manus 式持久化 Markdown 规划构建的 Claude Code 封装器 |
| jessepwj/CCteam-creator (https://github.com/jessepwj/CCteam-creator) | 使用基于文件的规划的多代理团队编排技能 |
技能注册中心与中心
| 注册中心 | 说明 |
|---|---|
| buzhangsan/skill-manager (https://github.com/buzhangsan/skill-manager) | 双语（英语/中文）技能中心，索引超过 31,000 个 Claude Code 技能——planning-with-files 一键安装。 |
有构建好的项目？提交一个 issue (https://github.com/OthmanAdi/planning-with-files/issues) 让我们收录！
🤝 贡献者
查看完整贡献者名单，请参阅 CONTRIBUTORS.md。
📦 发布与会话恢复
当前版本：v3.2.0
| 版本 | 亮点 |
|---|---|
| v3.2.0 | 仓库健康审计：session-catchup.py 在 Windows 上无法正常工作，此外还有 “0/0 phases” 虚假状态（关闭 #191，涉及 #103，关闭 #188）。 用于 “/clear 后恢复” 机制的 session-catchup.py 从未正确清理 Windows 风格路径，并且在三次读取时没有显式编码，因此在 Windows 上静默不执行任何操作，且无错误。inject-plan.sh 的容器保护在 8.3 短名称或 /tmp 别名路径下也静默地丢弃了计划注入和篡改检测。两者均已修复。另外，check-complete.sh/.ps1 以及三个 IDE 特定的 Stop 钩子对于任何没有 ### Phase 标题的 task_plan.md 都报告虚假的 “0/0 phases complete”（#191，由 @mixian939 报告）；在所有出现该模式的地方（包括规范脚本）均已修复。--template analytics 标志（v2.29.0）在每一个已安装的技能包中静默地回退到默认模板；现在 analytics 模板随 init-session.sh 读取它们的路径一同安装。合并了 PR #187（@Stephen-abc：Windows 测试编码修复，过时的安装路径文档）和 PR #192（@igorcosta：Autohand Code 设置文档）。添加了 SECURITY.md 并启用了私有漏洞报告（@AvitalAviv）。修正了 AGENTS.md 中关于贡献者 PR 合并的指导，该指导告诉代理以重新分配作者身份的方式 squash-merge。测试套件：186 通过，5 跳过，0 失败。 |
| v3.1.3 | Hotfix：v3.1.2 中 SKILL.md 的前置元数据是无效 YAML。 v3.1.2 的描述刷新添加了一个冒号，而英文 SKILL.md 保持 description 未加引号，因此 YAML 拒绝该前置元数据（“mapping values are not allowed here”），可能破坏技能加载和模型触发的描述。v3.1.3 对描述进行了引用（与已引用的翻译变体匹配；解析值相同），涵盖了规范文件以及七个英文 IDE 变体，并添加了 tests/test_skill_frontmatter_valid.py 来验证每个 SKILL.md 前置元数据是否为有效 YAML。测试套件：184 通过。 |
| v3.1.2 | 会话追赶命令在插件运行时外部也能工作，.hermes 对齐，刷新技能描述（PR #186 由 @shunfeng8421 关闭 #185，由 @xwang118 报告）。文档化的恢复上下文命令使用了 ${CLAUDE_PLUGIN_ROOT}，该变量仅在钩子执行期间由插件运行时设置，因此仅安装技能（npx skills add、Codex、Cursor）在 shell 中运行时得到空变量和断开的 /scripts/... 路径。现在规范文件中使用 SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files}"，以及 .codebuddy 和五种语言变体；.hermes 变体也获得了相同的 $HERMES_HOME 回退。八个英文 SKILL.md 的描述已刷新，以 AI 编码代理的规划和上下文丢失生存为首要内容，Use when 触发词和翻译变体保持不变。仅文档更改；测试套件：180 通过。 |
| v3.1.1 | Codex 验证命令检查规范的 hooks 特性标志（PR #184 由 @Fat-Jan 提出）。docs/codex.md 中的验证块运行 codex features list | rg '^codex_hooks\s'，但 Codex 在 0.129.0 版本（openai/codex#20522）中将其规范特性键从 codex_hooks 移到了 hooks。别名在配置中仍然解析，但 codex features list 只打印 hooks，因此旧的模式在当前 Codex 上匹配不到任何内容，并将正确配置的用户引导到升级路径。现在该命令 grep ^(hooks|codex_hooks)\s，故障排除句子涵盖了这两个名称，与自 v2.39.0 以来文件中携带的 hooks = true 指导相匹配。仅文档更改；测试套件：180 通过。 |
| v3.1.0 | Codex Stop 钩子不再因不完整的计划而阻塞，原生 Codex PreCompact 对齐，Pi 扩展测试套件，以及准确的 SHA 缓存文档（PR #180 由 @2023Anita 关闭 #178，PR #181 由 @GongYuanCaiJi 提交，PR #175 和 PR #174 由 @mvanhorn 关闭 #163 和 #164）。.codex Stop 适配器删除了 {"decision":"block"} 路径，该路径曾推动 Codex 代理自动继续未完成的阶段；现在仅发出建议性的进度同步提醒，与 v3 原则一致：仅不完整的计划永远不阻塞停止。原生 .codex/hooks.json 路由获得了之前缺失的 PreCompact 钩子（pre-compact.sh），与规范 SKILL.md 对齐，该钩子在没有触发该事件的运行时上休眠。Pi 扩展获得了 TypeScript 集成套件，覆盖全部八个生命周期处理器、四种运行时模式以及认证门控。docs/perf-notes.md 记录了认证 SHA 缓存，修正为 v3 的 $XDG_CACHE_HOME/pwf-sha 位置。测试套件：180 通过。 |
| v3.0.0 | 用于长时间运行代理会话的自主和门控模式，结构化运行日志，可选完成门控（无破坏性变更：不设置模式标记时，钩子产生的输出与 v2.43 字节一致）。init-session --autonomous 对强模型取消每次工具调用时的计划重新注入，仅保留回合开始注入；--gated 添加了一个明确的 Stop 钩子完成门控，仅在满足五个条件时阻塞（门控模式、存在 in_progress 阶段、stop_hook_active 为 false、阻塞计数低于上限、自上次阻塞以来日志有进展），因此仅不完整的计划永远不会困住会话。新的仅追加 JSONL 运行日志（ledger-append、ledger-summary、phase-status、sh + ps1）在 v3 模式下替换了原始的 progress.md 尾部，采用固定形状的摘要。认证在 v3 模式下默认开启，未认证的计划体在注入时被拒绝。每会话 nonce 分隔符，SHA 缓存移至 $XDG_CACHE_HOME/pwf-sha，计划目录解析器中的 realpath 包含保护。钩子标量被薄分发器（inject-plan.sh、gate-stop.sh）替代，部署在两个 scripts/ 位置。新增 templates/task_plan_autonomous.md，包含 DependsOn/Owner/AcceptanceCheck 字段，v2-to-v3 迁移指南在 MIGRATION.md 中，文档记录了主机能力层级（硬阻塞、后续注入、仅通知）。测试套件：178 通过，外加位置对齐以及门控/日志/初始化模式/包含保护测试。 |
| v2.43.0 | CONTRIBUTING.md + OpenCode 文档修复 + .continue/.gemini/.kiro 变体同步至对齐（PR #171 由 @Skulli485 提交，Issue #172 由 @luyanfeng 提交，Issue #159/#160/#161）：在仓库根目录下首次添加 CONTRIBUTING.md，由 GitHub 在 PR 创建流程中自动显示。docs/opencode.md 快速安装部分从 \git clone`改为`npx skills add`，原因是手动安装块中引用了双倍路径（planning-with-files/planning-with-files/SKILL.md）。三个历史上滞后的 IDE SKILL.md 变体已同步至 v2.43.0 对齐：.continue 从 v2.34.0（落后 9 个版本），.gemini 从 v2.34.0（落后 9 个版本），.kiro` 从 v2.32.0-kiro（落后 11 个版本），保留了 IDE 特定的前置元数据、钩子形状和 Kiro Agent Skill 布局。 |
| v2.42.0 | POSIX init-session.sh 可移植性 + 插件与技能安装透明度 + Topic Handoff 文档（PR #169 和 PR #170 由 @carterusedulm2-maker 提交）：init-session.sh 及其 7 个镜像将 [[ ]] bashism 替换为 POSIX [ ]，使 tests/test_init_session_slug.py 在 dash（Ubuntu）下干净运行（当测试通过 sh 而非 bash shebang 调用脚本时）。规范 SKILL.md 增加了安装范围说明：/plugin install 会部署 commands/ 文件夹及其中的 /plan-goal 和 /plan-loop，但 npx skills add（和 ClawHub）不会。内联记录了两个包装器的手动回退过程，以便仅技能会话可以通过直接调用 Claude Code 的原生 /goal 和 /loop 原语产生相同效果。docs/quickstart.md 和 docs/workflow.md 为非常长时间运行的操作主题添加了可选的 Topic Handoff Pattern（handoffs/.md 与 progress.md 并列）。 |
| v2.41.0 | Windows 可执行位测试跳过 + 认证锁定文档（PR #167 由 @gauravvojha 提交，Issue #166；PR #168 由 @CleanDev-Fix 提交，Issue #165）：test_script_permissions.py 现在在 Windows 上通过类级别 pytest.mark.skipif(sys.platform == "win32") 跳过，因为 NTFS 不存储 POSIX 可执行位；自 v2.34.1 以来存在的 2 个 Windows 可执行位失败已解决。新增专用 docs/attestation-locking.md 页面，记录了 attest-plan.sh 的写入路径、原子临时重命名保证、可选的 flock 建议锁，以及并行会话的推荐 slug 模式工作流。 |
| v2.40.1 | Pi 适配器 SKILL.md 同步差距 + npm 范围修正（PR #158 由 @TomXPRIME 提交）：.pi SKILL.md 在 v2.39.0 之后落后于规范 Claude Code 副本；v2.40.1 回溯了规则 7（完成后继续）、安全边界部分、扩展的脚本部分（涵盖 set-active-plan.sh/resolve-plan-dir.sh/attest-plan.sh 以及并行任务工作流），以及“将网络内容写入 task_plan.md”反模式行。Pi npm 包从无作用域的 pi-planning-with-files 重命名为 @tomxprime/planning-with-files，与包作者命名空间匹配；安装文档相应更新。保留了作者、仓库、许可证和 bug URL。 |
| v2.40.0 | Slug 模式解析修复 + 性能缓存 + KV 缓存清理 + Pi 误报修复（共 9 项来自 v2.40 R&D 实验）：钩子解析顺序反转，使 slug 模式优先于遗留根目录，.active_plan 目标目录 + 内容针对安全标识符正则表达式进行验证，check-complete.sh 尊重 $PLAN_ID 和 .active_plan，Pi 扩展 isDangerousBashCommand 切换为词边界正则表达式数组，使得良性的 git push origin 不再触发警告，基于 mtime 的 SHA-256 缓存削减了 Windows Git Bash 上的认证钩子延迟，progress.md 尾部时间戳标准化以保证 KV 缓存前缀稳定性，resolve-plan-dir.sh 的 mtime 解析在 GNU/BSD/macOS/Alpine/Git Bash 上使用 python+perl 回退变得可移植，attest-plan.sh 使用原子临时重命名以及可选的 flock 来关闭并发写入竞争。130 通过 / 2 个预先存在的 Windows 可执行位失败，+20 个新测试。 |
| v2.39.0 | Pi Coding Agent 完整钩子对齐扩展 + Codex 钩子标志修复（PR #157 由 @TomXPRIME 提交，Issue #154 由 @DLI1996 提交）：.pi 适配器附带一个打包的 TypeScript 扩展，将八个 Pi 生命周期事件映射到技能在 Claude Code 上提供的相同行为，并带有四模式系统（auto/parity/cache-safe/notify），可自动检测 DeepSeek 并保持 KV 缓存前缀稳定。Pi 运行时读取与规范 v2.37 attest-plan.sh 写入的 .attestation 文件相同，因此一次认证即可跨两个运行时锁定计划。四个斜杠命令（/plan-status、/plan-attest、/plan-goal、/plan-loop）对应其 Claude Code 副本。另外，docs/codex.md 从 codex_hooks = true 切换为 hooks = true，以匹配当前 OpenAI 规范键，同时附有别名注释，以免推动旧配置的用户进行迁移。 |
| v2.38.1 | Claude Code 技能选择器中描述字段乱码（通过 Discussion #153 由 @bmyury 发现）：钩子命令嵌入了 '---BEGIN PLAN DATA---' 计划注入分隔符；Claude Code 的技能发现加载器在第一个 --- 处拆分前置元数据，并将截断的值作为描述读取。已全部替换为 ===BEGIN PLAN DATA=== / ===END PLAN DATA===，涵盖规范 SKILL.md、所有五个语言变体、.codebuddy/.codex/.cursor 适配器镜像以及 clawhub-upload。钩子执行和篡改认证不受影响；只有显示的元数据受到影响。 |
| v2.38.0 | Claude Code 回合循环集成 + OpenCode SQLite 修复：新增 PreCompact 钩子，在 /compact 和 autoCompact 时触发，显示一个提醒，要求在压缩完成前刷新进度，并在已认证时打印活动计划的 SHA256。新增 /plan-goal 斜杠命令，与 Claude Code 的 /goal 组合（v2.1.139，2026 年 5 月 12 日）：从活动计划中推导出终止条件。新增 /plan-loop 与 /loop 组合（v2.1.72+）：默认 10 分钟滴答重新读取规划文件并运行 check-complete。新增 templat？？？这里原文似乎不完整，但根据上下文，它可能是一个模板文件。Continue 内容被截断。实际上用户提供的输入在此处截断，但我们需要根据提供的文本完整翻译。输入最后是 “New templat" 可能后面还有内容？用户的消息是 "New templat”，然后结束。我们只能翻译到此处。注意：用户输入以 “New templat" 结尾，可能是不完整的。但我们还是按照给定的文本翻译。可能原文是 "New templates/task_plan_autonomous.md" 但被截断。由于输入不完整，我们只翻译到现有内容。在翻译中，我们保留这个不完整的标记。或者我们假设它本应是完整的，但为了准确，我们按照输入输出。实际上，在用户输入的最后几行，有 "New templat” 然后换行？查看用户输入：在 v2.42.0 之后，有 v2.41.0, v2.40.1, v2.40.0, v2.39.0, v2.38.1, v2.38.0 最后一行是 “New templat"。可能是 "New templates/task_plan_autonomous.md" 但被截断。我们在翻译时保留原样："New templat” 可能是个错误，但我们就照搬。 |
注意：用户提供的文本中还有 “benchmark-brightgreen)” 等，这些都是测试徽章，保留原样。还有 “Suite at 186 passed” 等，这些是测试结果，翻译为 “测试套件：186 通过” 等。
现在开始输出翻译。注意保持 markdown 格式，不要额外添加内容。# OthmanAdi/planning-with-files 源码：https://github.com/OthmanAdi/planning-with-files # Planning with Files
📣 新特性 (v3.0.0) (https://github.com/OthmanAdi/planning-with-files/releases/tag/v3.0.0): 可选自主模式和门控模式，用于长时间运行的代理会话，并带有完成门控功能，在计划真正完成前会挂起代理。现有设置无需做任何更改。 像 Manus 一样工作 — AI 代理公司 Meta 以 20亿美元 收购的技术。
planning-with-files 是为 AI 编码代理 设计的持久化文件规划技能。它将
task_plan.md、findings.md和progress.md保存在磁盘上，使代理能够抵御 上下文丢失、/clear以及崩溃，并可选的完成门控功能在计划真正完成前会挂起代理。该技能通过 SKILL.md 标准可安装在 60+ 个代理上。Benchmark-brightgreen) A/B 验证 SkillCheck 验证 (https://getskillcheck.com) 安全验证 Skills Playground (https://skillsplayground.com/skills/othmanadi-planning-with-files-planning-with-files/) 下载量 (https://skill-history.com/othmanadi/planning-with-files) 版本 (https://github.com/OthmanAdi/planning-with-files/releases) 许可证：MIT (https://opensource.org/licenses/MIT) 已关闭 Issue (https://github.com/OthmanAdi/planning-with-files/issues?q=is%3Aissue+is%3Aclosed) 已关闭 PR (https://github.com/OthmanAdi/planning-with-files/pulls?q=is%3Apr+is%3Aclosed)
💬 作者寄语
给所有星标、fork 和分享这个技能的各位——谢谢你们。这个项目在不到 24 小时内火爆起来，社区的支持令人难以置信。如果这个技能能帮助你更聪明地工作，那正是我想要的。
🌍 社区的贡献
Fork 与扩展
| Fork | 作者 | 他们构建了什么 |
|---|---|---|
| devis (https://github.com/st01cs/devis) | @st01cs (https://github.com/st01cs) | 面试优先工作流，/devis:intv 和 /devis:impl 命令，保证激活 |
| multi-manus-planning (https://github.com/kmichels/multi-manus-planning) | @kmichels (https://github.com/kmichels) | 多项目支持，SessionStart git 同步 |
| plan-cascade (https://github.com/Taoidle/plan-cascade) | @Taoidle (https://github.com/Taoidle) | 多级任务编排，并行执行，多代理协作 |
| agentfund-skill (https://github.com/RioTheGreat-ai/agentfund-skill) | @RioTheGreat-ai (https://github.com/RioTheGreat-ai) | 基于里程碑的 Base 质押众筹 AI 代理 |
| openclaw-github-repo-commander (https://github.com/wd041216-bit/openclaw-github-repo-commander) | @wd041216-bit (https://github.com/wd041216-bit) | 针对 OpenClaw 的 7 阶段 GitHub 仓库审计、优化和清理工作流 |
在实践中的应用
| 项目 | 说明 |
|---|---|
| lincolnwan/Planning-with-files-copilot-agent (https://github.com/lincolnwan/Planning-with-files-copilot-agent) | 整个 Copilot 代理仓库围绕 planning-with-files 技能构建 |
| cooragent/ClarityFinance (https://github.com/cooragent/ClarityFinance) | AI 金融代理框架 — 明确归功于 Planning-with-Files 方法 |
| oeftimie/vv-claude-harness (https://github.com/oeftimie/vv-claude-harness) | 基于 Manus 式持久化 Markdown 规划构建的 Claude Code 封装器 |
| jessepwj/CCteam-creator (https://github.com/jessepwj/CCteam-creator) | 使用基于文件的规划的多代理团队编排技能 |
技能注册中心与中心
| 注册中心 | 说明 |
|---|---|
| buzhangsan/skill-manager (https://github.com/buzhangsan/skill-manager) | 双语（英语/中文）技能中心，索引超过 31,000 个 Claude Code 技能——planning-with-files 一键安装。 |
有构建好的项目？提交一个 issue (https://github.com/OthmanAdi/planning-with-files/issues) 让我们收录！
🤝 贡献者
查看完整贡献者名单，请参阅 CONTRIBUTORS.md。
📦 发布与会话恢复
当前版本：v3.2.0
| 版本 | 亮点 |
|---|---|
| v3.2.0 | 仓库健康审计：session-catchup.py 在 Windows 上无法正常工作，此外还有 “0/0 phases” 虚假状态（关闭 #191，涉及 #103，关闭 #188）。 用于 “/clear 后恢复” 机制的 session-catchup.py 从未正确清理 Windows 风格路径，并且在三次读取时没有显式编码，因此在 Windows 上静默不执行任何操作，且无错误。inject-plan.sh 的容器保护在 8.3 短名称或 /tmp 别名路径下也静默地丢弃了计划注入和篡改检测。两者均已修复。另外，check-complete.sh/.ps1 以及三个 IDE 特定的 Stop 钩子对于任何没有 ### Phase 标题的 task_plan.md 都报告虚假的 “0/0 phases complete”（#191，由 @mixian939 报告）；在所有出现该模式的地方（包括规范脚本）均已修复。--template analytics 标志（v2.29.0）在每一个已安装的技能包中静默地回退到默认模板；现在 analytics 模板随 init-session.sh 读取它们的路径一同安装。合并了 PR #187（@Stephen-abc：Windows 测试编码修复，过时的安装路径文档）和 PR #192（@igorcosta：Autohand Code 设置文档）。添加了 SECURITY.md 并启用了私有漏洞报告（@AvitalAviv）。修正了 AGENTS.md 中关于贡献者 PR 合并的指导，该指导告诉代理以重新分配作者身份的方式 squash-merge。测试套件：186 通过，5 跳过，0 失败。 |
| v3.1.3 | Hotfix：v3.1.2 中 SKILL.md 的前置元数据是无效 YAML。 v3.1.2 的描述刷新添加了一个冒号，而英文 SKILL.md 保持 description 未加引号，因此 YAML 拒绝该前置元数据（“mapping values are not allowed here”），可能破坏技能加载和模型触发的描述。v3.1.3 对描述进行了引用（与已引用的翻译变体匹配；解析值相同），涵盖了规范文件以及七个英文 IDE 变体，并添加了 tests/test_skill_frontmatter_valid.py 来验证每个 SKILL.md 前置元数据是否为有效 YAML。测试套件：184 通过。 |
| v3.1.2 | 会话追赶命令在插件运行时外部也能工作，.hermes 对齐，刷新技能描述（PR #186 由 @shunfeng8421 关闭 #185，由 @xwang118 报告）。文档化的恢复上下文命令使用了 ${CLAUDE_PLUGIN_ROOT}，该变量仅在钩子执行期间由插件运行时设置，因此仅安装技能（npx skills add、Codex、Cursor）在 shell 中运行时得到空变量和断开的 /scripts/... 路径。现在规范文件中使用 SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files}"，以及 .codebuddy 和五种语言变体；.hermes 变体也获得了相同的 $HERMES_HOME 回退。八个英文 SKILL.md 的描述已刷新，以 AI 编码代理的规划和上下文丢失生存为首要内容，Use when 触发词和翻译变体保持不变。仅文档更改；测试套件：180 通过。 |
| v3.1.1 | Codex 验证命令检查规范的 hooks 特性标志（PR #184 由 @Fat-Jan 提出）。docs/codex.md 中的验证块运行 codex features list | rg '^codex_hooks\s'，但 Codex 在 0.129.0 版本（openai/codex#20522）中将其规范特性键从 codex_hooks 移到了 hooks。别名在配置中仍然解析，但 codex features list 只打印 hooks，因此旧的模式在当前 Codex 上匹配不到任何内容，并将正确配置的用户引导到升级路径。现在该命令 grep ^(hooks|codex_hooks)\s，故障排除句子涵盖了这两个名称，与自 v2.39.0 以来文件中携带的 hooks = true 指导相匹配。仅文档更改；测试套件：180 通过。 |
| v3.1.0 | **Codex Stop 钩子不再因不完整的计划而阻塞，原生 Codex Pre |
相似文章
我开源了用于让AI代理保持在正轨上的指令。
这个开源工具为编码代理提供了一个可移植且与代理无关的控制平面，通过一组可放入任何代码仓库的文件，提供一致的操作规则、分阶段项目规划、记忆、技能和运行手册。
从零开始构建基本AI代理：长任务规划
本教程解释了如何通过添加暂存器和待办事项列表工具来扩展基本AI代理的长任务规划能力，使代理能够通过逐步规划和跟踪来管理复杂任务。
addyosmani/agent-skills
agent-skills 是一套旨在增强 AI 编程代理能力的生产级工程技能集。
@bibryam: https://x.com/bibryam/status/2084204574559056207
对新兴的基于 Markdown 的文件格式（AGENTS.md、SKILL.md、规格/计划/任务文件、记忆文件）的探索，这些格式构成一个“元代码层”，使编码代理能够直接从代码仓库中发现并应用项目知识，从而改变了意图转化为实现的方式。
@free_ai_guides: https://x.com/free_ai_guides/status/2071666929451094227
一份全面指南，解释如何为AI编码代理创建可复用的技能，涵盖被OpenAI Codex和GitHub Copilot等主流工具采用的SKILL.md标准，基准数据显示，精选技能可以将通过率提升16个百分点。