用途
workflows-review 是一个代码审查技能,定位为“资深代码审查架构师”,专长覆盖安全、性能、架构与质量保证。它用于对代码变更执行穷尽式审查:通过多智能体并行分析、深度思考(ultra-thinking)以及 Git worktree 进行深度本地检查,最终把发现整理为结构化待办与汇总报告。
主要能力
- 审查目标识别与准备:判断审查类型是 PR 编号(数字)、GitHub URL、文件路径(.md)还是当前分支;检查当前 git 分支;若已在 PR 分支则直接分析,若在其他分支则使用 git-worktree 做隔离分析;通过 gh pr view --json 获取 PR 元数据(标题、正文、文件、关联 issue);准备语言相关分析工具与安全扫描环境。
- 多智能体并行审查:并行启动多个子智能体,分别负责 Rails 惯例、DHH 风格 Rails 模式、Turbo(仅在用到时)、Git 历史分析、依赖调查、模式识别、架构、代码哲学、安全、性能、DevOps、数据完整性、智能体可访问性等方向。
- 条件触发智能体:仅当 PR 涉及数据库迁移(db/migrate/*.rb)、数据回填、ID/枚举/映射列修改、读写方式变更,或标题正文提及 migration、backfill、data transformation、ID mapping 时,才启动数据迁移专家(校验 ID 映射、检查值互换、验证回滚安全)与部署验证智能体(生成 Go/No-Go 清单与 SQL 验证查询)。
- 深度思考与多视角审查:从开发者、运维、终端用户、安全团队、业务等利益相关方视角评估;探索正常路径、无效输入、边界条件、并发、规模、网络故障、资源耗尽、安全攻击、数据损坏、级联失败等场景;并从技术卓越、业务价值、风险管理、团队协作等角度给出结论。
- 简化审查:调用代码简化审查子智能体,识别可简化点。
使用方式
- 确定审查目标并完成环境准备(当前分支、PR 元数据、分析工具、安全扫描环境)。
- 并行运行核心审查智能体,按条件运行迁移相关智能体。
- 进行 ultra-thinking 深度分析与多角度审查,并做简化审查。
- 汇总发现:按类型分类,标注严重级别(🔴 CRITICAL/P1、🟡 IMPORTANT/P2、🔵 NICE-TO-HAVE/P3),去重并估算工作量。
- 通过 file-todos 技能在 .opencode/todos/ 目录创建待办文件,命名格式为 {issue_id}-{status}-{priority}-{description}.md,status 取 pending/ready/complete,priority 取 p1/p2/p3,并统一添加 code-review 标签及 security、performance、architecture、rails、quality 等标签。发现达 15 条以上时可并行启动子智能体同时创建文件。
- 输出汇总报告,列出发现总数与各优先级数量、已创建的待办文件及后续步骤(优先处理 P1、分诊待办、用 @workflows/work 推进已批准的待办、更新状态跟踪进度)。
- 可选端到端测试:根据 PR 文件识别项目类型(iOS/macOS、Web、混合),提供 Playwright 浏览器测试或 Xcode 模拟器测试,或两者。
适用场景
- 对 GitHub PR 进行系统性、多维度审查后再合并。
- 对 Markdown 文档进行审阅。
- 需要在隔离环境中深入检查本地代码变更。
- 涉及数据库迁移或数据回填的高风险变更审查。
限制与前提
- 前置条件:已安装并认证 GitHub CLI(gh)的 Git 仓库;main/master 分支干净;具备创建 worktree 与访问仓库的权限;文档审查需提供 markdown 文件路径。
- 明确要求:任何 P1(CRITICAL)发现都必须在合并 PR 前解决。
- 审查智能体包含 Rails 与 Turbo 专项方向,其他技术栈的覆盖程度暂未提供说明。
- 关于收费、价格与平台支持范围,资料暂未提供。