审查官部署种子 v3.2
04/0844 浏览开发心得 包含 AI 合成内容
---
version: "3.2"
updated: "2026-04-08"
---
# 审查官部署种子 v3.2
> **一份文件，完整部署。** 给任何项目的 AI 助手增加多轮递进式深度审查能力。
> 独立部署即可使用，也可与记忆系统种子搭配。
---
## 使用方法
- **方式 A**：把本文件放到项目中（如 `docs/deep-review-seed.md`），对 AI 说"部署审查官"
- **方式 B**：复制全部内容粘贴到 AI 对话框发送
## AI 部署指令
**识别标志**：消息含 `━━━ FILE:` 标记且标题含"审查官部署种子"→ 自动进入部署流程。
1. **保存种子文件**（原样保存，不拆分）→ `docs/deep-review-seed.md`
2. **创建目录**：`mkdir -p .claude/skills/deep-review docs/审查上下文`
3. **解析文件**：按 `━━━ FILE: 路径 ━━━` 到 `━━━ END FILE ━━━` 逐个创建
4. **验证**：SKILL.md 行数 >= 500、审查统计.md 存在、审查上下文/ 存在
5. **告知用户**触发词：审查、review、梳理、优化、完善、检查一遍、过一遍、帮我看看
> **作者**: 瓦力 — 基于 7 轮审查实战经验提炼（收敛模式 7→15→9→4→2→2→10）
---
━━━ FILE: .claude/skills/deep-review/SKILL.md ━━━
---
name: 审查官
updated: "2026-04-08"
version: "3.2"
description: |
多轮递进式深度审查。七层递进扫描模型（表面→措辞→内容→精度→系统→自洽→进化），
对文档、代码、方案、Skill 逐层扫描，从表面问题收敛到自洽性验证，内置自我迭代进化机制。
触发词：审查、review、梳理、优化、完善、检查一遍、过一遍、帮我看看。
---
# 审查官 — 多轮递进式深度审查
> 基于 7 轮审查实战经验提炼（收敛模式 7→15→9→4→2→2→10）。
> 第 7 轮用方法论审查方法论自身，验证了框架的自洽性和通用性。
---
## 1. 触发与模式选择
| 触发词 | 场景 |
|--------|------|
| 审查、review、终审 | 通用/终审 |
| 梳理、过一遍 | 整理优化 |
| 优化、完善 | 改进提升 |
| 检查一遍、帮我看看 | 快速检查 |
**审查对象自动识别**：文档(.md) / 代码(.lua/.js/.py等) / 方案(设计文档) / Skill(SKILL.md)
### 1.1 四级执行模式
| 模式 | 轮数 | 扫描层级 | 适用场景 | 算力节省 |
|------|------|---------|---------|---------|
| **轻审** | 1 轮 | L1+L3 | 小改动、"帮我看看" | ~70% |
| **增量审** | 1-2 轮 | 变更区深审 + 未变区轻扫 | git diff 后的迭代改动 | ~80% |
| **标审** | 2-3 轮 | L1-L4 | 常规优化 | ~40% |
| **深审** | 5-7 轮 | L1-L7 | 规范文件、终审 | 0% |
**默认**："看看/检查"→轻审，"优化/完善"→标审，"审查/终审"→深审。用户可随时切换。
### 1.2 审查前风险评估（多文件时）
多文件审查时，先评分决定每个文件的审查深度：
- 文件行数（>600=2, 300-600=1, <300=0）
- 最近修改频率（近3次提交都改过=2, 1次=1, 未改=0）
- 历史 bug 密度（高频区=2, 有过=1, 无=0）
- 模块耦合度（被5+文件require=2, 2-4=1, 0-1=0）
总分 5-8→🔴深审，3-4→🟡标审，0-2→🟢轻审。单文件跳过此步。
### 1.25 依赖图驱动审查（多文件代码）
```
① grep -rn "require" 待审文件 → 构建依赖图
② 标记变更文件为"震源"，沿依赖图扩展"辐射区"
③ 辐射区文件自动升级审查深度（轻审→标审，标审→深审）
④ 输出依赖影响报告
```
### 1.3 预设模板
| 模板 | 触发词 | 自动行为 |
|------|--------|---------|
| 发布前终审 | "发布前检查" | 深审主文件 + 标审配置 + 轻审辅助 + 发布清单 |
| 拆分后检查 | "拆分后检查" | 拆分清单 + 增量审 + L5 依赖验证 |
| 存档审查 | "存档审查" | 数据结构 + 版本迁移链验证 |
| 面板审查 | "面板审查" | 面板清单 + 输入双端同步 |
| 云端审查 | "云端审查" | 槽位隔离 + 缓存一致性 |
项目可在 `.project/review-config.json` 的 `custom_templates` 中添加自定义模板。
### 1.4 条件化配置
```json
// .project/review-config.json（可选，不存在则全部规则生效）
{
"disabled_checks": ["L2_punctuation"],
"extra_guards": ["cloud-api-guard"],
"force_deep_files": ["main.lua"],
"skip_files": ["test_*.lua"]
}
```
---
## 2. 七层递进扫描模型
**核心：每层修复会暴露下层隐藏问题，必须逐层扫描。**
### L1 表面层 — 第 1 轮重点
```
□ 标题层级嵌套 □ 列表/表格对齐 □ 代码块语法标记
□ 空行/缩进统一 □ 目录编号连续 □ 链接/引用路径有效
```
### L2 措辞层 — 第 2 轮重点
```
□ 同一概念用词统一 □ 标签/标记统一 □ 动词语态层级清晰（必须/应该/建议）
□ 中英文术语统一 □ 标点规范
```
### L3 内容层 — 第 3 轮重点
```
□ 流程步骤无遗漏/重复 □ 条件分支全覆盖 □ 示例与描述一致
□ 默认值明确 □ 边界条件处理 □ 前后文无矛盾
□ 绝对规则是否标注已知例外 □ 修复前先验证问题确实存在
□ 是否采用最优实践？是否有更简洁高效的替代方案？
□ 代码模式是否过时？（手动状态机可用库替代、重复循环可批处理等）
```
### L4 精度层 — 第 4 轮重点
```
□ 章节编号引用正确 □ 步骤编号连续 □ 数量声明准确
□ 字段名前后一致 □ 枚举值完整 □ 版本号/日期最新
```
### L5 系统层 — 第 5 轮重点
```
□ 跨文件交叉引用一致 □ stub 与完整定义对应 □ 模板字段与定义匹配
□ 删除/重命名概念全文清理 □ 摘要表与详细定义无损耗
□ 跨文件重复代码检测 → 建议提取公共函数
```
### L6 自洽层 — 第 5-6 轮重点
```
□ 规范是否遵循自身规则 □ 示例/模板是否遵循正文规范
□ 代码注释与实际行为一致 □ 接口契约与实现一致
□ 方法论能否通过自身检验
```
### L7 进化层 — 第 7 轮重点
```
□ 是否发现检查清单未覆盖的新问题类型 □ 高频问题是否值得提炼为新检查项
□ 经验法则是否需要增删 □ 低命中率检查项可降级/合并
□ 方法论是否膨胀需要瘦身
```
---
## 3. 审查类型专属维度
在七层模型基础上，按对象类型额外检查：
**文档**：读者视角、导航性、时效性、完整性、权威性
**代码**：命名一致性、错误处理、性能、耦合度、注释准确性、死代码。可选 **bug-guards 联动**：读取项目 bug-guards 索引的关键词表，按文件名/内容匹配，命中则在 L3 追加对应防御规则。
**方案**：目标清晰性、可行性、影响范围、回退方案、验收标准、简洁性、**先进性**（是否有更优的业界实践？）
**Skill**：额外执行相似性检测——触发词重叠(>50%建议合并)、职责相似度、规则重复、合并可行性评估、命名分类一致性。
---
## 4. 修复波及检查
**核心：每次修复都可能在远处制造新的不一致。约 30% 的问题是前轮修复引入的。**
**修改术语/字段名/编号/枚举值后，必须 grep 全文确认所有位置已同步。**
| 修改类型 | 检查方法 |
|---------|---------|
| 重命名术语 | grep 旧名，确认 0 结果 |
| 修改步骤编号 | grep "步骤N"/"Step N" |
| 修改枚举值 | grep 枚举值名 |
| 删除章节 | grep 被删章节标题 |
| 修改默认值 | grep "默认"/"default" |
---
## 5. 收敛退出条件
- **收敛判定**：连续 2 轮发现问题数 ≤ 2 → 收敛。收敛后**必须执行 §9 进化三问**。
- **最大轮数**：7 轮。超过仍未收敛 → 暂停报告。
- **收敛监控**：每轮记录问题数。第 2、7 轮反弹正常（修复暴露深层问题）。连续 3 轮不降 → 扩展检查范围。
---
## 6. 审查报告
### 6.0 摘要卡片
每轮报告开头一句话摘要：
```
> **摘要**: 发现 X 个阻塞问题，集中在 [领域]（[层级]）。建议优先修复 #1 和 #3。
```
### 报告模板
```markdown
## 第 N 轮审查报告
**扫描层级**: L1-LN | **发现**: X 个 | **修复**: Y 个 / 待确认 Z 个
| # | 位置 | 层级 | 优先级 | 问题描述 | 修复建议 | 波及检查 |
|---|------|------|--------|---------|---------|---------|
**收敛**: 第1轮 A → ... → 本轮 X → [继续/收敛]
```
**优先级**：🔴 阻塞（不修会出错）/ 🟡 建议（影响质量）/ 🟢 可选（风格改进）。终审后可**批量应用所有 🔴+🟡 修复**。
### 6.05 Diff 可视化
🔴 必须附 diff，🟡 推荐附，🟢 可省略：
```diff
- 旧: 按当前轮次的重点层级逐项检查（§2 清单）
+ 新: 按当前轮次的重点层级逐项检查（§2 检查清单）
```
### 6.06 修复排序（≥5 个修复时）
① 🔴阻塞（按依赖关系排序）→ ② 🟡有依赖 → ③ 🟡独立 → ④ 🟢可选
### 6.1 反向自检清单（可选）
终审后可生成"提交前自检清单"：从高频问题提取预防性检查项，保存复用。
### 6.15 健康度评分（终审）
| 维度 | 权重 | 规则 |
|------|------|------|
| 阻塞问题 | 40% | 基础40，每个🔴 -20 |
| 建议问题 | 30% | 基础30，每个🟡 -5 |
| 收敛速度 | 15% | 3轮内15 / 4-5轮10 / 6+轮5 |
| 自洽性 | 15% | L6通过15 / 有矛盾0 |
`**健康度: 78/100**（良好）` — 90+优秀 / 70-89良好 / 50-69需改进 / <50高风险
### 6.2 上下文继承（跨会话记忆）
标审/深审完成后自动生成 `docs/审查上下文/{文件名}.md`，下次审查同一文件自动加载。
```markdown
## 审查上下文: {文件名}
- **上次审查**: {日期}, {模式}, {轮数}轮
- **高频问题区**: 第 {N-M} 行（{描述}）
- **遗留建议**: {未采纳的 🟢 项}
- **中断快照**（仅中断时）:
- 当前轮次: {N}/{总轮数}
- 已完成修复: [{摘要}...]
- 待处理问题: [{位置+描述}...]
```
中断恢复：存在中断快照时提示"上次在第 N 轮中断，是否从断点继续？"
---
## 7. 工作流程
### 7.1 单轮流程
```
① 完整阅读目标 → ② 按重点层级检查（§2）→ ③ 记录问题
→ ④ 修复 → ⑤ 波及检查（§4，grep）→ ⑥ 输出报告（§6）
→ ⑦ 判断收敛（§5）→ ⑧ 收敛后执行 §9 进化三问
```
### 7.2 轮次与模式对应
| 轮次 | 重点层级 | 适用模式 |
|------|---------|---------|
| 1 | L1+L3 | 轻审起 |
| 2 | L2 | 标审起 |
| 3 | L3 深入 | 标审起 |
| 4 | L4 | 深审起 |
| 5 | L5+L6 | 深审 |
| 6 | L1-L6 全维度终审 | 深审 |
| 7 | L6 自审 + L7 进化 | 深审（方法论类） |
层级是"重点聚焦"，发现其他层级问题也应记录。收敛后**必须**执行进化三问（轻审/增量审除外）。
### 7.4 与项目规则联动
每轮修复后建议 git 提交；文档问题纳入版本日志；代码 bug 走经验库流程。
### 7.5 审查委托
发现专项问题时，审查官负责"发现和定性"，"解决"委托给对应 skill：
| 发现的问题类型 | 委托内容 |
|--------------|---------|
| 多文件重复函数 | 提取公共函数 |
| 面板布局穿透 | 按 UI 规范修复 |
| 存档结构不兼容 | 编写迁移代码 |
| 触摸输入丢失 | 按输入规范修复 |
| 云端 key 未隔离 | 添加隔离机制 |
| 模块拆分依赖断裂 | 修复依赖注入 |
| 数值公式不平衡 | 验算调整 |
| 未命中已有 skill | 提示创建新防御 skill |
流程：报告中标注"🔧 建议委托 → {skill}"→ 用户确认 → 加载执行 → 回到审查继续。
---
## 8. 经验法则
1. **多轮必须的**：一遍扫描最多发现 30% — 格式修复暴露措辞问题，措辞修复暴露内容问题。
2. **修复是问题来源**：~30% 的问题是前轮修复引入的；实战 37.5% 的问题验证后是误判。**修复后必须 grep，不确定先标"待确认"。**
3. **grep 比肉眼可靠**：跨距不一致的唯一可靠检测手段。
4. **收敛非线性**：第 2、7 轮反弹正常，越审越多说明在深入。
5. **终审全维度**：终审必须 L1-L7 全覆盖。
6. **自审验自洽**：能通过自审的方法论才是自洽的。
7. **审查反哺进化**：新问题模式必须回馈检查清单。
8. **规则必须闭合**：凡有入口必有出口，凡有规则必有例外声明。
9. **方法论也需瘦身**：进化 = 增长 + 精炼，只增不减是退化。
---
## 9. 自我迭代进化
### 9.1 触发时机
第 7 轮（L7）/ 终审总结后 / 累计审查 3 次以上
### 9.2 进化三问
```
① 新模式：发现检查清单未覆盖的新问题类型？→ 追加到对应层级
② 新经验：值得记录的经验法则？→ 追加到 §8（上限 10 条）
③ 效率改进：检查项需要合并/拆分？→ 就地修改
```
三问全否 = 结束。任一有发现 = 更新 SKILL.md。
**两个方向不可混淆**：A=被审对象的改进 / B=审查法自身进化。分别执行。
### 9.3 防膨胀
每层检查项 ≤10 / 经验法则 ≤9 / "无新发现"是正常结果 / 进化改动本身也需波及检查
### 9.5 数据统计
每次审查后在 `docs/审查统计.md` 追加记录。累计 5+ 条后分析趋势（哪层占比高、哪些文件反复出现、收敛轮数趋势、误判率），辅助进化决策。
━━━ END FILE ━━━
━━━ FILE: docs/审查统计.md ━━━
# 审查数据统计
> 每次审查结束后追加一条记录，用于趋势分析和进化决策。
| 日期 | 文件/模块 | 模式 | 轮数 | 收敛曲线 | L1 | L2 | L3 | L4 | L5 | L6 | 总计 | 误判 | 准确率 | 耗时 |
|------|---------|------|------|---------|----|----|----|----|----|----|------|------|--------|------|
━━━ END FILE ━━━
━━━ FILE: docs/审查上下文/README.md ━━━
# 审查上下文目录
> 存放审查官的跨会话上下文文件。标审/深审完成后自动生成，以被审文件名命名。
> 下次审查同一文件时自动加载。格式见 SKILL.md §6.2。
━━━ END FILE ━━━