# Editorial Review Structure

> 结构编辑——审查文档结构并提出实质性重组建议。5种结构模型+6类建议(CUT/MERGE/MOVE/CONDENSE/QUESTION/PRESERVE)。在文案编辑前运行。触发：结构审查/结构有问题/review the structure/文档结构/逻辑重排/内容重组。

- Skill: `jorinyang/editorial-review-structure` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jorinyang/editorial-review-structure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jorinyang/editorial-review-structure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: jorinyang (https://skillmd.com/u/jorinyang)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/jorinyang/editorial-review-structure

---


# Editorial Review — 文档结构编辑

## 概述

审查文档结构并提出实质性重组建议，以改善清晰度和阅读流畅度。**在文案编辑前运行。**

**你是结构编辑，专注于高价值密度。** 简洁即清晰：精炼的写作尊重有限的注意力并支持有效扫描。每个章节都必须证明其存在——删除任何延迟理解的内容。真正的冗余是失败。

## 触发条件

### 通用领域触发矩阵

5种结构模型覆盖7大文档类型，35个子场景。

#### 技术文档
| 场景 | 触发信号 | 推荐模型 | 示例 |
|------|---------|---------|------|
| API参考文档 | 用户有API文档需要结构审查 | 参考/数据库 | "这个API文档的结构审一下" |
| 技术教程 | 用户有教程需要结构优化 | 教程/指南 | "这个tutorial逻辑重排一下" |
| 架构文档 | 用户有架构概述需要结构审查 | 概念解释 | "这个架构文档的结构有问题" |
| 技术规范 | 用户有RFC需要结构审查 | 战略/金字塔 | "这个技术提案的结构审一下" |
| 开发者指南 | 用户有开发者文档需要信息架构 | 参考/数据库 | "dev guide内容重组一下" |

#### 商业文档
| 场景 | 触发信号 | 推荐模型 | 示例 |
|------|---------|---------|------|
| 商业提案 | 用户有proposal需要结构优化 | 战略/金字塔 | "这个proposal的结构审一下" |
| 策略报告 | 用户有战略文档需要金字塔结构 | 战略/金字塔 | "这个战略文档信息架构优化" |
| 商业计划书 | 用户有BP需要结构审查 | 战略/金字塔 | "这个BP的结构有问题，重排" |
| 市场分析 | 用户有市场报告需要结构审查 | 战略/金字塔 | "这个市场分析的结构审一下" |
| 竞品分析 | 用户有竞品分析需要逻辑重排 | 概念解释 | "竞品分析逻辑重排一下" |

#### 产品文档
| 场景 | 触发信号 | 推荐模型 | 示例 |
|------|---------|---------|------|
| PRD | 用户有PRD需要结构审查 | 战略/金字塔 | "这个PRD结构审一下" |
| 用户故事 | 用户有user stories需要MECE | 参考/数据库 | "这些user stories内容重组" |
| 产品规格 | 用户有spec需要结构审查 | 参考/数据库 | "这个产品spec结构有问题" |
| 设计文档 | 用户有设计文档需要逻辑重排 | 概念解释 | "设计文档的信息架构优化" |
| Roadmap | 用户有路线图需要结构审查 | 战略/金字塔 | "roadmap逻辑重排一下" |

#### 学术论文
| 场景 | 触发信号 | 推荐模型 | 示例 |
|------|---------|---------|------|
| 研究论文 | 用户有论文需要结构审查 | 概念解释 | "这篇论文的结构审一下" |
| 学位论文 | 用户有thesis需要逻辑重排 | 概念解释 | "论文的章节逻辑重排" |
| 文献综述 | 用户有综述需要结构优化 | 概念解释 | "这个文献综述结构审查" |
| 研究提案 | 用户有research proposal需要结构 | 战略/金字塔 | "proposal的结构审一下" |
| 学术报告 | 用户有学术报告需要信息架构 | 战略/金字塔 | "这个报告内容重组" |

#### 培训材料
| 场景 | 触发信号 | 推荐模型 | 示例 |
|------|---------|---------|------|
| 课程大纲 | 用户有课程需要结构审查 | 教程/指南 | "这个课程大纲结构审一下" |
| 入职指南 | 用户有onboarding doc需要逻辑重排 | 教程/指南 | "新人指南信息架构优化" |
| SOP文档 | 用户有操作手册需要结构审查 | 教程/指南 | "这个SOP的结构审一下" |
| 知识库 | 用户有wiki需要信息架构审查 | 参考/数据库 | "知识库的内容重组一下" |
| 视频脚本 | 用户有视频脚本需要叙事结构 | 教程/指南 | "这个脚本的叙事结构有没有问题" |

#### 营销内容
| 场景 | 触发信号 | 推荐模型 | 示例 |
|------|---------|---------|------|
| Landing Page | 用户有落地页需要信息架构 | 战略/金字塔 | "这个landing page结构审一下" |
| 案例研究 | 用户有case study需要叙事结构 | 概念解释 | "这个case study逻辑重排" |
| 白皮书 | 用户有whitepaper需要结构审查 | 概念解释 | "这个whitepaper结构审查" |
| 销售材料 | 用户有销售deck需要结构优化 | 战略/金字塔 | "这个销售deck信息架构优化" |
| 新闻稿 | 用户有press release需要结构 | 战略/金字塔 | "这个新闻稿结构审一下" |

#### AI Prompt/系统指令
| 场景 | 触发信号 | 推荐模型 | 示例 |
|------|---------|---------|------|
| System Prompt | 用户有系统指令需要结构审查 | 任务定义 | "这个system prompt结构审一下" |
| Agent定义 | 用户有Agent定义需要逻辑重排 | 任务定义 | "skill定义的结构有问题" |
| 工作流定义 | 用户有workflow需要关注点分离 | 任务定义 | "这个workflow定义审结构" |
| 评估标准 | 用户有eval rubric需要结构 | 参考/数据库 | "评估标准的信息架构" |
| Few-shot模板 | 用户有模板需要MECE审查 | 参考/数据库 | "这些模板的结构审一下" |

### 手动触发
- "结构审查"
- "review the structure"
- "这个文档结构有问题"
- "逻辑重排一下"
- "内容重组"
- "信息架构优化"

## 输入

- **content**（必需）— 待审查的文档（markdown/纯文本/结构化内容）
- **style_guide**（可选）— 项目特定风格指南。提供后覆盖所有通用原则（除「内容神圣不可侵犯」）
- **purpose**（可选）— 文档的预期目的（如"快速入门教程""API参考""概念概述"）
- **target_audience**（可选）— 读者是谁（如"新用户""经验丰富的开发者""决策者"）
- **reader_type**（可选，默认 `humans`）— `humans` 保留理解辅助；`llm` 优化精确度和密度
- **length_target**（可选）— 目标缩减（如"缩短30%""减半""无限制"）

---

## 原则

- **校准理解**：在保持理解的前提下优化到最少字数
- **前置价值**：关键信息在前，锦上添花在后（或删掉）
- **唯一真源**：完全相同的信息出现两次 → 合并
- **范围纪律**：属于其他文档的内容应删除或链接
- **建议而非执行**：输出建议——用户决定接受什么
- **内容神圣不可侵犯：永远不挑战观点——只优化组织方式**

---

## 人类读者原则

以下元素服务于人类理解和参与——除非明显浪费，否则保留：

- 视觉辅助（图表/流程图）
- 期望设定（"你将学到什么"）
- 读者旅程（线性递进 vs 数据库式）
- 心理模型（概述先于细节）
- 温暖/鼓励语调
- 留白（admonitions/callouts）
- 摘要（加固记忆 ≠ 冗余）
- 示例（让抽象具体化）
- 参与感（过渡/变化保持注意力）

## LLM读者原则

reader_type='llm' 时，优化精确度和无歧义：

- 依赖先行：使用概念前先定义
- 删除情感语言和引导章节
- 众所周知的概念直接引用标准，不重新教学
- 术语一致
- 消除模糊（"可能""一般"→直接陈述）
- 表格/列表/YAML 优于散文
- 引用已知标准
- 仍需要示例——落实具体期望
- 无歧义引用（无"它""这个""上述"）

---

## 5 种结构模型

### 1. 教程/指南（线性）
**适用**：教程、操作指南、how-to、walkthrough
- 前置条件先行
- 步骤严格按时间或逻辑依赖排序
- 目标导向：结尾有明确的"完成标准"

### 2. 参考/数据库
**适用**：API文档、术语表、配置参考、速查表
- 随机访问：无叙事流，用户跳到具体项目
- MECE：互斥且穷举
- 一致模式：每项相同结构

### 3. 概念解释
**适用**：深度稿、架构概述、概念指南、白皮书
- 抽象到具体：定义→上下文→实现/示例
- 脚手架：复杂思想建立在已建立的基础上

### 4. 任务定义（功能性）
**适用**：Prompt、系统指令、任务定义
- Meta先行：输入/约束/上下文 先定义
- 关注点分离：指令（逻辑）与数据（内容）分离
- 逐步：执行流程必须显式有序

### 5. 战略/金字塔
**适用**：PRD、研究报告、提案、决策记录
- 自上而下：结论/状态/建议开头
- 分组：支撑上下文逻辑分组
- 排序：最关键信息优先
- MECE：参数/组 互斥且穷举
- 证据支撑论点，不引领

---

## 执行流程

### Step 1: 验证输入

- 内容为空或少於3个词 → 暂停："内容太短，无法进行结构审查（至少需要3个词）"
- 验证 reader_type
- 识别文档类型和结构（标题/章节/列表）
- 记录当前字数和章节数

### Step 2: 理解目的

- 如提供了 purpose/audience，使用它们；否则从内容推断
- 识别文档要回答的核心问题
- 一句话陈述："此文档帮助 [受众] 实现 [目标]"
- 选择最合适的结构模型
- 标记 reader_type 和适用原则

### Step 3: 结构分析（核心）

- 如果有 style_guide：先查阅
- 映射文档结构：列出每个主要章节及其字数
- 对照选定的结构模型评估
- 对每个章节回答：这直接服务于所述目的吗？
- 识别可：完全删除、与其他章节合并、移动到其他位置、拆分的章节
- 识别真正冗余（无目的的重复，非摘要/加固）
- 识别范围违规（属于其他文档的内容）
- 识别信息埋没（关键信息隐藏在文档深处）

### Step 4: 流程分析

- 评估读者旅程：顺序匹配读者使用方式吗？
- 识别过早细节：读者还没准备好的解释
- 识别缺失脚手架：复杂思想缺乏足够铺垫
- 识别反模式：应用内联的FAQ、应删除的附录、逐字重复正文的概述
- humans读者 → 评估节奏：有足够的留白和视觉变化吗？

### Step 5: 生成建议

分类每项建议：

| 类别 | 含义 |
|------|------|
| **CUT** | 完全删除 |
| **MERGE** | 合并章节 |
| **MOVE** | 重新排序 |
| **CONDENSE** | 显著缩短 |
| **QUESTION** | 需要作者决策 |
| **PRESERVE** | 明确保留（可能看起来该删但服务于理解）|

每项建议：一句话理由 + 估计影响（字数增减）
如提供了 length_target，评估是否达到目标

### Step 6: 输出结果

```markdown
## 文档概要
- **目的：** [推断或提供的]
- **受众：** [推断或提供的]
- **读者类型：** [humans/llm]
- **结构模型：** [选定的]
- **当前长度：** [X]词，[Y]章节

## 建议

### 1. [CUT/MERGE/MOVE/CONDENSE/QUESTION/PRESERVE] - 章节名
**理由：** [一句话]
**影响：** ~[X]词
**理解注意：** [如有]

### 2. ...

## 总结
- **总建议数：** [N]
- **估计缩减：** [X]词（原长的[Y]%）
- **是否满足长度目标：** [是/否/无目标]
- **理解权衡：** [标记为简洁牺牲参与度的删除]
```

无建议 → "未发现结构性问题"

---

## 与 Hermes 技能的集成

### 被 feishu-html 阶段二B 调用

```
设计规划阶段：
加载 editorial-review-structure，使用「教程/指南」或「战略/金字塔」模型
审查页面 TAB 结构和信息层级。
```

### 被 answer Phase 3 Architect 调用

```
结构设计完成后：
加载 editorial-review-structure，使用最匹配的模型审查架构文档。
```

### 被 feishu-wiki 首页优化调用

```
加载 editorial-review-structure with purpose="知识库首页目录"，使用「参考/数据库」模型。
```

---

## 约束

- 永远在 copy-editing 前运行（Editorial Review Prose 在 Structure 之后）
- 输出建议，不直接修改
- 内容神圣不可侵犯

## 验证清单

- [ ] 输入至少有3个词
- [ ] reader_type 有效
- [ ] 正确选择了结构模型
- [ ] 每项建议有类别标签(CUT/MERGE等)
- [ ] 估计字数影响
- [ ] 无未标记的理解权衡