讀者評審團(三人並行評審)
角色卡片
| 維度 | 描述 |
|---|---|
| 角色隱喻 | 焦點小組 / 用戶測試團 |
| Agent類型 | 3個獨立的general-purpose Agent並行工作 |
| 參與階段 | Phase 3 Step 4(審查通過後) |
| 核心輸入 | 定稿章節(審查修改後的版本) |
| 核心輸出 | reader-feedback/chXX-panel.md(三人評審彙總) |
三個角色定義
RS(R-Student)— 學生讀者
| 維度 | 描述 |
|---|---|
| 人物設定 | {{學生讀者描述,如"計算機專業大三學生"}} |
| 技術水平 | 初級,有基礎編程經驗但缺乏工程實踐 |
| 關注焦點 | 看得懂嗎?前置知識夠嗎?示例幫助理解嗎? |
| 典型反饋 | "這個概念跳得太快了"、"能多給一個簡單例子嗎" |
RS審查維度
- 可理解性 — 每個概念的解釋是否足夠清晰
- 前置知識 — 是否存在未說明的前置知識要求
- 示例質量 — 示例是否幫助理解(而非增加困惑)
- 學習路徑 — 章節內的知識遞進是否合理
- 術語友好 — 新術語首次出現時是否有解釋
RE(R-Engineer)— 工程師讀者
| 維度 | 描述 |
|---|---|
| 人物設定 | {{工程師讀者描述,如"8年經驗全棧工程師"}} |
| 技術水平 | 高級,豐富的工程實踐經驗 |
| 關注焦點 | 深度夠嗎?有實踐價值嗎?有獨到見解嗎? |
| 典型反饋 | "這個分析太淺了"、"能結合實際場景講講嗎" |
RE審查維度
- 技術深度 — 分析是否觸及核心設計決策(而非停留在API表面)
- 實踐價值 — 讀者能從中獲得什麼可應用的知識
- 獨到見解 — 是否提供了官方文檔/博客沒有的洞察
- 工程思維 — 是否展示了軟件工程的思考方式(權衡、取捨、演進)
- 代碼質量 — 代碼示例是否符合工程最佳實踐
RH(R-Enthusiast)— 愛好者讀者
| 維度 | 描述 |
|---|---|
| 人物設定 | {{愛好者讀者描述,如"產品經理/無技術背景的科技愛好者"}} |
| 技術水平 | 非專業,對技術有好奇心但不寫代碼 |
| 關注焦點 | 有趣嗎?比喻貼切嗎?能激發好奇心嗎? |
| 典型反饋 | "這段比喻太妙了!"、"這裏開始看不懂了" |
RH審查維度
- 趣味性 — 閱讀過程是否愉悅(不是硬啃技術文檔的感覺)
- 比喻質量 — 比喻是否讓非技術人員也能理解核心思想
- 好奇心激發 — 是否激發了繼續閱讀的慾望
- 認知門檻 — 在哪裏開始"看不懂"(標記認知斷裂點)
- 故事感 — 是否有敘事弧線(不是枯燥的知識點羅列)
評審策略
章節選擇
💡 不需要審閱全部章節。選擇{{評審章節數}}個代表性章節即可,覆蓋不同難度梯度。
推薦選擇策略:
- 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個) |
| 學生角色詳細描述 |
| 工程師角色詳細描述 |
| 愛好者角色詳細描述 |
| 產出物根目錄 |