用途
该技能用于把当前本地工作打成基线提交,然后在独立的 review worktree 中只针对这一提交做代码质量审查,最后将审查驱动的清理作为单独的重构提交落地。这样,功能改动与重构可分别审查,主检出目录也可在基线提交后立即释放。调用该技能即视为授权其在 monorepo 与 .source 中创建所需提交(基线提交,以及必要时的重构提交);不得对基线提交执行 amend 或 squash 合并。
子模块
.source 是独立的 git 仓库(packages-enterprise),enterprise/packages/*/src 通过符号链接指向其中,普通 git status 在 monorepo 中看不到它。暂存前需同时检查两者:git status --ignore-submodules=none、git -C .source status、git -C .source diff、git -C .source log --oneline -15。若 .source 中的改动属于本次工作,应先提交子模块,再提交 monorepo;monorepo 提交会包含 .source 的 gitlink。仅含 gitlink 的 monorepo 提交消息形如 chore(enterprise): bump submodule to <why>。该仓库设置了 diff.ignoreSubmodules=all,因此 git commit 与 lint-staged 看不到仅含 gitlink 的索引;此时应暂存 .source,并用 git -c diff.ignoreSubmodules=none commit 提交,不要修改 git config。审查目标应是包含代码的提交;仅移动 gitlink 的 monorepo 提交不是审查对象。子模块的 review worktree 与 monorepo 同级:git -C .source worktree add -b review/<branch>-<SOURCE_SHA:0:7> ../../review-source-<SOURCE_SHA:0:7> <SOURCE_SHA>。从 .source 落地该 worktree 时使用同样的快进合并与 git worktree remove;若落地后的 SHA 已越过 monorepo 中已提交的 gitlink,则追加第二次 monorepo bump,不得修改第一次 bump。
工作流程(共五步)
-
基线提交:先并行检查(含 .source),查看 git status --ignore-submodules=none、git diff(已暂存与未暂存)、git log --oneline -15 以了解提交消息风格。仅暂存内聚的改动:用户已暂存则提交已暂存文件,否则暂存相关的已修改文件,排除无关的本地修改。使用仓库约定的提交风格 type(scope): concise why,scope 可为 dashboard、api-service、worker、shared 等,消息使用 HEREDOC。提交时 lint-staged 与 biome check --write 会运行并可能自动格式化暂存文件,提交仍会成功;若钩子失败,应修复后新建提交,绝不 --amend。提交后立即用 git rev-parse HEAD 捕获 BASE_SHA,这是唯一的审查目标。
-
切换到 review worktree:提交后立即把审查、分诊修改与重构提交移出主检出目录,使其空出用于其他工作。此处不使用 nv-worktree-create,单条轻量命令即可:git worktree add -b review/<branch>-<BASE_SHA:0:7> ../review-<BASE_SHA:0:7> <BASE_SHA>。此后所有命令与文件编辑都在 worktree 路径内进行,直到第 5 步前不得触碰主检出目录。若 worktree 路径已存在,则中止并改为在原处审查。
-
仅针对 BASE_SHA 的 thermo-nuclear 审查:先用 git show <BASE_SHA> --stat 与 git show <BASE_SHA> 收集确切范围,然后启动一个 thermo-nuclear-code-quality-review 子代理(Task 工具,readonly: true,前台运行以便处理结果)。子代理提示词需强调:只审查该提交改动的行,可读取完整文件作为上下文,但每条发现必须指向该提交引入或修改的行,不得报告既有代码或更大分支的问题;提供完整仓库路径、被审提交 SHA 与标题、改动文件清单以及提交 diff。重点关注 AI slop、冗余或死代码、重复逻辑、不必要的抽象或 props、倒置或令人困惑的布尔命名,以及状态管理异味(冗余状态与派生值、effect 误用、过期闭包或依赖数组问题)。每条发现需给出文件、该提交中的具体符号或行、严重级别、为何是问题以及具体的最小修复方案,并区分必须修复与可选修复,跳过不影响正确性或可维护性的琐碎建议。子代理不得修改文件,只返回发现。
-
分诊、修复与重构提交(在 worktree 中):删除前先验证,用 Grep 确认每个死代码或冗余判断(调用点、setter、其他调用者),不要盲信审查结论。以保持行为不变的方式应用必须修复与高价值发现;对有意为之或低价值发现暂缓处理,并向用户说明原因。分诊期间不得扩大范围或添加功能。编辑后对每个改动文件执行 ReadLints,重命名后 Grep 检查过期标识符;仅在必要时修复既有 lint。只暂存分诊触碰的文件并新建提交,绝不 amend BASE_SHA,消息形如 refactor(<scope>): <what was removed/renamed and why>。用 git log --oneline -3 确认历史中先是 BASE_SHA,然后是重构提交。
-
回到原分支并清理:在主检出目录中把原分支快进到 review 分支,然后移除 worktree:git merge --ff-only review/<branch>-<BASE_SHA:0:7>、git worktree remove ../review-<BASE_SHA:0:7>、git branch -d review/<branch>-<BASE_SHA:0:7>。若 --ff-only 失败,说明审查期间原分支已移动,不得强制操作,应报告分歧并保留 review 分支交由用户协调。
约束
基线提交与重构提交必须保持独立,绝不 squash 或对基线执行 --amend;审查只针对单个基线提交,绝不审查整个分支;若审查未发现值得修复的问题,跳过第 4 步,第 5 步只移除 worktree 与分支(无需合并)并报告结果干净;除非用户要求,否则不 push、不创建 PR。
相关技能
thermo-nuclear-code-quality-review(第 3 步使用的审查标准)、deslop(从 diff 中移除 AI slop)、nv-worktree-commands(轻量 worktree 设置需要调试时的命令参考)、novu-prepare-pr(完整实现后 PR 准备)。