optim-plans

1. 基本信息

项目	内容	数据来源
名称	optim-plans	—
作者/维护者	Optim-Agent（个人开发者项目账号，非官方机构或组织）	GitHub API 实测
来源链接	https://github.com/Optim-Agent/optim-plans	—
许可证	MIT	GitHub API 实测
GitHub Stars / Forks	281 / 1	GitHub API 实测（2026-08-04）
最新版本	0.2.1（`.claude-plugin/plugin.json`）	仓库文件实测
安装方式	Claude Code：`claude plugin marketplace add` + `claude plugin install`；Codex：`codex plugin marketplace add` + `codex plugin add`	官方 README 实测

2. 功能介绍与亮点

一个面向 Claude Code 与 Codex 的“先计划、后动手”门禁插件：在改动仓库文件之前，先把用户的想法逼成一份经过评审的 Markdown 计划，并用不可绕过的执行门禁确保写操作只在人工批准之后才发生。

两环设计：规划-精炼环（把模糊需求逐轮追问成 PLAN_v1.md，再经 Reviewer/Criticizer 对抗式复核迭代出更稳的版本）与执行-验证环（清单式人工审批 → 执行者在受控 worktree 内干活 → 只读验证器复核 → 有限次数的安全重试 → 控制器复核并打检查点），两个环各自独立、可单独触发
硬性门禁：SKILL.md 用 <HARD-GATE> 明文规定——在计划通过精炼、且控制器记录下不可变的执行批准之前，除了控制器状态与 docs/optim-plans/ 目录下的计划文档，不允许写任何目标文件；这条约束写进指令正文本身，而非停留在文档建议层面
按改动量级选深度：mini-plan（1 个问题、可直接跳执行）到 huge-plan（≥10 个问题、强制 websearch、精炼轮次不设上限）五档可选，小改动不用陪跑重流程，大改动也不会被草草放行
状态落地在 Git 里：受控状态存在目标仓库的 .git/optim-plans/，公开可读的计划文档落在 docs/optim-plans/YYYY-MM-DD-主题/，语言、模型/努力档位等偏好可持久化，无需每次重新配置
无第三方运行依赖：THIRD-PARTY-NOTICES.md 明确“当前不携带任何第三方运行时依赖”，代码执行走标准库 subprocess（参数数组调用、非 shell 字符串拼接），不外联任何网络服务
仓库根目录同时提供 .claude-plugin/marketplace.json（单一插件条目）与 .codex-plugin 清单，Claude、Codex 各自的官方 Skill 徽章均挂在 README 顶部

3. 适用场景

固定分类：元技能与 Agent 增强

动手改代码前希望先经过评审计划、并在执行阶段获得门禁与验证的 Agentic coding 开发者；尤其适合改动范围不小、又担心 agent 一上来就直接改错文件的场景——无论是给 Claude Code 还是 Codex 用，装上后每次改动前都会先被问清楚要做什么，而不是悄悄开始写代码。

4. 跨 Agent 兼容性

Claude Code：原生支持——README 提供 claude plugin marketplace add / claude plugin install 完整命令，并挂有官方 Claude Skill 徽章
Codex：原生支持——README 单列 Codex 安装小节（codex plugin marketplace add / codex plugin add），并挂有官方 Codex Skill 徽章
OpenClaw：未验证——抓取材料未提及
Hermes Agent：未验证——抓取材料未提及

5. 推荐理由

双环设计把先问清楚需求和执行前必须获批写进 agent 编码流程

多数“先计划再写代码”的实践停留在提示词层面的自觉，agent 依然可能因为想当然而直接改错文件。optim-plans 把这条纪律做成了 SKILL.md 里的硬性门禁：想要 agent 动手，必须先让它把想法逼成一份经过对抗式复核的计划，再经人工显式批准执行门禁才会松开。对经常用 Claude Code / Codex 做中大型改动、又不放心 agent“想到哪改到哪”的初中级用户，这是一层可验证的安全带，而不只是一句“请先做计划”的系统提示词。

6. 评分

维度	分数	说明
受欢迎程度	6	281 stars／1 fork，作者为专为本项目新建的个人账号（无官方机构背书）；仓库创建仅约 12 天即积累到这一星数，短期增速较快
可用性	8	安装步骤清晰（插件市场注册 + install 两三条命令，非改代码才能跑通）；README 668 行 + 独立 docs/ 目录，示例完整；最近一次提交发生在数天前，维护活跃；无任何付费依赖
安全性	8	见下方安全检查清单
综合	7.33	三项均值

安全检查清单：

