# Code-Reviewer-Skill **Repository Path**: P1M0U/code-reviewer-skill ## Basic Information - **Project Name**: Code-Reviewer-Skill - **Description**: Agent Skills 规范的代码审查技能:PR 审查(八维度评分 + 行级评论回写 + 二次复审)、提交前自检、整库审计。agent 无关,Hermes / Claude Code / Codex 均可加载。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🔍 Code Review 一个技能,三种审查模式 — **提交前自检** / **PR diff 审查** / **整库审计**。模式由*审查对象*决定,不再由用户措辞决定。 > **v3.0.0 起**:原 `pr-review`、`code-audit` 两个技能已并入本技能,成为其中的 M2 与 M3 模式;跨轮次二次审查(原 `pr-revision-review`)成为 M2-R。旧技能名不再单独提供。 > > **v3.1.0 起**:正文改为 **agent 无关**写法——agent 专有工具名一律降级为「示例」,改按**能力槽**映射(`SKILL.md §0.5`)。任何遵循 Agent Skills 规范的 agent 都能直接加载;不具备子 agent 机制时,M1 自动降级为冷读自查并在结论中显式记录。 > **v3.2.0 起**:补齐门径检查(`node --check` 语法门、format/lint 门)、链式 PR 与 worktree 判据;同期并入 6 篇专题 —— 部署文档、移动端版式、WebView 嵌入、语音链路、合并与链式 PR、浏览器契约(外部 PR 性质甄别与 vendored 代码两篇随 v3.1.9–v3.1.15 系列先入)。 > **v3.3.0 起**:并入多轮实战审查判据 —— 限流/权益门禁、支付回调验签、AI 流式接口、版式算术与对比度、前端运行时取证、断言有效性(变异测试)、原子写与本地台账、账号标识与存储层契约等,新增 12 篇专题参考文件;同时补记写回通道、复审三档状态、评分算式与清理收口细则。 ## 🤖 支持的 Agent 本技能只依赖 **Agent Skills 开放规范**([agentskills.io/specification](https://agentskills.io/specification)): ``` 目录 code-review/ 内放 SKILL.md(目录名须与 frontmatter 的 name 一致) frontmatter 只用到 name + description(必填)+ license / compatibility(可选) 不使用 allowed-tools,不使用 metadata.hermes.*,无任何 agent 专有语法 正文 纯 markdown;细则放同目录 references/,只引用一层 辅助脚本 可选,放同目录 scripts/;缺失时正文按描述手工执行,不阻断流程 ``` 因此**任何实现了该规范的 agent 都能加载**,不需要为本技能做适配改造。 | 运行时 | 安装位置 | |--------|---------| | Hermes Agent | `~/.hermes/skills/`(也支持 `.hermes/skills/`、`.agents/skills/`) | | Claude Code | `~/.claude/skills/`(全局)或 `<项目>/.claude/skills/` | | 跨客户端互操作约定 | `~/.agents/skills/`(用户级)或 `<项目>/.agents/skills/`(项目级) | | 其它遵循该规范的 agent | 放进它自己的 skills 目录即可 | **运行期要求** ``` 必需 git + 网络访问 写回 需要 GitHub / Gitee token,通道任选其一:MCP → 平台 CLI(gh)→ REST(curl) 可选 环境变量 AGENT_NAME(回写署名用;未设置时用 agent 自身类型名,最后才 Nameless Agent) 不需要 子 agent 机制 —— M1 第 5 步在无子 agent 时降级为冷读自查(见 SKILL.md §0.5) 不需要 Hermes —— 本技能正文不依赖任何 Hermes 专有工具、路径或插件 ``` ## 🎯 三种模式 | 模式 | 审查对象 | 产出 | 细则文件 | |------|---------|------|---------| | **M1** 提交前自检 | 本地尚未提交的改动(`git diff --cached`) | 通过/不通过 + 自动修复,通过后以 `[verified]` 前缀提交 | `references/mode-pre-commit.md` | | **M2** PR diff 审查 | 别人发的 PR(GitHub / Gitee) | 八维度评分报告 + 合并建议 + 回写行级评论 | `SKILL.md §2` | | **M2-R** 二次复审 | 同一个 PR 的新 head | 逐条核对上一轮发现是否落实,重新评分 | `references/mode-revision.md` | | **M3** 整库审计 | 整个项目目录 | 四级分级的发现清单 + 逐条提 issue | `references/mode-audit.md` | ## 🔌 工作通道 按本机可达性从高到低选一条,MCP 不可用时**降级**而非跳过(工具名以本环境实际可用者为准): | 通道 | 何时用 | 参考 | |------|--------|------| | MCP(GitHub / Gitee) | shell 直连平台不通时的**首选**(独立进程自带连通性) | `references/github-mcp-review.md` | | `gh` CLI | 本机装了 `gh` 且已登录 | `references/gh-cli-rest-fallback.md` | | REST(`curl`) | 前两者都不可用,但有 token | `references/gh-cli-rest-fallback.md` | | Gitee REST | 目标是 Gitee 仓库(或走 Gitee MCP) | `references/shared-channels.md` | 通道不可用时的能力槽对照与降级规则见 `SKILL.md §0.5`。 ## 📦 安装 本仓库就是一个技能目录,仓库名(`code-reviewer-skill`)与技能名(`code-review`)不同,**克隆时显式指定目标目录名**: ```bash # Claude Code(全局) git clone https://gitee.com/P1M0U/code-reviewer-skill.git ~/.claude/skills/code-review # Hermes Agent git clone https://gitee.com/P1M0U/code-reviewer-skill.git ~/.hermes/skills/code-review # 跨客户端互操作约定 git clone https://gitee.com/P1M0U/code-reviewer-skill.git ~/.agents/skills/code-review ``` 已经手动放进 skills 目录、想改成可更新的 clone: ```bash cd ~/.hermes/skills # 换成你的目标位置 rm -rf code-review git clone https://gitee.com/P1M0U/code-reviewer-skill.git code-review ``` 更新:`cd /code-review && git pull`。 也可以直接把这句话发给你正在用的 agent(任意 agent 通用): > 请帮我安装 code-review skill:`git clone https://gitee.com/P1M0U/code-reviewer-skill.git <你的 skills 目录>/code-review`(目标目录名必须是 `code-review`,与 SKILL.md 的 `name` 一致),完成后读一遍 SKILL.md 确认能正常加载。 ## 🚀 使用 ``` # M1 提交前自检 提交前检查 commit / push / ship / verify # M2 PR 审查 帮我审查这个 PR:https://github.com/owner/repo/pull/123 这个 PR 能不能合并? # M2-R 二次复审 这个 PR 又改了一版,看看上次提的问题落实了没 二次审查 https://gitee.com/owner/repo/pulls/45 # M3 整库审计 检查一下 xx 项目有什么缺陷 / 可以优化的地方 审计项目结构(只审查,提 issue,不要改代码) ``` ## 📋 模式路由 ``` PR 链接? ├── 第一次审这个 PR → M2 └── 已审过、作者又推了新 commit → M2-R git diff --cached 有内容 / 「提交前检查」 → M1 指着一个项目目录问「有什么缺陷」 → M3 ``` ## ✅ 回写评论(M2 / M2-R,默认必须执行) - **触发**:存在任一写回通道(MCP / CLI / REST),审查发现 **INFO 及以上** - **GitHub**:提交一次 review(`event=COMMENT` + 行级 inline comments) - **Gitee**:汇总走 body,行级定位带 `path` / `position` 另发一条 - **回写后必须读回确认**(列 PR 评论)才能报「已发表」 - 只写评论,不创建 commit、不 push、不 merge - 对外写回一律署名 `Reviewed by ****`(见 `references/shared-signing.md`) - 工具名按本环境替换(`SKILL.md §0.5` 能力槽②) ## 📁 文件结构 ``` code-review/ ├── SKILL.md # 主技能:路由 + §0.5 能力槽 + 共享契约 + PR 主流程 ├── references/ │ ├── shared-signing.md # 署名协议(唯一副本) │ ├── shared-severity.md # 严重级映射 + 扣分制(唯一副本) │ ├── shared-channels.md # 通道 / token / 降级 / 清理(唯一副本) │ ├── mode-pre-commit.md # M1 细则 │ ├── mode-revision.md # M2-R 细则(含删除类改动核对清单) │ ├── mode-audit.md # M3 细则 │ ├── github-mcp-review.md # GitHub MCP 通道 + 11 条审查判断力 pitfall │ ├── gh-cli-rest-fallback.md # 无 MCP 时的 gh CLI / REST 命令手册 │ ├── pr-provenance-triage.md # 外部 PR 性质甄别(贡献 / 推广 / spam) │ ├── vendored-code-review.md # 第三方 vendored 代码专题核对 │ ├── merge-and-chained-pr-review.md # base ≠ 默认分支的链式 PR:拓扑、合并顺序、没丢内容 │ ├── browser-autofill-and-captcha.md # 浏览器契约改动(autocomplete / 验证码)源码级判定 │ ├── deployment-doc-pr-review.md # 部署/运维文档 PR:可核事实逐条 probe │ ├── mobile-layout-and-touch-review.md # 移动端版式与触控(无法渲染时按设计稿算) │ ├── android-webview-embed-review.md # WebView 嵌入第三方站点审查清单 │ ├── voice-and-asr-review.md # 语音/跟读链路(示范音 → ASR → 逐词比对) │ ├── auth-flow-review.md # 认证/限速/权益门禁(放行态 × 可写端点矩阵) │ ├── payment-gateway-review.md # 支付回调验签:验签字段 ≠ 入账字段 │ ├── ai-sdk-streaming-review.md # AI 流式接口:错误语义、开放中转、静默截断 │ ├── refactor-pr-review.md # 删模块/换后端:调用点反查与抛错翻译 │ ├── credential-url-plumbing-review.md # 凭据解析 + 可配置 endpoint 的信任级矩阵 │ ├── db-transaction-review.md # 事务 / 原子删除:一次性空库实跑与变异 │ ├── db-backend-migration-review.md # 换数据层(SQLite→MySQL/PG)方言坑 │ ├── test-efficacy-verification.md # 断言有效性:变异测试与空转形态 │ ├── layout-coordinate-review.md # 版式/坐标/对比度:算术审而非眼睛审 │ ├── frontend-runtime-verification.md # 前端运行时取证:水合、闪烁、打印媒体 │ ├── branding-rename-review.md # 改名/换品牌/fork 归属对账 │ ├── report-format-chat.md # 聊天汇报排版 │ ├── frontend-audit-methodology.md # 前端逐层检查清单 │ ├── backend-audit-methodology.md # 后端逐层检查清单 │ ├── findings-classification.md # 严重度分级细则与实例 │ └── name-availability-check.md # 包名可用性检查 ├── templates/ │ └── ai-sdk-stream-probe.test.ts # AI SDK 流式错误语义探针模板 ├── scripts/ │ ├── doc_move_check.py # 内容搬家类 PR 的双向核对(缺失 / 夹带 / 锚点) │ └── check-js-syntax.sh # 纯静态 JS 语法门(node --check,不递归;退出码 0/1/2/3) └── README.md ``` ## ⚠️ 铁律 - **永不执行合并**、永不 push、永不改他人代码(回写评论与 issue 除外) - **只执行选中模式的流程,不混用** - M3 默认纯审查:先给发现,等用户定范围 - 本地克隆与临时文件必须清理 - 不确定的问题标 `[待确认]`,不暴露敏感信息 - 缺能力槽时**显式降级并记录**,不静默跳过(见 `SKILL.md §0.5`) ## 🔄 从旧版本迁移 | 旧技能 | 现在 | |--------|------| | `pr-review` | 本技能 **M2**(PR diff 审查)与 **M2-R**(二次复审) | | `code-audit` | 本技能 **M3**(整库审计) | | `code-review`(≤ v1.2.0) | 本技能 **M1**(提交前自检) | | 旧 `references/pre-commit-verification.md` | `references/mode-pre-commit.md` | 迁移方式:删除旧目录,按上文重新安装本技能。 ```bash # Hermes Agent 的历史遗留路径(其它 agent 按自己的 skills 目录替换) rm -rf ~/.hermes/skills/pr-review ~/.hermes/skills/code-audit ~/.hermes/skills/software-development/code-audit ``` ## 📄 License MIT