核心用法
review-orchestrator 是一款指令级审查协调技能(disable-model-invocation: true),本身不直接调用 AI 模型,而是提供结构化提示与编排逻辑,由用户配置的 agent 执行实际审查。核心命令包括:
/ro select:根据上下文与风险等级智能推荐审查类型(twin/cognitive/code)/ro twin(或/ro multi):并行生成技术视角(架构、标准、安全)与创意视角(UX、沟通、理念契合)双重视角审查/ro cognitive:调用三种认知模式——analyzer(发现冲突与权衡)、architect(重构建议)、implementer(实现路径)/ro gate:质量门禁检查,验证测试通过、覆盖率、文档更新等条件
所有审查结果输出至 docs/reviews/ 目录,支持 YAML 配置自定义认知模式与门禁规则。
显著优点
1. 系统性缺陷发现:N=2 双重视角显著优于单轮审查,技术盲点与创意盲区互补
2. 零外部依赖:纯指令架构,无 API 调用、无数据外传、无供应商锁定
3. 高度可配置:认知模式、质量门禁、提示前缀均可通过 YAML 自定义
4. 工作流整合:与 failure-memory、context-verifier 集成,支持审查发现自动记录
5. 多语言通用:质量门禁支持 Node.js/Go/Python/Rust 等主流技术栈
潜在缺点与局限性
- 执行依赖宿主:需配合具备模型调用能力的 agent 使用,本身无法独立运行
- 配置复杂度:深度定制需维护
.openclaw/review-orchestrator.yaml,学习成本较高 - 无实时协作:不支持多人实时评审,仅生成结构化报告供人工或异步处理
- 模式抽象限制:analyzer/architect/implementer 为视角隐喻,非严格认知科学模型
适合人群
- 追求代码质量的独立开发者与小团队
- 需要标准化审查流程的 DevOps/平台工程团队
- 使用 Claude Code、OpenClaw 等 agentic 开发环境的用户
- 关注数据隐私、希望审查过程完全本地化的组织
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 配置误用 | YAML 配置错误导致审查模式失效 | 内置默认值,提供配置模板 |
| 路径遍历 | 需确保 `docs/reviews/` 与目标文件路径受控 | 严格遵循 metadata 声明的 workspace 范围 |
| 审查疲劳 | 多视角输出可能信息过载 | 支持 `--technical-only`/`--creative-only` 精简模式 |
| 门禁僵化 | 严格阈值可能阻碍合理重构 | `--allow-minor` 参数允许次要问题通过 |