manuscript-engagement-analytics

原稿のエンゲージメント分析

中核となる視点

読書時間に対する価値の推移をマッピングすることで、読者のエンゲージメントをおおよそ把握できます。有益な成果が得られるまでの間隔が長い原稿、漠然としたトピック見出し、または読者コメントの減少は、読者が退屈したり、混乱したり、行き詰まったりする可能性のある箇所を示しています。

このスキルを使うと、次のことができます。

• 見出しレベルの単語数マップを作成する。
• 読み始めの遅さや、長くてつらい箇所を見つける。
• 見出しが読者に役立つ内容を約束しているかを確認する。
• ベータリーダーのコメント位置や、読者が読むのをやめた箇所を解釈する。
• 価値を適切なペースで届けるための改訂項目一覧を作成する。

参照先

必要な情報	読むファイル
エンゲージメント分析の概念	references/core/knowledge.md
分析ルールとしきい値	references/core/rules.md
マップと分析結果の例	references/core/examples.md
簡易監査チェックリスト	references/core/checklist.md
エンゲージメント監査の手順	workflows/audit-engagement.md

スクリプト

決定論的な Markdown 構造分析には、scripts/analyze_manuscript.py を使用します。

python3 skills/manuscript-engagement-analytics/scripts/analyze_manuscript.py manuscript.md

見出し、行番号、単語数、累積単語数、ヒューリスティックによるフラグを表形式で出力します。スクリプトの出力を根拠として使い、参照資料に基づいて判断してください。

ワークフロー

1. 読者への約束を明確にする

対象読者、書籍が約束する内容、最初の意味ある成果を特定します。これらが明確でない場合は、まず book-toc-lab を使用してください。

2. 構成マップを作成する

スクリプトを実行するか、手動で表を作成します。

Section | Line | Words | Cumulative words | Reader takeaway | Risk

3. 価値が得られる箇所をマークする

読者が次のものを得られる箇所をマークします。

• 実践に使えるアイデア。
• 意思決定の枠組み。
• チェックリスト。
• 実例。
• 演習やエクササイズ。
• トラブルシューティングの回答。

4. エンゲージメントのリスクを診断する

次の点を確認します。

• 最初の成果が得られるまでの単語数が多すぎる。
• 読者に役立つ内容が乏しい長いセクション。
• 導入的なセクションが連続している。
• 読者が得られる価値を隠してしまう漠然とした見出し。
• ベータリーダーのコメントが同じセクション付近で途絶えている。

5. 改訂案を提示する

構成上の修正を優先します。

• 価値のある内容を前に移動する。
• 成果の乏しい導入部分を削るか短縮する。
• 読者が得られる成果を中心に見出しを付け直す。
• 長いセクションを分割する。
• 理論を実例、チェックリスト、演習、または意思決定の形にする。

出力形式

エンゲージメントを監査する際は、次の内容を返してください。

1. 約束する内容と、最初の成果に関する診断。
2. 価値マップ、またはスクリプト出力の要約。
3. リスクが最も高いセクション。
4. エンゲージメントへの影響が大きいと予想される順に並べた改訂案。
5. データがある場合は、ベータリーダーのコメントや読者離脱に関する解釈。
6. 改訂後の確認事項。

品質基準

指標は判断の根拠ではなく、手がかりとして使ってください。単語数やコメントの減少箇所は、どこを調べるべきかを示します。最終的な提案では、読者にとって何が不足しているのか、何が後回しになっているのか、何が不明確なのかを説明してください。