analyst-research

analyst-research · 投資調査ワークフローのスキル

投資アナリストや政策研究者向けに、実地検証済みのAI支援型調査ワークフローを再利用可能なClaudeスキルとしてパッケージ化しました。サウジアラビアの「Vision 2030」詳細分析（図表35点、15,000語以上）を生み出した手法に基づいています。範囲は3つのモードから選べます。ユーザーは起動時に選択します。

ライセンス：MIT。Copyright © 2026 Ligen [email protected]。LICENSEを参照してください。

ステップ0 — モードを選択する（参照ファイルを読み込む前に必須）

このスキルが起動されたら、参照ファイルを読み込む前に、ユーザーに調査範囲を選択してもらいます。以下の3つの選択肢をそのまま提示してください。

This skill has three scope modes. Pick one based on your project size:

  light    4-5 page decision memo, 0 charts, ~15 min budget
           Single LLM session. Pure markdown footnote citations.
           Use for: exec brief, internal memo, quick decision support.

  medium   12-15 page topic analysis, 6-10 charts, ~1 h budget
           Single LLM. PDF + Word derivations. Sign-off checkpoint after draft.
           Use for: topic deep-dive, board memo with data, same-day analysis.

  heavy    Flagship report 30-40 pages / 15k+ words, 25-35+ charts, ~2-3 h budget
           Single or multi-LLM. PDF + Word + WeChat md + HTML publication.
           Runs the full 11-step staged workflow (framing → sourcing →
           analysis → drafting → review), with 3 sign-off checkpoints.
           Use for: industry deep-dive, macro thesis, policy assessment,
                    flagship investor publication.

Which mode fits your project? (reply with light, medium, or heavy)

ユーザーの起動メッセージに範囲を示す明確なヒント（ページ数、グラフ数、時間の目安）がすでに含まれている場合は、モードを推定し、メニュー全体を提示する代わりに一行で確認してください。

「グラフ数点を含む約10ページということですね。mediumモードで進めます。よろしいですか？」

モードの確認後、言語について短く質問してください。「レポートの言語 — 英語（デフォルト）、または別の言語ですか？」（下記の言語ポリシーを参照）。その後、そのモードの参照ファイルを読み込みます。

モードごとの読み込み順

まず、必ずreferences/workflow.md（約40行、モードルーター）を読み込みます。ここからモード別のワークフローファイルへ進みます。（各参照ファイルには.zh.mdの中国語版ミラーもありますが、エージェントは英語の.mdを読み込みます。）

lightモード

1. 必須 references/workflow.md — 概要とモードルーター
2. 必須 references/workflow_light.md — 6ステップの骨組み、ソフトストップのみ、BLUF形式のエグゼクティブサマリー、grepによるセルフチェック
3. 必須 references/_quarto-light.yml — 4～5ページのメモに最適化されたQuartoテンプレート（目次なし、セクション番号なし、脚注形式の引用、本文11pt）
4. グラフなし。参考文献リストなし。HTML／WeChat向け派生物なし。report_style_spec.mdとchart_template.pyはスキップします。

続いてworkflow_light.md §1 hypothesis lockに進み、6ステップのフローを開始します。

mediumモード

1. 必須 references/workflow.md — 概要とモードルーター
2. 必須 references/workflow_medium.md — 8ステップの骨組み、単一LLM、ドラフト後に1回の承認チェックポイント
3. 必須 references/report_style_spec.md — 6～10点のグラフ向けビジュアル仕様（chart_templateのインターフェース契約、カラーパレット、フォントポリシー）
4. 必須 references/_quarto-medium.yml — Quartoテンプレート（脚注形式の引用、.bibなし、本文11pt、CJKは宋体SC）
5. 必要に応じて scripts/chart_template.py — グラフのスタイル設定の実装

続いてworkflow_medium.md §1 onboardingに進み、プロジェクトのひな型を作成して開始します。

heavyモード

1. 必須 references/workflow.md — 概要とモードルーター
2. 必須 references/workflow_heavy.md — 11ステップの完全な骨組み、複数LLMは任意、3回の承認チェックポイント（アウトライン／ドラフト／最終版）
3. 必須 references/report_style_spec.md — HTML公開用の派生物を含むビジュアル仕様
4. 必要に応じて scripts/chart_template.py — グラフのスタイル設定の実装
5. 必要に応じて scripts/publication-style-template.html — HTML公開用テンプレート
6. 必要に応じて scripts/author.jpg — HTMLページ用の著者写真プレースホルダー

heavyモード用のQuartoテンプレートはreport_style_spec.md §5.1に記載されています（個別の_quarto-heavy.ymlファイルはありません。heavyモードのQuarto設定の正式な参照元はこの仕様です）。

続いてworkflow_heavy.md §1.3 new-project onboardingに進み、プロジェクトのひな型を作成（analyst-research/フォルダー全体をプロジェクトのルートにコピー）して開始します。

モードの比較一覧

以下は概要です。正式な情報源は MODE_REGISTRY.md です。モードのパラメーターを変更する場合は、まずこのファイルを編集し、その後こちらにも反映してください。

