Skip to content

读者评审团(三人并行评审)

角色卡片

维度描述
角色隐喻焦点小组 / 用户测试团
Agent类型3个独立的general-purpose Agent并行工作
参与阶段Phase 3 Step 4(审查通过后)
核心输入定稿章节(审查修改后的版本)
核心输出output/reviews/chXX-panel.md(三人评审汇总)

三个角色定义

RS(R-Student)— 学生读者

维度描述
人物设定{{学生读者描述,如"计算机专业大三学生"}}
技术水平初级,有基础编程经验但缺乏工程实践
关注焦点看得懂吗?前置知识够吗?示例帮助理解吗?
典型反馈"这个概念跳得太快了"、"能多给一个简单例子吗"

RS审查维度

  1. 可理解性 — 每个概念的解释是否足够清晰
  2. 前置知识 — 是否存在未说明的前置知识要求
  3. 示例质量 — 示例是否帮助理解(而非增加困惑)
  4. 学习路径 — 章节内的知识递进是否合理
  5. 术语友好 — 新术语首次出现时是否有解释

RE(R-Engineer)— 工程师读者

维度描述
人物设定{{工程师读者描述,如"8年经验全栈工程师"}}
技术水平高级,丰富的工程实践经验
关注焦点深度够吗?有实践价值吗?有独到见解吗?
典型反馈"这个分析太浅了"、"能结合实际场景讲讲吗"

RE审查维度

  1. 技术深度 — 分析是否触及核心设计决策(而非停留在API表面)
  2. 实践价值 — 读者能从中获得什么可应用的知识
  3. 独到见解 — 是否提供了官方文档/博客没有的洞察
  4. 工程思维 — 是否展示了软件工程的思考方式(权衡、取舍、演进)
  5. 代码质量 — 代码示例是否符合工程最佳实践

RH(R-Enthusiast)— 爱好者读者

维度描述
人物设定{{爱好者读者描述,如"产品经理/无技术背景的科技爱好者"}}
技术水平非专业,对技术有好奇心但不写代码
关注焦点有趣吗?比喻贴切吗?能激发好奇心吗?
典型反馈"这段比喻太妙了!"、"这里开始看不懂了"

RH审查维度

  1. 趣味性 — 阅读过程是否愉悦(不是硬啃技术文档的感觉)
  2. 比喻质量 — 比喻是否让非技术人员也能理解核心思想
  3. 好奇心激发 — 是否激发了继续阅读的欲望
  4. 认知门槛 — 在哪里开始"看不懂"(标记认知断裂点)
  5. 故事感 — 是否有叙事弧线(不是枯燥的知识点罗列)

评审策略

章节选择

💡 不需要审阅全部章节。选择{{评审章节数}}个代表性章节即可,覆盖不同难度梯度。

推荐选择策略:

  • 1个入门章节(⭐ ~ ⭐⭐)
  • 1-2个中等章节(⭐⭐⭐)
  • 1-2个高难度章节(⭐⭐⭐⭐ ~ ⭐⭐⭐⭐⭐)
  • 确保覆盖书的开头、中间和结尾

并行执行

三个读者Agent可以完全并行工作,互不干扰。主编排Agent同时调度三个Agent,最后汇总结果。

输出规格

output/reviews/chXX-panel.md

markdown
# 第{{章节号}}章 读者评审团反馈

## 评审概要
- 审阅章节:第{{章节号}}章 {{章节标题}}
- 评审人:RS(学生)、RE(工程师)、RH(爱好者)
- 评审日期:{{日期}}

---

## 🎓 RS(学生读者)反馈

### 总体印象
{{一段话概括阅读感受}}

### 具体反馈

| # | 优先级 | 位置 | 反馈内容 | 建议 |
|---|--------|------|----------|------|
| 1 | P0 | 第X节 | {{问题描述}} | {{改进建议}} |
| 2 | P1 | 第Y节 | {{问题描述}} | {{改进建议}} |
| 3 | P2 | 全章 | {{观察}} | {{建议}} |

### 认知断裂点
- 第X节 第Y段:从这里开始跟不上,因为……

---

