用途
code-review 是面向 Yakit 仓库的规范化代码审查技能。它针对一次代码改动(PR、分支对比或工作区未提交改动)按固定维度逐项审查,并强制执行类型检查与测试验证,最终产出一份结构固定的三块式报告。
主要能力
六维审查
根据改动内容触发对应维度:
- 代码逻辑:有源码改动时审查;
- TS 定义:有 ts/tsx 改动时审查;
- UI 引用与 Props:有组件或 props 改动时审查;
- CSS 样式:有样式文件或 tsx 内样式改动时审查;
- 依赖版本影响:仅当改动含 package.json 时审查;
- 配置项影响:仅当改动含配置文件时审查,配置文件包括 tsconfig、vite/vitest、electron-builder、GitHub workflows、scripts、cli、.env、husky、lint-staged 等;package.json 的 scripts 段改动同时触发维度 5 和 6。
无涉及的维度在汇总表中标为 N/A,不允许整行消失。维度 5、6 不可放宽。
强制验证
每次审查必做 tsc 类型检查与 vitest 测试验证。
- 工作区/分支模式:在当前工作目录执行。
- PR 模式:禁止在当前工作目录执行,须用 baseRefOid / headRefOid 分别 git fetch 并建立隔离 worktree,两处跑完全相同的命令;依赖未就绪则执行 yarn cli install,仍无法运行则标记为环境异常降级。
类型检查对改动所在子项目整体执行:app/renderer/src/main/ 与 app/renderer/engine-link-startup/ 分别执行 yarn type-check;仅 app/main/ 或不含 TS 子项目时跳过并注明原因。测试按与 CI 相同的三条规则选取相关用例(变更文件本身为测试文件、同目录 test 下存在同名测试、测试 import 了变更模块),并读用例与断言确认覆盖。
归因规则:head 失败且 base 同项失败视为基线遗留,不计为本 PR 的 P0;head 失败且 base 通过记为 P0;环境无法运行标记为验证环境异常,不得标 ✅。
测试用例缺失检查
需要用例的场景:新增/修改逻辑分支、纯工具函数、状态转换、复杂组件交互、bug 修复防回归。不需要的场景:纯样式、纯文案/i18n、类型声明、构建/CI 配置本身。需要但缺少覆盖改动逻辑的断言时记为 P1。
三块式报告
报告固定包含:
- 结果汇总:六维检查、tsc、vitest、测试用例缺失的逐项结果表,附正确/问题/警告统计;
- 明细解释:正确项、问题项(P0/P1,含文件:行号与修复建议)、警告项,每项固定两行格式;
- 合并结论:只能是「不通过」(任一 P0)、「需要修复」(无 P0 有 P1)、「可以合并」(仅警告或全部正确)三种。
报告先在对话中完整输出,写入本地文件前须取得用户授权。
使用方式
- 触发语义:如「review」「审查这个 PR / 当前分支」「对比 origin/master」「合并前检查」。
- 也可使用 /code-review 命令,可带参数,如 /code-review review PR 4198。
- 被其他 skill 调用时,已指定范围则直接执行,报告全文返回调用方,落盘仍须用户同意。
审查对象的确定优先级:含 PR 编号→PR 模式;含分支或基线→分支模式;外部 skill 已指定 diff 范围→直接采用;均无→询问用户(当前分支 vs origin/master,或工作区未提交改动)。PR 模式通过 gh pr view 与 gh pr diff 获取改动,gh 未安装或未登录则报错停止(本地分支恰好对应时可经确认后降级为分支模式)。分支模式使用 git diff 与 git log,基线默认 origin/master。文件超过 50 个时优先审源码/依赖/配置,样式与文案抽检并在报告开头说明覆盖度。
限制
本技能为只读审查:不改被审代码,不运行被审代码本体,仅允许执行 yarn type-check、yarn test:vitest --run 以及在临时 worktree 内 yarn cli install。tsc/vitest 未实际跑过时报告中不得标 ✅,不得编造结果。异步询问未获答复不算同意。具体使用环境要求、依赖版本等细节暂未提供。