# Doc Reviewer

> 审查技术文档。支持四种独立评审类型：大纲评审（检查目录与结构逻辑）、内容评审（检查文字准确性与代码质量）、资产评审（校验链接与引用合规）、格式评审（校对纯视觉排版与标点），审查后可按需调用 humanizer-zh 去除 AI 写作痕迹。仅在用户请求审查或修正 Markdown 文档时使用，纯去 AI 化请求请交给 humanizer-zh。

- Skill: `forceinjection/doc-reviewer` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add forceinjection/doc-reviewer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/forceinjection/doc-reviewer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: ForceInjection (https://skillmd.com/u/forceinjection)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/forceinjection/doc-reviewer

---


> English version: [SKILL-en.md](SKILL-en.md)

# 文档评审

本文档定义了技术文档评审的标准操作规范和检查清单。为了提高评审效率并减少大模型的注意力分散（Attention Dilution），文档评审被拆分为四种**独立的评审类型**。根据用户的需求，Agent 可以扮演专门的角色，使用对应的专属规则集进行单项审查。

---

## 1. 评审类型

Agent 在执行评审时，应根据用户的指令或文档的实际状态，选择以下某一种或多种类型独立执行。每种类型的评审都应作为一个独立的 Prompt 任务来处理，并输出独立的评审报告。

1. **大纲评审 (Outline Review)**
   - **角色**：结构架构师 (Structure Architect)
   - **动作**：仅提取文档的所有标题（TOC），对文档骨架进行全局审视。发现结构问题并提供重构建议。
2. **内容评审 (Content Review)**
   - **角色**：技术编辑 (Technical Editor)
   - **动作**：将文档按章节（或子小节）切块，逐个 Chunk 深度阅读。专注于文字质量、技术准确性和代码逻辑。
3. **资产与链接评审 (Assets & References Review)**
   - **角色**：合规与资产巡检员 (Compliance & Asset Inspector)
   - **动作**：提取所有超链接、图片路径、文件引用和参考文献进行批量检查。确保外部依赖有效且合规。
4. **格式评审 (Format Review)**
   - **角色**：排版校对员 (Typography Proofreader)
   - **动作**：对文本进行快速扫描，专注于纯粹的视觉排版和标点规范。此类问题通常支持静默/自动一键修正。
5. **去 AI 化处理 (AI-Slop Removal)**（可选）
   - **角色**：文字编辑 (Copy Editor)
   - **动作**：当用户明确要求"去 AI 化""去除 AI 痕迹""让文章更像人写的"时启用。调用 `humanizer-zh` 技能（通过 Skill 工具加载其 SKILL.md），按其中定义的 35 种 AI 写作特征（夸大的意义宣称、宣传语、AI 高频词、破折号滥用、三段式结构等）扫描并改写文本，将 AI 腔文本改写为自然的人类文风，且不改变原意、不虚构事实。建议在内容评审完成、用户确认问题清单之后执行。

---

## 2. 评审规则

Agent 在执行特定评审类型时，按需加载对应的详细规则文件：

- **大纲评审**：加载 `references/outline-review-rules.md`，关注章节安排的逻辑性与合理性。
- **内容评审**：加载 `references/content-review-rules.md`，关注文字质量、技术准确性和代码逻辑。
- **资产与链接评审**：加载 `references/assets-review-rules.md`，校验链接、图片、参考文献的有效性与合规性。
- **格式评审**：加载 `references/format-review-rules.md`，关注纯视觉排版与 Markdown 语法规范。
- **去 AI 化处理**：调用 `humanizer-zh` 技能（通过 Skill 工具），以其 SKILL.md 中的 35 种 AI 写作特征清单与改写规则为准。执行前询问用户目标文风（中性编辑 / 注入个性 / 最小改动）。

---

---

## 3. 评审输出格式

对于任何一种类型的评审，必须按以下标准格式输出评审报告：

```text
## 评审结果 - [评审类型名称]

### 发现的问题

1. **[类别] 行 XX / 第 N 节**：问题描述。
   - 建议：具体修改建议或重构示例。

### 总结

共发现 X 个问题。
```

---

## 4. 示例

**用户**："帮我进行内容评审，检查 `architecture.md` 的第 2 节。"

**Agent**：
（触发内容评审规则，加载技术编辑角色）

> **[内容评审]**
>
> ### 发现的问题
>
> 1. **[文字质量] 第 2 节 标题下**：缺少概述段落，直接进入了子小节。
>    - 建议：增加一段关于本节架构核心目标的介绍。
> 2. **[一致性] 行 32**：术语不一致，前文使用 "KV Cache"，此处为 "键值缓存"。
>    - 建议：统一替换为 "KV Cache"。
>
> ### 总结
>
> 共发现 2 个问题。是否需要我为您直接应用这些修改？

**用户**："评审完 `blog.md` 后，顺便帮我把它去 AI 化。"

**Agent**：
（先执行内容评审并输出评审报告，经用户确认问题清单后，通过 Skill 工具调用 `humanizer-zh`）
（加载 humanizer-zh，先询问目标文风，再按 35 种 AI 写作特征扫描并改写）

> **去 AI 化处理完成**
>
> - 移除 6 处 AI 高频词（"此外""彰显""赋能"等）
> - 拆解 2 处三段式排比
> - 删除 3 处破折号滥用
> - 保留全部事实、数据与链接，改写后共 1 处存疑表述已列出供您确认