項目	light	medium	heavy
出力の長さ	4～5ページ	12～15ページ	30～40ページ／15k+ 語
グラフ	0	6～10	25～35+
実行時間の上限	約15分	約1時間	約2～3時間
LLM モデル	単一	単一	単一または複数の LLM
ワークフローのステップ	6	8	11
ハードストップ	0	1（ドラフト後に承認）	3（アウトライン／ドラフト／最終版）
派生出力	PDF + Word	PDF + Word	PDF + Word + WeChat md + HTML
引用	Markdown 脚注	Markdown 脚注	BibTeX + APA
プロジェクトのひな型	最小限	最小限	完全版（番号付きディレクトリ10個）
グラフのテンプレート	該当なし	共通（chart_template.py）	共通（chart_template.py）

モードごとのファイル依存関係、モードのアップグレードの流れ、振り返りセクションへの参照については、MODE_REGISTRY.md を参照してください。

このスキルを使用しないケース

• 単発のニュース解説 → market-research-skills:topic-brief を使用してください
• スライドデッキ／PPT → deckster-slide-generator を使用してください
• 一度きりの Q&A（レポートを作成しない場合）→ スキルは使用せず、そのまま回答してください
• 文芸作品やマーケティングコピーのみ → このスキルの対象外です
• レポート出力を伴わない、ツール／スクリプトのみのプロジェクト → このスキルの対象外です

このスキルは、既存の研究やデータを統合・分析するためのものです（workflow_heavy.md §2.2 にあるとおり、独自のモデルは構築しません）。既存の文献が豊富なトピック（IMF／World Bank／IEA／BIS、投資銀行やコンサルティング会社の調査、学術論文、規制関連の開示情報など）に最も適しています。組織による情報公開が少ない、最先端でニュース主導のトピックには適していません。

プロジェクトの途中でスコープを拡大・縮小する方法

プロジェクトを light で開始し、より深い分析が必要だとわかった場合は、スキルを再度起動して medium に切り替えてください。ワークフローの最初のステップは同じ（仮説の確定）なので、初期の作業を引き継げます。medium → heavy の場合も同様です。スコープの縮小はより困難です（ひな型の準備にすでに投資しているため）。ワークフローをやり直すのではなく、成果物を削減してください。

プロジェクトのひな型はスキルの外部に配置

スキルは ~/.claude/plugins/.../analyst-research/ 内で読み取り専用のままです。プロジェクトごとの成果物はユーザーのプロジェクトディレクトリに保存されます。

light モードでは、スキルは _quarto-light.yml をコピーした _quarto.yml と、プロジェクト内の作業ファイル1つだけを作成します。サブフォルダーは作成しません。

medium モードでは、スキルは _quarto-medium.yml から作成した _quarto.yml、chart_template を読み込むための sys.path インジェクターである 5_scripts/_path.py、および最小限の番号付き出力ディレクトリを作成します。

heavy モードでは、スキルは analyst-research/ フォルダー全体をローカル作業コピーとしてプロジェクトのルートにコピーし、その後、workflow_heavy.md §11 に従って10個の番号付きディレクトリからなる完全なひな型を作成します。これにより、配色、フォント、分野ごとの慣例など、プロジェクトレベルのオーバーライドをスキルに影響させずにローカルコピー内に配置できます。

スキルの進化

各プロジェクトの終了後、モード固有のワークフローファイルの振り返りセクション（workflow_heavy.md §9、workflow_medium.md §8、workflow_light.md §6）に従って、プロジェクトで得た知見のうち、スキル自体に反映するものを決定してください。スキルは Git でバージョン管理されており、反映のたびにマイナーバージョンを上げます。アーキテクチャに大きな変更を加える場合は、メジャーバージョンを上げます。

言語ポリシー

このスキルは、マーケットプレイスの慣例に従い、英語と中国語のバイリンガルです。作成するドキュメントはすべて、英語版の .md（例：SKILL.md、references/workflow_heavy.md）と中国語版の .zh.md（例：SKILL.zh.md、references/workflow_heavy.zh.md）の2つのファイルで管理します。英語版が唯一の信頼できる情報源であり、.zh.md は独立したバージョンではなく、同期された翻訳です。 例外なく、次の編集手順に従ってください。必ず先に英語版の .md を作成または変更し、その後、同じ変更セット内でその変更を中国語版の .zh.md に反映してください。 中国語版だけを編集してはならず、2つのファイルの内容に食い違いが生じないようにしてください。表現が異なる場合は、英語版の .md を優先します。

1. 会話での返信はユーザーのチャット言語に合わせます。 英語でのチャットには英語で、中国語でのチャットには中国語で返信します。他の言語についても同様です。これは実行時の動作であり、保存される成果物には適用されません。
2. レポートの言語は、特に指定がなければ英語です。 ステップ0／オンボーディングでは、モードが決まった後に「レポートの言語は英語（デフォルト）ですか、それとも別の言語ですか？」と簡潔に確認します。ユーザーが指定しない場合は英語で下書きを作成し、別の言語を指定した場合はその言語で作成します。選択した言語は、プロジェクトの CLAUDE.md に記録します。これは、以前の「下書きの言語は仮説の言語に合わせる」というルールに優先します。
3. 言語に応じた grep のレッドライン。 英語のレポートでは、中国語のコロン比率に関するレッドラインは適用せず、エスケープされていない $ に関するレッドラインを必須とします（金額のドル記号は \$ としてエスケープします）。中国語のレポートでは、その逆とします。

このファイルの中国語版は SKILL.zh.md です。中国語版は SKILL.zh.md を参照してください。