review · git:20261026.8d01e18 · 2026-10-26 · sha256 86c522d3bfc1a490

review git:20261026.8d01e18A

Immutable. This exact content never changes and is served at /api/v1/blob/86c522d3bfc1a490.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_ycz3y4mbjgqqrh6r/86c522d3bfc1a49014d36c886f8e7515b28c633f0d0dfcf7211b812f8f275fc6.json

Then /plugin install review@markdownregistry-ycz3y4mbjgqqrh6r in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: review
description: PR/代码结构化回顾(无 slash · REV-*)— 双轴清单;可委派 review agent(只读)
---

# review

**用这个**:`REV-*`、合并前结构化回顾、坏味道/复杂度扫读。**不是那个**:只跑 Bugbot/Security → 全局 `~/.cursor/skills-cursor/review`;安全深挖 → **security**;上线 7 维走查 → **delivery**;找根因修 bug → **debug**。

可委派 **review** agent(只读)。本 skill 管清单与输出格式。

## 双轴回顾(Standards · Spec)

分支 / PR / 自某 commit 起的变更,按**两轴**扫读(可并行 subagent,结果并排汇报):

| 轴 | 问什么 | 证据来源 |
|----|--------|----------|
| **Standards** | 是否符合**本仓**已文档化规范? | `rules/tech/*.mdc` · `.growing/learn/dev-conventions.md` · 同目录既有代码风格 |
| **Spec** | 是否满足** originating issue / PRD / plan Goal**? | PR 描述 · linked issue · `plan.md` Target · 验收命令 |

每轴输出:**通过 / 疑点 / Blocker** + `file:line` + 一句依据。两轴结论冲突时(规范过但偏离需求,或反之)标 **`Decision needed`**。

## 人类 reviewer 优先级

同一 diff 多问题时,**先报高影响、低噪声**(排序权重,非跳过清单):

1. **上下文与架构** — 方案是否契合模块边界与既有抽象;有无过度设计
2. **正确性与 bug** — 边界、失败路径、回归风险
3. **安全边角** — auth、注入、密钥、对外契约(触发时叠加 **security** · **api**)
4. **缺测试** — 行为变更无对应测试或验收命令
5. **风格与 nit** — 命名、格式、注释(最低优先,可合并为一条)

## 输出格式

严重度(Blocker / High / Medium / Low)· `file:line` · 发现 · 建议 · (可选)**轴**:Standards / Spec

## 结构化清单

### 范围

- [ ] 符合 PR / REV 描述;无 drive-by 重构
- [ ] 落点与 plan Target 一致(若有)

### 正确性

- [ ] 边界与失败路径清楚;无吞异常 / 空 catch
- [ ] 并发、幂等、空值等与域相关的陷阱已考虑(有则查)

### 安全 / API(触发再扫)

- [ ] 高风险 diff(auth、密钥、对外 API、注入面)→ 叠加 **security** · **api** skills
- [ ] 无硬编码密钥;对外契约变更有文档/兼容说明

### 可测性

- [ ] 行为变更有对应测试或明确验收命令
- [ ] 纯 UI/文案可注明「手工/delivery」覆盖

### 可维护性

- [ ] 命名与模块边界清晰
- [ ] 重复逻辑 / 过长函数 / 深嵌套
- [ ] 复杂度与注释匹配意图(非噪声注释)

### 交付叠加(可选)

- [ ] `REV-*` 含交付/上线 → 叠加 **delivery** 7 维(+ 可选 §8–§11)(只读)

## 文档预审(PRD / 原型 · 吸收自 SpaceZephyr/pm-skills)

**用这个**:PRD、原型、功能说明过评审会前。**不是那个**:代码 diff(上节双轴)· 上线走查(**delivery**)。

1. 定严格度:快速过筛 / 标准(默认)/ 上线前终审
2. 按 **`reference/doc-review-checklist.md`** 六视角 + 意见红线 + 三级风险
3. 输出判定(通过/有条件/不通过)+ 复评清单

用户说「帮我看看这个 PRD」「模拟评审会」→ 本节。写完 PRD 后预审 → 链 **plan** `doc-prd-enrich.md` 待确认项优先核对。

## SDD analyze(吸收自 github/spec-kit)

**用这个**:Greenfield/Brownfield 在 **implement 前**或 **plan** 拆 TASK 后。**不是那个**:PR 代码回顾(上节清单仍适用)。

对照三件套(路径见 `workflow.json` `sdd.specs_dir`):

| 检查 | 问什么 |
|------|--------|
| spec → plan | 每个用户故事/FR 在技术 plan 有落点?无孤儿需求? |
| plan → tasks | 每个技术决策有 task?无未覆盖的 contract/research 项? |
| tasks → spec | 每个 task 追溯到用户故事或 FR?无 scope 外 task? |
| 术语 | spec/plan/tasks 同一实体同名? |
| 验收 | TASK 验收列与 spec 验收场景、tasks checkpoint 一致? |

输出:Blocker / High / Medium · 工件路径 · 缺口 · 建议修复(回 **plan** 或 **run** 勿静默扩 scope)。

## 与 plan

- 纯回顾不写代码 → `REV-*`;`next-task` 跳过但 gate 仍适用编码任务
- 交付走查 REV → 输出含 **`Decision needed`** 的文档冲突项(见 **delivery**)