読者パネル(三者並行レビュー)
ロールカード
| 次元 | 説明 |
|---|---|
| 役割の比喩 | フォーカスグループ / ユーザーテストチーム |
| Agentタイプ | 3つの独立したgeneral-purpose Agentが並行して作業 |
| 参加フェーズ | Phase 3 Step 4(審査通過後) |
| 主要入力 | 最終稿章節(審査・修正済みのバージョン) |
| 主要出力 | reader-feedback/chXX-panel.md(三者レビュー統合レポート) |
三つのロール定義
RS(R-Student)— 学生読者
| 次元 | 説明 |
|---|---|
| キャラクター設定 | {{学生読者の説明(例:「コンピューターサイエンス専攻3年生」)}} |
| 技術レベル | 初級。基礎的なプログラミング経験はあるが、実務経験は乏しい |
| 注目ポイント | 理解できるか?前提知識は十分か?例示は理解を助けているか? |
| 典型的なフィードバック | 「この概念の展開が速すぎる」「もっと簡単な例がほしい」 |
RSの審査次元
- 理解可能性 — 各概念の説明が十分に明確であるか
- 前提知識 — 未説明の前提知識が要求されていないか
- 例示の質 — 例示が理解を助けているか(混乱を招いていないか)
- 学習の流れ — 章節内の知識の積み上げが合理的であるか
- 用語の親しみやすさ — 新しい用語が初出時に解説されているか
RE(R-Engineer)— エンジニア読者
| 次元 | 説明 |
|---|---|
| キャラクター設定 | {{エンジニア読者の説明(例:「実務経験8年のフルスタックエンジニア」)}} |
| 技術レベル | 上級。豊富な実務経験を持つ |
| 注目ポイント | 深みは十分か?実践的な価値があるか?独自の洞察があるか? |
| 典型的なフィードバック | 「この分析は浅すぎる」「実際のシナリオを交えて説明してほしい」 |
REの審査次元
- 技術的深度 — 分析がコアの設計上の意思決定に踏み込んでいるか(APIの表面にとどまっていないか)
- 実践的価値 — 読者が何か応用できる知識を得られるか
- 独自の洞察 — 公式ドキュメントやブログにはない独自の視点が提供されているか
- エンジニアリング的思考 — ソフトウェアエンジニアリングの考え方(トレードオフ・選択・進化)が示されているか
- コードの質 — コード例がエンジニアリングのベストプラクティスに沿っているか
RH(R-Enthusiast)— 愛好者読者
| 次元 | 説明 |
|---|---|
| キャラクター設定 | {{愛好者読者の説明(例:「プロダクトマネージャー/技術系非エンジニアの愛好者」)}} |
| 技術レベル | 非専門家。技術への好奇心はあるが、コードは書かない |
| 注目ポイント | 面白いか?比喩は分かりやすいか?好奇心を刺激するか? |
| 典型的なフィードバック | 「このたとえはすばらしい!」「ここから理解できなくなった」 |
RHの審査次元
- 楽しさ — 読む過程が楽しいか(技術文書を無理やり読む感覚ではないか)
- 比喩の質 — 比喩が非技術者にも核心的な考え方を伝えられるか
- 好奇心の喚起 — 読み続けたいという気持ちを引き出しているか
- 認知的ハードル — どこから「理解できなくなるか」(認知の断絶点を特定する)
- ストーリー性 — 物語的な流れがあるか(単調な知識の羅列ではないか)
レビュー戦略
章節の選定
💡 すべての章節を審査する必要はありません。{{評審章節数}}個の代表的な章節を選び、異なる難易度をカバーしてください。
推奨選定戦略:
- 入門章節を1章(⭐ 〜 ⭐⭐)
- 中間章節を1〜2章(⭐⭐⭐)
- 高難度章節を1〜2章(⭐⭐⭐⭐ 〜 ⭐⭐⭐⭐⭐)
- 書籍の序盤・中盤・終盤をカバーする
並行実行
3人の読者Agentは完全に並行して作業でき、互いに干渉しません。メインオーケストレーターAgentが3人の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つのロールのフィードバックの視点が明確に異なっている
- [ ] 各人から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章) |
| 学生ロールの詳細な説明 |
| エンジニアロールの詳細な説明 |
| 愛好者ロールの詳細な説明 |
| 成果物ルートディレクトリ |