用途
workflows-review 是一个代码审查命令,用于对 PR 或分支执行详尽的代码审查。它结合多智能体分析、ultra-thinking 深度思考以及 Git worktree 进行本地深度检查,定位为资深代码审查架构师,关注安全、性能、架构与质量保证。
主要能力
- 审查目标识别与准备:判断审查类型(PR 编号、GitHub URL、文件路径或当前分支),检查当前 git 分支;若已在目标分支则直接分析,若不同则提供使用 git-worktree 技能进行隔离审查的选项。通过 gh pr view --json 获取 PR 元数据(标题、正文、文件、关联 issue),并准备语言相关分析工具与安全扫描环境。
- 多智能体并行审查:读取项目根目录 compound-engineering.local.md,使用其中 YAML frontmatter 的 review_agents 配置,并将 markdown 正文中的审查上下文作为附加指令传给每个智能体。若无配置文件则调用 setup 技能创建。始终额外运行 agent-native-reviewer(验证新功能可被智能体访问)和 learnings-researcher(在 docs/solutions/ 中搜索相关历史问题)。
- 条件智能体:当 PR 涉及数据库迁移、schema.rb 或数据回填时,运行 schema-drift-detector(交叉比对 schema.rb 变更与迁移,捕捉无关变更)、data-migration-expert(验证硬编码映射与生产一致、检查孤立关联、验证双写模式)、deployment-verification-agent(生成含 SQL 验证查询的 Go/No-Go 部署清单)。触发条件包括 db/migrate/*.rb 或 db/schema.rb 文件、ID/枚举/映射列修改、数据回填脚本,或标题正文提及 migration、backfill、data transformation、ID mapping。
- Ultra-Thinking 深度分析:分阶段进行最大认知投入的思考,包括利益相关者视角分析(开发者、运维、终端用户、安全团队、业务)和场景探索(正常路径、无效输入、边界条件、并发访问、规模测试、网络问题、资源耗尽、安全攻击、数据损坏、级联失败)。
- 多角度审查:技术卓越、业务价值、风险管理、团队协作四个角度,并运行 code-simplicity-reviewer 评估代码简化与极简主义。
- 发现汇总与待办创建:所有发现必须通过 file-todos 技能立即存入 todos/ 目录,不先请求用户批准。按类型分类(安全、性能、架构、质量等),分配严重级别(P1 严重、P2 重要、P3 可选),去重并估算工作量。支持直接创建或并行子智能体创建两种方式。
- 汇总报告:输出审查目标、分支、发现总数与各级别数量、创建的待办文件列表、使用的审查智能体,以及后续步骤(处理 P1、分类待办、并行解决、跟踪进度)。
- 可选端到端测试:根据 PR 文件检测项目类型(iOS/macOS、Web 或混合),提供对应测试选项,如 /test-browser 或 /xcode-test,通过子智能体运行以保留主上下文。
使用方式
以命令形式调用,传入审查目标参数(PR 编号、GitHub URL、文件路径或留空表示当前分支)。工作流会依次执行目标确定与准备、加载审查智能体、并行审查、条件智能体、ultra-thinking 深度分析、多角度审查、发现汇总与待办创建、汇总报告,最后可选端到端测试。待办文件遵循命名约定 {issue_id}-{status}-{priority}-{description}.md,状态为 pending/ready/complete,优先级为 p1/p2/p3,并始终添加 code-review 标签。
适用场景
适用于需要对 PR 或分支进行系统性、多维度代码审查的工程团队,尤其适合涉及安全、性能、架构、数据库迁移等高风险变更的审查流程。
限制
- 受保护产物:docs/plans/.md 和 docs/solutions/.md 是复合工程流水线产物,任何审查智能体都不得将其标记为删除、移除或加入 gitignore;若被标记,在汇总时丢弃该发现。
- 所有 P1 严重发现必须在合并 PR 前解决。
- 依赖项目根目录的 compound-engineering.local.md 配置文件;若不存在需先通过 setup 技能创建。
- 条件智能体仅在 PR 匹配特定条件时运行。
- 端到端测试为可选项,且部分流程(如 OAuth、邮件、支付、Sign in with Apple、推送、IAP)需人工验证。