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

unified-review

编程与开发

查看项目

更新于 10-15 13:54

技能介绍

用途

Unified Review 是一个多领域审查编排技能，用于在单次流程中完成代码、架构、测试、安全等多个维度的审查。它根据代码库分析与上下文，智能选择并执行合适的审查技能，适合在发布前进行彻底审查。

主要能力

  • 自动检测与技能选择：根据文件扩展名与清单文件检测主要语言，分析 git 状态与 diff 判断变更范围，识别项目结构（monorepo、微服务、库），检测构建系统、测试框架与文档，并据此调度审查技能。
  • 技能选择矩阵：例如 Rust 文件触发 rust-review、bug-review、api-review；API 变更触发 api-review、architecture-review；测试文件触发 test-review、bug-review；Makefile/构建系统触发 makefile-review、architecture-review；数学算法触发 math-review、bug-review；架构文档/ADR 触发 architecture-review、api-review；默认触发 bug-review、test-review。
  • 并行执行：通过 Agent 工具并发派发所选技能，并维护一致的证据记录，通过 TodoWrite 跟踪进度。
  • 子代理隔离：要求一个视角不影响下一个视角的解读。可通过 Agent 工具在单次并行调用中派发全部所选代理，待全部返回后再读取；或使用 /pensive:unified-review 工作流（workflows/unified-review.js），由脚本持有结果，避免因先读某个阶段而产生锚定，且各维度验证可并行启动。
  • 结果整合：跨领域合并发现、识别跨领域模式、按影响与工作量排序、生成统一行动计划。
  • 积压捕获：对被分诊到积压的发现，运行 python3 scripts/deferred_capture.py --title "<finding title>" --source review --context "Review dimension: <dimension>. <finding description>" 进行保留，该操作在行动计划确定后自动运行。

使用方式

快速开始命令：

# 自动检测并运行合适的审查
/full-review

# 聚焦特定领域
/full-review api          # API 表面审查
/full-review architecture # 架构审查
/full-review bugs         # 缺陷排查
/full-review tests        # 测试套件审查
/full-review all          # 运行所有适用技能

验证方式：运行 pytest -v 验证测试通过。

审查模式包括：

  • 自动检测（默认）：基于代码库分析自动选择技能。
  • 聚焦模式：运行特定审查领域，如 /full-review api 仅运行 api-review。
  • 完整审查模式：/full-review all 执行所有检测到的技能。

工作流分为四步：分析仓库上下文、选择审查技能、执行审查、整合发现。

技能到代理类型的映射：bug-review、api-review、test-review 使用 pensive:code-reviewer；architecture-review 使用 pensive:architecture-reviewer；rust-review 使用 pensive:rust-auditor；code-refinement 使用 pensive:code-refiner；math-review、makefile-review、shell-review 使用 general-purpose 并指示其调用 Skill 工具。规则要求：不得将技能名称用作代理类型；当 pensive:code-reviewer 覆盖多个领域时，以合并范围派发一次；对无专用代理的技能使用 general-purpose。

适用场景

  • 开始完整代码审查
  • 审查跨多个领域的变更
  • 需要智能选择审查技能
  • 需要来自多种审查类型的集成报告
  • 合并大型功能分支之前

限制

  • 当已知具体审查类型时不应使用，例如应使用 bug-review、test-review，或仅关注架构时使用 architecture-review。
  • 工作流的子代理在 acceptEdits 权限模式下运行，无论会话权限模式如何，因此随附脚本将其提示范围限定为读取；它没有文件系统，返回的是经受住反驳的声明，而非工作证明证据，需在采取行动前复现。
  • 工作流仅在用户要求时运行，不会未经请求启动。
  • 若自动检测未能识别正确的审查技能，需显式指定模式（如 /full-review rust）。若集成失败，需检查 TodoWrite 日志可访问且证据文件已由各技能正确写入。

交付物

  • 执行摘要：整体代码库健康评估、需立即关注的关键问题、审查频率建议。
  • 领域特定报告：API 表面分析与一致性、架构与 ADR 对齐、测试覆盖缺口与改进、缺陷分析与安全发现、性能与可维护性建议。
  • 集成行动计划：按优先级排序的修复任务、跨领域依赖、指定负责人与目标日期、后续审查计划。

架构与退出标准

所有审查技能采用中心辐射架构与渐进式加载：每个技能有 modules/ 存放按需加载的领域细节；跨插件依赖包括 imbue:proof-of-work、imbue:diff-analysis/modules/risk-assessment-framework。这可将聚焦审查的 token 使用量减少 50-70%，同时保持完整能力。

退出标准：所有所选审查技能已执行、发现已合并并排序、行动计划已创建并明确归属、证据已按结构化输出格式记录。

支持模块包括：审查工作流核心（所有 pensive 审查的标准 5 步工作流模式）、输出格式模板（发现条目、严重性、行动项模板）、质量检查清单模式（审查前、分析、证据、交付物清单）。