出海助手-代码评审
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9c953624/yimubiao-code-review。
技能介绍
要解决什么问题
合并前的一次 PR,往往要同时回答两件事:改动有没有踩项目自己的规范,以及改动有没有把 issue / PRD 里写明的需求做对。只盯 lint 或只读需求文档,很容易让其中一条轴被另一条「盖住」——规范全过但功能偏了,或功能对齐但命名与结构一团糟。
本技能面向「从用户指定的基准点(commit、分支、HEAD~5 等)到当前 HEAD 的 git diff」做系统化评审,输出可读性、正确性、风险与可执行的改进建议;中文说明侧重出海产品与跨团队协作场景,核心流程与 Matt Pocock 开源 code-review 一致。
技能如何工作
流程可概括为五步:
- 固定对比基点:解析你给出的 ref,用三点 diff(
git diff ...HEAD)抓取变更,并列出区间内的 commit;若 ref 无效或 diff 为空,在此阶段直接失败,避免子代理空转。 - 定位规格来源:按优先级从 commit message 中的 issue 引用(需
docs/agents/issue-tracker.md工作流)、用户传入路径、docs//specs//.scratch/下与分支匹配的 PRD,到向用户追问;若无规格,Spec 轴会明确报告「no spec available」。 - 收集规范来源:仓库内如
CODING_STANDARDS.md、CONTRIBUTING.md等;并始终附带 Fowler《Refactoring》第 3 章的 smell baseline(如 Feature Envy、Duplicated Code 等),且以仓库成文规范为准覆盖 baseline,工具已强制项则跳过。 - 并行子代理:Standards 与 Spec 各跑一条 general-purpose 子代理(上下文隔离),分别产出不超过约 400 字的报告;Standards 区分「违反成文规范」与「启发式 code smell」;Spec 对照规格列缺失、范围蔓延与实现可疑点,并引用规格原文。
- 汇总呈现:在
## Standards与## Spec下分别展示,不合并、不重排两条轴的结论;文末给各轴 findings 数量及该轴内最严重问题的一行摘要。
适用边界与注意点
- 需要 Git 仓库与可解析的对比基点;issue 拉取依赖项目是否配置 issue tracker 文档与相应凭证。
- 涉及 Notion / Slack / GitHub 等第三方集成时,须按原版说明配置 API Key 或授权;本目录
scripts/、references/可离线支撑主流程。 - Spec 轴在找不到规格时仍会运行 Standards 轴;两条轴故意分离,避免「规范过关」掩盖「需求未实现」或相反。
使用场景
- 出海产品发版前,需对照 issue/PRD 检查当前分支相对 `main` 的 diff 是否漏需求或 scope creep
- 多人协作 PR 合并前,要从 `CONTRIBUTING.md` 与 Fowler smell 两路并行扫一遍变更 hunks
- commit 里写了 `Closes #123` 但不确定实现是否对齐工单,需拉规格并对照 diff 列缺失与实现疑点
- 跨时区团队 review:只需指定基准 commit 或 `HEAD~n`,由技能固定 diff 并输出 Standards / Spec 分轴报告
适合人员
- 负责出海 App/Web 发版的 tech lead,要在合入前确认 diff 既符合仓库规范又覆盖工单需求
- 维护 `CODING_STANDARDS.md` 的平台工程师,希望 PR review 自动引用成文规范并标注 Fowler 类启发式 smell
- 对接 GitHub/GitLab issue 流程的 full-stack 开发,习惯在 message 里写 `#issue`,需要 Spec 轴引用原文对照 diff
- 开源 fork 了 mattpocock/skills 的团队负责人,想用中文版说明在 WorkBuddy 里触发同一套双轴评审流程