检查项	结果
① Shell 命令执行	执行阶段会调用 `git` 与目标仓库自身的构建/测试命令，但全部走 `subprocess` 参数数组调用（非 shell 字符串拼接，规避注入），且被 `<HARD-GATE>` 约束在人工批准执行之后才会发生，范围限定在当前受控 worktree 内
② 联网外发	核心控制器代码中未发现任何直接网络调用；仅在用户选择 `big-plan`/`huge-plan` 档位时会调用宿主 agent 自带的 websearch 能力做调研，不构成技能自身的隐蔽外联
③ API key/凭据	不需要任何 API key 或第三方账号，`THIRD-PARTY-NOTICES.md` 明确声明零第三方运行时依赖
④ 可疑指令	未发现可疑指令或混淆代码；相反，SKILL.md 正文本身即以强制性门禁语言限制 agent 的写权限，是偏防御性的设计
⑤ 作者信誉	作者账号创建于 2026-07-07，专为本项目新建，暂无更早期的历史声誉可查，但仓库内提交记录真实、持续（近两周内近 30 次提交），未见刷星或虚假宣传迹象
⑥ License	MIT，条款清晰
⑦ 维护时间	最近一次提交距报告发布仅数天，活跃维护中

7. 跟同类 Skills 相比的优势

技能	定位	差异化重点
optim-plans（本次推荐）	计划-精炼 + 执行-验证双环，硬性写权限门禁	唯一把“计划未获批不准动笔”做成 SKILL.md 内嵌硬性约束、且执行阶段自带只读验证器与有限重试的同类技能
planning-with-files	面向长任务的持久化文件式计划，支持 60+ agent	聚焦点不同：解决的是“会话中断/context 被压缩后计划丢失”的崩溃恢复问题，而非“执行前要不要门禁批准”
BMAD-METHOD	完整敏捷方法论框架，PM/架构师/开发/QA 等角色分工	更重量级，模拟整套敏捷团队协作流程；optim-plans 更轻量，专注“计划评审 + 执行门禁”这一个环节，不引入角色扮演体系
grill-me（mattpocock/skills 合集内子技能）	单轮追问式澄清需求范围	只做“问清楚”这一步，不涉及计划文档产出、对抗式复核或执行阶段门禁

核心差异化：同类“agent 编码规划”技能里，多数解决的是“计划写得全不全”“计划会不会丢”的问题，optim-plans 是少数把“计划没获批就不能动笔”做成机器可执行硬约束、且执行阶段自带独立验证器角色的一款。

8. 用户评价

该技能目前在第三方平台尚无具名用户评价：仓库创建约 12 天，暂无独立博客、论坛或社交媒体讨论；GitHub Issues 区尚无任何 issue。

9. 其他补充

仓库提供中文（简体/繁体）与英文的界面语言选项，通过 .git/optim-plans/config.json 的 language 字段持久化，首次运行会主动询问语言偏好；提交信息统一使用英文。CHANGELOG.md 显示项目自 0.1.0 起按周迭代，最近一个版本（0.2.1）新增了 search-and-plan 调研前置技能。

10. 安装使用方式

Claude Code：克隆仓库到本地后，在仓库根目录依次执行：
```
claude plugin validate --strict .
claude plugin marketplace add ./ --scope user
claude plugin install optim-plans@optim-plans-dev --scope user
```
安装后需重启 Claude Code 使插件生效；对话中输入 $optim-plans <你的需求> 即可触发
Codex：同样先克隆仓库，在仓库根目录执行：
```
codex plugin marketplace add .
codex plugin add optim-plans@optim-plans-dev
```
随后输入 $optim-plans <你的需求> 触发
首次触发若目标仓库尚未设置语言偏好，会先弹出语言选择问题；后续同一仓库内的计划交互会记住该选择
该插件暂未上架 Claude/Codex 官方插件市场索引，需要克隆仓库后本地注册开发版插件市场才能安装

11. 注意事项

安装路径目前是“克隆仓库 + 本地插件市场注册”，不是一条命令直接从公开市场安装，比部分已上架官方市场的技能多两三步设置
项目仅由单一个人开发者维护，账号历史较短（创建约 4 周），尚未形成长期可查的社区口碑，采用前建议先在小改动上试用观察门禁行为是否符合预期
OpenClaw、Hermes Agent 的兼容性官方未作声明，跨 agent 使用前建议自行验证 SKILL.md 是否能被目标 agent 正确加载
big-plan/huge-plan 档位要求宿主 agent 具备 websearch 能力，若目标环境未开启该能力会影响调研类计划的完整度