核心用法
review-orchestrator 是一款面向代码审查与质量保障的 Agentic Skill,通过统一接口协调多种审查视角和认知模式。
主要功能模块:
| 命令 | 功能 |
|------|------|
| `/ro select` | 基于上下文和风险等级智能推荐审查类型 |
| `/ro twin` / `/ro multi` | 技术视角 + 创意视角双轨并行审查 |
| `/ro cognitive` | 分析器/架构师/实现者三模式深度分析 |
| `/ro gate` | 分阶段质量门禁,阻断不达标变更 |
双视角审查(Twin Review):技术视角聚焦架构、标准、安全;创意视角关注用户体验、表达清晰度、理念一致性。两者互补,N=2 的覆盖度显著优于单点审查。
认知模式(Cognitive Modes):
- Analyzer — 识别冲突、张力、 trade-offs
- Architect — 重构建议、架构优化
- Implementer — 具体实施路径、复杂度评估
质量门禁:支持测试通过性、覆盖率阈值、文档完整性等多维度检查,失败时提供明确的修复指引。
---
显著优点
1. 系统性覆盖盲区:多视角设计专门针对"单一审查者盲点"问题,实证表明双视角能发现更多潜在问题
2. 风险自适应:/ro select 根据变更上下文自动识别风险等级(低/中/高),匹配审查深度
3. 零外部依赖:纯提示编排型 Skill,不调用任何外部 API,完全在 Agent 信任边界内运行
4. 可配置化:认知模式、质量门禁阈值、测试命令均通过 YAML 灵活配置
5. 审查资产化:所有审查结果自动归档至 docs/reviews/,便于追溯和知识沉淀
---
潜在局限
- 模型能力依赖:审查质量受限于底层 Agent 模型的分析深度,非专业领域(如特定安全漏洞)可能遗漏
- 无强制执行:质量门禁结果为建议性质,需团队自律遵循
- 配置门槛:首次使用需配置
.openclaw/review-orchestrator.yaml,对新手不够即开即用 - 中文支持有限:部分提示前缀为英文,双语团队可能需要本地化调整
---
适合人群
| 场景 | 推荐用法 |
|------|---------|
| 个人开发者 | `/ro twin` 快速自检,避免"写完即提交"的疏漏 |
| 技术负责人 | `/ro cognitive --modes architect` 把控架构债务 |
| 代码审查员 | `/ro select` 决定审查深度,标准化审查流程 |
| 质量工程师 | `/ro gate` 集成到 CI 前置检查 |
---
常规风险
| 风险类型 | 说明 | 缓解措施 |
|----------|------|---------|
| 误报/漏报 | AI 审查可能过度敏感或遗漏真正问题 | 关键安全变更需人工复核,不替代专业安全审计 |
| 配置泄露 | YAML 配置含项目结构信息 | 配置文件位于项目内部,不对外暴露 |
| 审查疲劳 | 多视角输出可能信息过载 | 按需选择 `--technical-only` 或 `--creative-only` 精简输出 |
| 路径遍历 | 需确保 `target` 参数不超出工作区 | 依赖 `context-verifier` 依赖项进行文件校验 |
该 Skill 由 Live Neon 维护,采用 MIT 协议开源。