核心用法
review-orchestrator(简称 /ro)是一套多视角代码审查协调系统,通过整合5个细粒度技能,提供统一的审查入口。支持四种子命令:
/ro select— 根据上下文和风险自动推荐审查类型/ro twin(或/ro multi)— 同时启动技术视角与创意视角双审查/ro cognitive— 启动认知模式分析(分析者、架构师、实现者三种视角)/ro gate— 质量门禁检查,控制阶段流转
技术视角聚焦架构、标准、模式与安全性;创意视角关注用户体验、沟通表达与理念一致性。认知模式则分别审视冲突张力、重构方案与具体实现路径。
配置与集成
通过 .openclaw/review-orchestrator.yaml 配置认知模式参数与质量门禁阈值。依赖 failure-memory 提供上下文、context-verifier 校验文件。审查结果自动写入 docs/reviews/ 目录,便于追溯与归档。
显著优点
1. 系统性盲区覆盖:N=2 显著优于 N=1,不同视角发现不同问题,降低关键缺陷漏检概率
2. 灵活适配场景:支持纯技术、纯创意、混合模式及认知深度分析,覆盖实现、架构、文档、安全等多元场景
3. 质量门禁自动化:可集成测试、覆盖率、文档更新等检查,实现阶段流转的自动化把控
4. 零外部依赖:纯指令型技能,不调用外部 API,数据始终在本地信任边界内
5. 可配置与可扩展:认知模式、质量阈值均可自定义,适配团队规范
潜在局限
- 执行依赖代理模型:审查质量受限于所配置模型的能力,非专业安全审计工具
- 配置门槛:复杂项目需理解认知模式接口与质量门禁参数,初期有一定学习成本
- 非实时协作:当前为代理内部协调,不支持多人实时协作审查
- 输出结构化但不强制执行:审查发现需人工确认与跟进,系统不自动修复
适合人群
- 追求代码质量的开发团队与个人开发者
- 需要进行架构决策评审的技术负责人
- 希望建立标准化审查流程的 DevOps/Platform 团队
- 重视文档与用户体验一致性的产品团队
常规风险
- 过度依赖自动化建议:认知模式提供的是分析视角,最终决策仍需人工判断
- 配置误用风险:错误的质量门禁阈值可能导致过度阻塞或漏检
- 模型幻觉传导:若底层模型产生幻觉,审查发现可能包含不准确信息
- 权限边界需确认:虽声明只访问指定路径,但仍需确保
docs/reviews/与配置文件权限正确
整体而言,这是设计精良的本地优先审查工具,适合纳入日常开发工作流,但不应替代专业安全审计或团队深度代码评审。