核心用法
review-orchestrator 是一个纯指令型审查编排框架(disable-model-invocation: true),本身不调用 AI 模型,而是提供结构化的审查视角与提示模板,由用户配置的代理执行实际审查。通过 /ro 命令系列协调多种审查模式:
- `/ro select` —— 基于上下文×风险评估自动推荐审查类型
- `/ro twin`(`/ro multi`) —— 并行触发技术视角(架构、标准、安全)与创意视角(UX、沟通、理念对齐)
- `/ro cognitive` —— 多认知模式分析:analyzer(冲突识别)、architect(重构建议)、implementer(实现路径)
- `/ro gate` —— 质量门禁检查:测试通过、覆盖率阈值、关键发现清零、文档更新
审查结果输出至 docs/reviews/ 目录,支持结构化追溯。
显著优点
1. 系统性消除盲区:N=2 的多元视角设计,明确针对"单一审查视角必然遗漏问题"的认知盲区
2. 风险自适应:内置 context×risk 决策矩阵,自动匹配审查深度(低风险仅技术视角 / 高风险全模式叠加)
3. 零外部依赖:纯本地指令执行,无 API 调用、无数据外发、无网络请求,审查过程完全离线
4. 高度可配置:认知模式、质量门阈值、测试命令均可通过 .openclaw/review-orchestrator.yaml 自定义
5. 治理友好:输出结构化 Markdown,天然适配 failure-memory 进行观察记录与模式沉淀
潜在局限
- 非自动化执行:仅为"编排框架",实际审查依赖外部代理/模型执行,需人工触发或额外配置 agentic 调度
- 配置复杂度:多模式协同需理解 analyzer/architect/implementer 的分工逻辑,新用户存在认知门槛
- 无 IDE 集成:当前为 CLI/命令式交互,无编辑器内联提示或实时反馈
- 语言生态绑定:默认质量门配置偏向 Node.js(
npm test),其他语言需显式覆盖
适合人群
- 技术负责人 / 架构师:需要体系化把控代码审查质量,建立团队审查 SOP
- 高风险变更场景:金融、安全关键系统、核心基础设施的代码变更审查
- 多模式协作团队:技术严谨性与产品体验并重的跨职能团队
- 合规敏感环境:数据不可离境、不可调用外部 API 的内网开发环境
常规风险
| 风险项 | 说明 | 缓释措施 |
|--------|------|----------|
| 审查疲劳 | 多模式并行可能产生冗余建议 | 通过 `/ro select` 按需裁剪视角 |
| 配置漂移 | 本地 YAML 配置与团队标准不一致 | 建议纳入版本控制并 CI 校验 |
| 误报累积 | 低阈值质量门可能阻断必要重构 | 高风险场景启用 `--allow-minor` |
| 责任边界模糊 | 框架仅编排,不执行审查,输出质量依赖底层模型 | 明确团队 SLA,关键路径保留人工复核 |
> ⚠️ 重要:本技能不调用任何外部 AI 服务,所有"cognitive modes"均为分析视角的命名,非模型标识。审查执行完全依赖用户本地环境配置的代理。