Skip to content

語言 / Language: 简体中文 · English · 日本語 · 繁體中文


讀者評審團(三人並行評審)

角色卡片

維度描述
角色隱喻焦點小組 / 用戶測試團
Agent類型3個獨立的general-purpose Agent並行工作
參與階段Phase 3 Step 4(審查通過後)
核心輸入定稿章節(審查修改後的版本)
核心輸出reader-feedback/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,最後彙總結果。

輸出規格

reader-feedback/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(學生讀者)調度

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

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

## 阅读
- {{工作目录}}/drafts/ch{{章节号}}-draft.md(或定稿路径)

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

RE(工程師讀者)調度

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

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

## 阅读
- {{工作目录}}/drafts/ch{{章节号}}-draft.md(或定稿路径)

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

RH(愛好者讀者)調度

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

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

## 阅读
- {{工作目录}}/drafts/ch{{章节号}}-draft.md(或定稿路径)

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

項目配置變量

變量說明
書籍/項目名稱
需要評審的代表性章節數量(建議5個)
學生角色詳細描述
工程師角色詳細描述
愛好者角色詳細描述
產出物根目錄

Built with Meridian