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**)