SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场omc-plan

omc-plan

智能体与模型

查看项目

更新于 10-15 14:59

技能介绍

用途

omc-plan 是一个战略规划技能，核心目标是在编写代码之前先理解需求、收集信息并产出经过质量把关的计划，从而减少返工、范围蔓延和遗漏的边界情况。它适用于用户希望“先规划再实现”、需要为模糊想法做结构化需求收集、希望评审已有计划，或需要多视角共识的场景。

主要能力

模式选择

  • Interview（访谈）：宽泛请求的默认模式，进行交互式需求收集。
  • Direct（直接）：通过 --direct 触发，或请求已足够详细时跳过访谈，直接生成计划。
  • Consensus（共识）：通过 --consensus 或“ralplan”触发，运行 Planner → Architect → Critic 循环直至达成一致，采用 RALPLAN-DR 结构化审议（默认 short 模式，--deliberate 用于高风险场景），可加 --interactive 在草稿与批准步骤加入用户提示。
  • Review（评审）：通过 --review 或“review this plan”触发，对已有计划进行 Critic 评估。

访谈模式

对请求进行分类：宽泛（模糊动词、无具体文件、涉及 3 个以上领域）则触发访谈模式。使用 AskUserQuestion 一次只问一个聚焦问题，收集偏好、范围与约束。先通过 explore agent 收集代码库事实，再提出有依据的追问。每个问题基于上一个回答递进。咨询 Analyst（Opus）识别隐藏需求、边界情况与风险。当用户表示准备好时创建计划。

直接模式

可选进行简短的 Analyst 咨询，随后立即生成完整工作计划，可按需进行 Critic 评审。

共识模式

  • RALPLAN-DR 分为 Short（默认，有界结构）与 Deliberate（用于 --deliberate 或明确高风险请求）两种模式，均保持相同的 Planner → Architect → Critic 顺序与 AskUserQuestion 关卡。
  • 支持提供方覆盖（需已安装对应 CLI）：--architect codex 用外部架构评审替换 Claude Architect 环节；--critic codex 用外部评审替换 Claude Critic 环节。若请求的提供方不可用，会简要说明并继续使用默认 Claude 环节。
  • 状态生命周期：持久模式停止钩子使用 ralplan-state.json 在共识循环期间强制继续。进入时调用 state_write(mode="ralplan", active=true, session_id=...)。交接执行时调用 state_write(active=false)，此处不可用 state_clear，因为它会写入 30 秒取消信号，导致新启动的执行模式失去保护。真正终止退出（拒绝、非交互式计划输出、错误/中止）时调用 state_clear。中间步骤（如 Critic 批准或达到最大迭代展示）不得清除。
  • Planner 在 Architect 评审前创建初始计划与紧凑的 RALPLAN-DR 摘要，必须包含：原则（3-5 条）、决策驱动因素（前 3 项）、可行选项（≥2 个）及各自有界利弊；若仅剩一个可行选项，需给出被拒替代方案的明确失效理由。Deliberate 模式还需预演失败（3 个场景）与扩展测试计划（单元/集成/e2e/可观测性）。
  • 用户反馈（仅 --interactive）：用 AskUserQuestion 展示草稿计划及 RALPLAN-DR 摘要，选项包括：进入评审、请求修改、跳过评审直接进入最终批准。非交互式则自动进入评审。
  • Architect 使用 Task(subagent_type="oh-my-claudecode:architect") 评审架构合理性，必须包含对偏好选项的最强反方论证、至少一个有意义权衡张力，以及（如可能）综合路径。Deliberate 模式需明确标记原则违背。Architect 必须评估 Planner 产出的同一固定计划快照，不得修改，其输出不得传给 Critic。
  • Critic 使用 Task(subagent_type="oh-my-claudecode:critic") 按质量标准评估，必须验证原则-选项一致性、替代方案探索的公平性、风险缓解清晰度、可测试验收标准与具体验证步骤，并明确拒绝浅层替代方案、驱动因素矛盾、模糊风险或薄弱验证。Deliberate 模式必须拒绝缺失或薄弱的预演与扩展测试计划。Critic 独立评估同一固定快照，不得接收 Architect 评审。
  • 独立评审可并行或串行（视上下文而定）：当 Architect 与 Critic 均使用 Claude agent（默认）时可作为后台子代理并行；当任一使用外部提供方时必须串行，作为单独等待的 Task 调用，以防限流导致的兄弟级联失败。两者结果仅由 Planner 在双方评审完成后合并。
  • 重审循环（最多 5 次迭代）：Critic 拒绝时，收集 Architect 与 Critic 的反馈（仅 Planner 合并），交 Planner 修订，返回 Architect 与 Critic 重新评审，直至批准或达到 5 次。达到上限未批准则通过 AskUserQuestion 向用户展示最佳版本并说明未达成专家共识。
  • 应用改进：评审者批准并附改进建议时，合并所有被接受的改进到计划文件，最终共识输出必须包含 ADR 部分（决策、驱动因素、考虑过的替代方案、选择原因、后果、后续事项）。
  • Critic 批准后，计划状态标记为待批准，除非已获得明确执行批准。--interactive 时用 AskUserQuestion 展示选项：通过 team 批准执行（推荐，调用 Skill("oh-my-claudecode:team")）、通过 ralph 批准执行（调用 Skill("oh-my-claudecode:ralph")）、先压缩上下文再返回执行批准（调用 Skill("compact")）、请求修改、拒绝。非交互式则输出标记为待批准的最终计划，调用 state_clear 并停止，不自动执行。
  • 用户批准后（仅 --interactive）：在调用执行技能前调用 state_write(active=false)，不可用 state_clear。team 路径必须用已批准计划路径作为上下文调用 team 技能，不得直接实现；ralph 路径同理，不得在规划代理中编辑源代码文件。

