← ClaudeAtlas

expert-reviewlisted

当用户要求"评审/看一下/检查/review/CR/审查代码"时触发。 MUST 对照变更提案评审代码,产出评审报告。 AI 自检 ≠ 专家评审:关键项目 MUST 引入人类评审。
structure-projects/structure-agent-rules · ★ 1 · AI & Automation · score 64
Install: claude install-skill structure-projects/structure-agent-rules
# 专家评审 > 对照变更提案评审代码,产出评审报告。 > ⚠️ **AI 自检 ≠ 专家评审**:关键项目 MUST 引入人类评审。 ## 前置条件(MUST 全部满足) 1. **编码已完成**:`changes/proposals/<current>/tasks.md` 所有任务勾选 2. **proposal 存在**:`changes/proposals/<current>/proposal.md` 存在 ## 评审维度(MUST 逐项检查) | 维度 | 检查点 | 通过标准 | |---|---|---| | **符合性** | 代码是否实现 proposal 所有目标 | 目标 100% 覆盖 | | **规范性** | 是否遵守 naming / architecture / 栈 rules | 无 MUST 违反 | | **测试覆盖** | 关键路径是否有测试 | 行覆盖 ≥ 80%,关键路径 100% | | **安全性** | SQL 注入 / XSS / 越权 / 敏感信息泄露 | 无 MUST 风险 | | **性能** | N+1 / 慢查询 / 内存泄漏 / 大数据量 | 无 P0 问题 | | **可读性** | 命名清晰 / 函数简短 / 注释充分 | 新人可读懂 | ## 严重等级分类 | 等级 | 说明 | 处理 | |---|---|---| | **MUST fix** | 违反红线、有安全/数据风险、不符合 proposal | 不解决 MUST NOT 提交 | | **SHOULD fix** | 不规范但不影响功能 | 建议修复;不修复需说明理由 | | **NIT** | 风格、个人偏好 | 可选修复 | ## 执行步骤 ### 第 1 步:读变更提案 ```bash cat changes/proposals/<current>/proposal.md cat changes/proposals/<current>/design.md # 如有 ``` ### 第 2 步:读 diff ```bash git diff develop...HEAD # 或 git diff master...HEAD # hotfix ``` ### 第 3 步:按维度逐项评审(TODO 阶段 3 填充详细 checklist) ### 第 4 步:产出评审报告 写入 `changes/proposals/<current>/review.md`,格式: ```markdown # 评审报告:<提案 ID> | 字段 | 值 | |---|---| | 评审日期 | YYYY-MM-DD | | 评审人 | <AI / 用户> | | 结论 | ✅ 通过 / ⚠️ 有条件通过 / ❌ 不通过 | ## MUST fix(必须修复) - [ ] <问题 1 + 位置 + 建议> ## SHOULD fix(建议修复) - [ ] <问题 1 + 位置 + 建议> ## NIT(可选) - [ ] <...> ## 评审意见 <总体评价 + 是否建议合并> ``` ## 产出物 - `changes/proposals/<current>/review.md` ## 完成标准 - 所有维度都评审过 - MUST fix 项已修复或明确不修复理由 - review.md 写入提案目录 ## 下一步 - 有 MUST fix → 回到 `codin