菜单
OCR JSONから本ごとの専用ナレッジスキルを自動生成する。「この本のスキルを作って」「本を登録したい」「OCRした本をスキルにしたい」と言われた時にこのスキルを使う。本のOCR JSONファイルパスを指定してもらい、チャプター構造の解析、要約生成、スキルファイルの生成までを自動で行う。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | book-skill-generator |
| description | OCR JSONから本ごとの専用ナレッジスキルを自動生成する。「この本のスキルを作って」「本を登録したい」「OCRした本をスキルにしたい」と言われた時にこのスキルを使う。本のOCR JSONファイルパスを指定してもらい、チャプター構造の解析、要約生成、スキルファイルの生成までを自動で行う。 |
OCR JSON（Cosense形式）から、本ごとの専用ナレッジスキルを自動生成する。
本一冊をまるごと読むのは時間がかかるが、問題にぶち当たった時にその本の知識を活用できれば十分なケースが多い。このスキルは、本のOCRデータを解析して「必要な時に必要な知識を引き出せる」スキルを生成する。生成されたスキルは、ユーザーが関連する問題に遭遇した時に自動でトリガーされ、本の該当箇所を参照して回答する。
pages配列、各ページにtitleとlines）> プレフィックスの行に含まれる~/.claude/skills/ に配置されるユーザーからOCR JSONのパスを受け取ったら、パーススクリプトを実行する。
python3 ~/.claude/skills/book-skill-generator/scripts/parse_book.py "<OCR_JSON_PATH>" "/tmp/book-parse-output"
このスクリプトは以下を行う：
> プレフィックスのテキストを抽出出力:
structure.json: チャプター構造（タイトル、ページ範囲、文字数）chapters/: チャプターごとのマークダウンファイルstructure.json を読み、以下を確認する：
問題が見つかった場合は、OCR JSONの該当ページを直接読んで正しい章境界を特定し、手動でチャプターファイルを修正する。
典型的な問題と対処法：
第N章 や セクション番号 (N.N) を探す> 行を直接読み、正しいタイトルを取得する。 < 第N章 > の後の行に書いてあることが多い各チャプターの要約をサブエージェント（Task ツール）で並列生成する。コンテキスト溢れを防ぐため、以下のルールを厳守すること。
サブエージェントのプロンプトには チャプターのテキストを埋め込まない。代わりにファイルパスを渡し、サブエージェント自身に Read ツールで読ませる。
各サブエージェントには以下を指示する：
/tmp/book-parse-output/chapters/{slug}.md）を Read ツールで読む
/tmp/book-parse-output/summaries/{slug}_summary.md に Write ツールで書き出すTask ツールの設定:
- subagent_type: "general-purpose"
- model: "haiku" # 要約タスクにはhaiku で十分。コンテキスト節約のため必須
- max_turns: 5 # Read → (分割読みの場合追加Read) → 要約作成 → Write で十分
- run_in_background: true # 並列実行のため必須
以下のチャプターファイルを読んで要約を生成し、結果をファイルに書き出してください。
チャプターファイル: /tmp/book-parse-output/chapters/{slug}.md
出力先: /tmp/book-parse-output/summaries/{slug}_summary.md
手順:
1. Read ツールでチャプターファイルを読む（20,000文字超の場合は offset/limit で分割して読む）
2. 以下の形式で要約を生成する
3. Write ツールで出力先に書き出す
出力形式:
---
**要約**: （3-5文でこの章の主要テーマと論点を記述）
**キー概念**: 概念A, 概念B, 概念C, ...（5-10個）
**実践的な知見**:
- 〜する場合は〜が有効
- 〜の問題には〜で対処できる
---
run_in_background: true で起動した後、TaskOutput でサブエージェントの結果を読み込まない/tmp/book-parse-output/summaries/ 配下）を 1つずつ Read ツールで読み、index.md に統合するls /tmp/book-parse-output/summaries/ | wc -l で確認）サブエージェント起動前に、出力ディレクトリを作成する：
mkdir -p /tmp/book-parse-output/summaries
Phase 3 で /tmp/book-parse-output/summaries/ に書き出された要約ファイルを 1つずつ Read ツールで読みながら、index.md を組み立てる。一度に全ファイルを読み込まないこと（コンテキスト保護のため）。このファイルが生成されるスキルの「目次」となり、ユーザーの質問に対してどの章を参照すべきかを判断する際の手がかりになる。
フォーマット：
# 「本のタイトル」インデックス
**著者**: XXX
**概要**: 本全体の内容を2-3文で要約
## 章構成
### 第1章: タイトル (pages XXX-YYY)
**要約**: この章では〜を扱っている。〜について説明し、〜を論じている。
**キー概念**: 概念A, 概念B, 概念C, ...
**実践的な知見**:
- 〜する場合は〜が有効
- 〜の問題には〜で対処できる
### 第2章: タイトル (pages XXX-YYY)
...
以下のファイルを ~/.claude/skills/<スキル名>/ に生成する：
SKILL.md: テンプレート（templates/skill_template.md）をベースに、以下を埋める
{{SKILL_NAME}}: 本のドメインに基づく英語スラッグ（例: virtualization-tech-book）{{SKILL_DESCRIPTION}}: 最も重要。本のドメインに特化したトリガー説明。以下を含める：
{{BOOK_TITLE}}: 本のタイトル{{BOOK_AUTHOR}}: 著者名references/index.md: Phase 4 で生成したもの
references/chapters/: Phase 1-2 で生成したチャプターファイル
生成されたスキルのパスをユーザーに伝え、想定される利用シーンを2-3個提示する。
例:
コード変更・diff・ブランチ・PRについて、リッチでインタラクティブな解説を生成するスキル。「この変更を解説して」「このPRを説明して」「diffを分かりやすくまとめて」「このブランチの変更点を教えて」「変更内容の解説ページを作って」と言われたら使う。背景・直感・コード・批評・クイズの5セクションから成る自己完結HTMLファイルを出力する。解説だけでなく批判的な視点も含む。他人のPRや自分の変更を、初学者にも分かる形で理解・共有したい場面で積極的に使うこと。
長考や自問自答の末に、元の質問から逸れた（drift した）回答をしてしまったときに、 思考を原点に立て直すためのリカバリスキル。同一セッションで元の質問に答え直す「原点回帰」を核に、 それでも直らない場合は、汚染のないセッションで再出発するための「質問カード」を出して /clear や 新セッションへ誘導する、一直線のエスカレーション型。 「迷走してる」「質問に答えてない」「そんなこと聞いてない」「ズレてる」「話が逸れた」「やりなおして」 「元の質問に戻って」「なんでその話になってるの」と言われたら使う。 ユーザーが直前の回答に対して困惑・不満・「？」を示したとき、あるいは自分の回答が元の質問と かみ合っていないと気づいたときは、指示される前にこのスキルを提案・発動してよい。
忖度をやめ、容赦なく正直な高レベルアドバイザーとして振る舞うモード。一度呼ばれたらセッション全体でこの人格を貫く。 ユーザーの思考に意見し、前提を疑い、避けている盲点を暴き、弱い推論を解剖し、自己欺瞞・言い訳・機会費用を名指しする。ただし丁寧な言葉を使い、攻撃と正直さを混同しない。 「厳しく評価して」「容赦なく」「盲点を指摘して」「甘やかさないで」と言われたら使う。対象は仕事・思考・意思決定・計画・戦略。 ユーザーが同意や称賛を求めているだけに見えるとき、自分を正当化して逃げているとき、不快な決断を先送りしているときは、このモードを提案してよい。
今のClaude Codeセッションでの会話を踏まえて、そこで得た学びを「個人用の公開メモ」1枚にまとめてチャットに返すスキル。「/matome 〇〇についてまとめて」「ここまでの会話をまとめて」「今の話を公開メモにして」「会話の内容を1枚にまとめて」と言われたら使う。単発の質問への要約ではなく、会話の中で芋づる式に出てきた話題（〇〇を聞いたら△△が出て、それを掘ったら□□が…）を全部拾い、3ヶ月後の自分が読んで理解できる順に再構成するのが特徴。社内コードや機密は自動で抽象化する。
対象を徹底的に理解する。記事、リポジトリ、本、論文などのコンテンツについて、メンタルモデルの獲得を目指して深い理解に達するまで探索・質問・解説を繰り返す。「徹底的に理解したい」「深掘りしたい」「このリポジトリを理解したい」「この本を読み解きたい」といった場面で使用する。
虫食い思考（コンサル業界の「空パック / Ghost Deck」に相当）でユーザーと一緒に進めるためのスキル。 先に「型」（答えるべき問い・アジェンダ・テンプレ）を作って「虫食い状態」にしてから、 その穴を1つずつ埋めていく進め方。 「虫食いで」「虫食い思考で」「空パックで」「骨子から作って」「先に型を作って」 「アジェンダから決めて」「アウトライン先行で」「skeleton-first」「ghost deck」 と言われたら使う。 Q振り返り、次Q発表準備、提案資料作成、採用面接の準備、ブログや記事の構成、 「何かを書く／考える前段で先に骨組みを置きたい」場面で積極的に使うこと。 ユーザーの思考が発散して整理が必要そうなときに、「先に虫食いで構造化しませんか？」と提案するのもよい。