1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | plan-arbiter-builderio-skills |
| 作者/维护者 | BuilderIO（Builder.io 官方组织账号） |
| 来源链接 | https://github.com/BuilderIO/skills/tree/main/skills/plan-arbiter |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 3,941（数据来自 GitHub API，为 BuilderIO/skills 整个合集仓库的星数，非本技能单独热度） |
| Forks | 197（数据来自 GitHub API） |
| 最新版本 | 无正式版本标签，采滚动发布（数据来自 GitHub API：仓库未使用 Release/Tag 机制） |
| 安装方式 | npx @agent-native/skills@latest add --skill plan-arbiter |
2. 功能介绍与亮点
Plan Arbiter 是“多 agent 竞争性方案仲裁”技能：当 Codex、Claude Code 等多个 agent 各自针对同一任务产出方案后，它负责收集、归一化、交叉评审这些方案，最终产出一份可执行的决策备忘录，而不是把多份方案简单拼接成一份含糊的“大杂烩”。
核心亮点：
- 五步工作流：收集方案 → 归一化为可比较的条款（目标、假设、涉及文件/接口、实现顺序、验证策略、回滚方案、成本复杂度） → 交叉评审 → 裁决（采纳/融合/打回重做） → 产出结构化决策备忘录。
- 多来源输入：支持粘贴文本、本地文件、会话 ID、transcript 路径、PR、评论、visual-plan 链接等多种方案来源，并尽量还原原始产出物以捕捉可能在摘要中丢失的假设。
- 明确的裁决优先级：正确性与需求契合度 > 是否扎根真实代码/文档/测试 > 更简单的首版实现 > 更好的验证与回滚方案 > 执行成本，避免仅凭“哪份写得更漂亮”做决定。
- 结构化产出模板：决策备忘录固定包含决策、理由、执行计划、从落选方案中借鉴的部分、被拒绝的想法及理由、验证方式、执行者建议七个字段，便于人类快速复核。
- 附带 Codex 专属触发配置（
agents/openai.yaml），可在 Codex 中以$plan-arbiter直接调用。
3. 适用场景
所属分类：元技能与 Agent 增强（作用对象是“agent 产出的方案”本身，属于约束/编排 agent 协作行为的元层能力，而非某个具体技术领域的产出物）。
面向同时使用多个 coding agent（如让 Codex 与 Claude Code 分别出一版方案）、需要有人对两份方案做交叉评审并拍板执行方向的用户；对独立开发者或小团队负责人尤其实用——不必自己逐条比对两份方案的假设与风险，也不必凭直觉选择听哪个 agent 的。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持标准 SKILL.md 格式。
- Codex：✅ 原生支持，附带
agents/openai.yaml声明专属显示名称与触发提示词。 - OpenClaw / Hermes Agent：❓ 未见专门适配材料，未验证。
5. 推荐理由
把多个 agent 各自产出的竞争方案交叉评审并合并为一份可执行决策
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 BuilderIO 为知名无头 CMS/可视化搭建平台厂商（Builder.io 产品），另开发 Qwik 前端框架，在开发者工具领域具备广泛认知度，本技能为其官方出品；所属合集仓库整体 3,941 星不代表该子技能自身热度，未查得该子技能自身的独立第三方讨论证据 |
| 可用性 | 9 | 一条 npx 命令即可安装；SKILL.md 与 README 文档完整，含五步工作流、裁决优先级与结构化产出模板等具体示例；无付费依赖；本技能文件最近一次实质性提交为 2026 年 6 月中旬 |
| 安全性 | 9 | 技能目录仅含 SKILL.md、README.md 与一个 224 字节的 Codex 显示配置文件，不含任何可执行脚本，纯提示词/工作流类技能；不涉及网络外发或私有数据传输；无需任何 API Key 或凭据；License 明确（MIT）；发布方为可审计的官方开源组织 |
安全检查清单逐项结果：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无——不含任何可执行脚本 |
| ② 联网外发数据 | 无——仅在用户已提供的方案文本/文件/会话之间做交叉评审，不主动外发数据 |
| ③ API Key/凭据 | 不需要 |
| ④ 可疑指令（prompt injection 迹象） | 未发现，全部内容为方案评审工作流指导 |
| ⑤ 作者/组织信誉 | BuilderIO 官方组织账号，公开可查，无造假迹象 |
| ⑥ License | 明确（MIT） |
| ⑦ 最近维护时间 | 本技能文件最近一次实质性提交为 2026 年 6 月中旬 |
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| Plow Ahead（同仓库姊妹技能） | 约束 agent 在遇到常规模糊性时不要停下来提问，而是记录假设、持续推进直到真正的阻塞点 | 作用于单个 agent 的“要不要停下来问”决策，不涉及比较多份已产出的方案 |
| Efficient Frontier（同仓库姊妹技能） | 多子 agent 委派编排方法论——把判断类工作留给前沿模型，重复劳动外包给便宜子 agent | 关注任务分派阶段“该用哪个模型执行”，不处理已产出方案之间的交叉裁决 |
| 通用多 agent 协作框架（如 BMAD-METHOD 一类的方法论集合） | 提供一整套角色分工、文档模板与协作流程，覆盖从需求到交付的全过程 | 范围更广、更偏方法论体系，未针对“两份既成方案如何取舍”这一具体环节做结构化模板 |
三者中，Plow Ahead 与 Efficient Frontier 分别覆盖“单 agent 该不该停下来”与“该派给谁做”，本技能补上的是“多个 agent 各自交完卷之后该听谁的”这一环。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
技能目录内附带一个 224 字节的 agents/openai.yaml 文件，为 Codex 提供专属显示名称与默认触发提示词，是仓库内为数不多明确声明双 agent 适配的技能之一。
10. 安装使用方式
npx @agent-native/skills@latest add --skill plan-arbiter安装后无需重启终端；当用户提出“比较这两份方案”“让 Codex 和 Claude 各出一版方案再选一个”等诉求时会被触发，也可显式要求手动调用。
11. 注意事项
- 仅在存在两份或以上可比较方案时才有意义，只有一份方案且无实质性备选时应跳过本技能。
- 裁决质量依赖于原始方案本身的完整度；若方案已被压缩为摘要、丢失了关键假设，产出的决策备忘录也会连带受限。
- OpenClaw、Hermes 适配未经验证，建议先做小范围测试。