Agent Skills
返回列表
💻

出海助手-代码评审

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 一致。

技能如何工作

流程可概括为五步:

  1. 固定对比基点:解析你给出的 ref,用三点 diff(git diff ...HEAD)抓取变更,并列出区间内的 commit;若 ref 无效或 diff 为空,在此阶段直接失败,避免子代理空转。
  2. 定位规格来源:按优先级从 commit message 中的 issue 引用(需 docs/agents/issue-tracker.md 工作流)、用户传入路径、docs/ / specs/ / .scratch/ 下与分支匹配的 PRD,到向用户追问;若无规格,Spec 轴会明确报告「no spec available」。
  3. 收集规范来源:仓库内如 CODING_STANDARDS.md、CONTRIBUTING.md 等;并始终附带 Fowler《Refactoring》第 3 章的 smell baseline(如 Feature Envy、Duplicated Code 等),且以仓库成文规范为准覆盖 baseline,工具已强制项则跳过。
  4. 并行子代理:Standards 与 Spec 各跑一条 general-purpose 子代理(上下文隔离),分别产出不超过约 400 字的报告;Standards 区分「违反成文规范」与「启发式 code smell」;Spec 对照规格列缺失、范围蔓延与实现可疑点,并引用规格原文。
  5. 汇总呈现:在 ## 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 里触发同一套双轴评审流程