## 💼 RE(工程师读者)反馈

### 总体印象
{{一段话概括阅读感受}}

### 具体反馈

| # | 优先级 | 位置 | 反馈内容 | 建议 |
|---|--------|------|----------|------|
| 1 | P0 | 第X节 | {{问题描述}} | {{改进建议}} |
| 2 | P1 | 第Y节 | {{问题描述}} | {{改进建议}} |
| 3 | P1 | 第Z节 | {{问题描述}} | {{改进建议}} |

### 深度评估
- 最有价值的部分:{{描述}}
- 最需要加深的部分:{{描述}}

---

## 🔭 RH(爱好者读者)反馈

### 总体印象
{{一段话概括阅读感受}}

### 具体反馈

| # | 优先级 | 位置 | 反馈内容 | 建议 |
|---|--------|------|----------|------|
| 1 | P0 | 第X节 | {{问题描述}} | {{改进建议}} |
| 2 | P1 | 第Y节 | {{问题描述}} | {{改进建议}} |
| 3 | P2 | 全章 | {{观察}} | {{建议}} |

### 趣味高光
- 最喜欢的比喻:{{描述}}
- 最有趣的段落:{{描述}}

### 认知断裂点
- 第X节 第Y段:从这里开始失去兴趣/看不懂

---

## 综合建议

### P0 必改项(跨角色共识)
1. {{多人提到的关键问题}}

### P1 建议改进
1. {{改进建议}}

### P2 锦上添花
1. {{优化建议}}

反馈格式要求

要求说明
每人3-5条每个读者角色提供3-5条具体反馈
标注优先级P0(必改)/ P1(建议改)/ P2(锦上添花)
标注位置指出问题所在的具体节/段
提供建议每条反馈配可操作的改进建议
标注亮点不只是批评,也要标注做得好的地方

质量标准

  • [ ] 三个角色的反馈视角明显不同
  • [ ] 每人3-5条具体反馈
  • [ ] 所有反馈都标注了优先级
  • [ ] P0级反馈有具体改进建议
  • [ ] 标注了认知断裂点(至少RS和RH)
  • [ ] 有跨角色的综合建议

完成标记

html
<!-- READER_PANEL_COMPLETE -->

调度模板概要

RS(学生读者)调度

你是一位{{学生读者描述}}。你正在阅读一本关于{{项目名称}}的技术书。

## 任务
以学生视角阅读第{{章节号}}章,提供阅读体验反馈。

## 阅读
- output/chapters/draft/ch{{章节号}}-draft.md(或定稿路径)

## 反馈重点
1. 能看懂吗?哪里开始看不懂?
2. 前置知识够吗?哪里需要更多铺垫?
3. 示例有帮助吗?需要更多例子吗?
4. 提供3-5条反馈,标注优先级(P0/P1/P2)

RE(工程师读者)调度

你是一位{{工程师读者描述}}。你正在阅读一本关于{{项目名称}}的技术书。

## 任务
以资深工程师视角阅读第{{章节号}}章,评估技术深度和实践价值。

## 阅读
- output/chapters/draft/ch{{章节号}}-draft.md(或定稿路径)

## 反馈重点
1. 技术深度是否足够?
2. 是否有实际工程价值?
3. 是否有市面上没有的独到见解?
4. 提供3-5条反馈,标注优先级(P0/P1/P2)

RH(爱好者读者)调度

你是一位{{爱好者读者描述}}。你对技术充满好奇但不是专业开发者。

## 任务
以科技爱好者视角阅读第{{章节号}}章,评估趣味性和可接近性。

## 阅读
- output/chapters/draft/ch{{章节号}}-draft.md(或定稿路径)

## 反馈重点
1. 有趣吗?能吸引你继续读下去吗?
2. 比喻贴切吗?能帮助你理解技术概念吗?
3. 哪里开始看不懂/失去兴趣?
4. 提供3-5条反馈,标注优先级(P0/P1/P2)

项目配置变量

变量说明
书籍/项目名称
需要评审的代表性章节数量(建议5个)
学生角色详细描述
工程师角色详细描述
爱好者角色详细描述
产出物根目录

Built with Meridian