评审模式

从 .omc/plans/ 读取计划文件，通过 Critic 评估，返回 APPROVED、REVISE（附具体反馈）或 REJECT（需重新规划）。

计划输出格式

每个计划包含：需求摘要、验收标准（可测试）、实现步骤（含文件引用）、风险与缓解、验证步骤。共识/ralplan 还包含 RALPLAN-DR 摘要与最终 ADR。Deliberate 共识模式包含预演（3 个场景）与扩展测试计划。计划保存至 .omc/plans/，草稿保存至 .omc/drafts/。

工具使用

  • 偏好类问题（范围、优先级、时间线、风险容忍度）用 AskUserQuestion 提供可点击 UI；需要具体数值的问题用纯文本。
  • 用 explore agent（Haiku，30 秒超时）在询问用户前收集代码库事实。
  • 大范围计划用 Task(subagent_type="oh-my-claudecode:planner") 做规划验证；用 analyst 做需求分析；用 critic 在共识与评审模式做计划评审。

适用场景

  • 用户希望在实现前先规划。
  • 为模糊想法做结构化需求收集。
  • 评审已有计划。
  • 需要多视角共识的高风险项目。
  • 任务宽泛或模糊，需要在写代码前明确范围。

限制与边界

  • 不适用于：需要自主端到端执行（应使用 autopilot）、任务明确想立即编码（应使用 ralph 或委托 executor）、可直接回答的简单问题、范围明显的单一聚焦修复（应使用执行技能）。
  • 规划/执行边界：规划模式只检查上下文并产出计划/规格/提案，必须将产物标记为待批准，除非用户在当前轮次或通过结构化批准 UI 明确选择执行。在明确执行批准前，规划模式不得运行变更型 shell 命令、编辑源文件、提交、推送、开 PR、调用执行技能或委托实现任务。
  • 目标工作流边界：当计划比较 Claude Code /goal、Ralph、Team 或仅产物的 Ultragoal 时，必须确定唯一的主循环权威，并使用确定性冲突策略 refuse、adopt_existing、artifact_only。/goal 事实必须仅引用 Claude Code/Anthropic 来源（Claude Code /goal 文档：https://code.claude.com/docs/en/goal；Anthropic Claude Code 变更日志：https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md），计划不得声称 /goal 评估器独立运行命令或读取文件，任何完成声明前需提供可见的证据。
  • 目标工作流文档目标：面向用户的比较示例应与 docs/shared/mode-selection-guide.md#goal-oriented-workflow-selection 和 docs/REFERENCE.md#goal-workflow-ux-goal-ralph-team-ultragoal 保持一致。

暂未提供

关于收费、价格、平台支持范围、具体效果指标等信息，资料中暂未提供。