mcpField
C
case-study-writer

case-study-writer

github.com/victor-shulgaマーケティング・グロース040 回インストール3 週間前に更新
リポジトリ

case-study-writer について

営業・マーケティング資料を作るチーム向けに、12セクション構成の顧客事例を作成するスキルです。検証可能な成果、顧客承認済みの引用、機密性の確認を重視し、1ページ資料や LinkedIn 執筆への引き継ぎにも対応します。

主な機能

  1. 0112セクションで事例を構成
  2. 02プロジェクトと成果の根拠を収集
  3. 03数値不足時にプレースホルダーを使用
  4. 041ページ資料と LinkedIn 引き継ぎに対応
  5. 05ビジュアルと公開前チェックリストを用意

活用シーン

  1. 01インタビュー記録からウェブ事例を作成
  2. 02情報不足時に SME 質問票を準備
  3. 03提案用の1ページ資料に事例を要約
  4. 04LinkedIn 執筆プロセスへ事例の要点を渡す

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/victor-shulga/account-management-skills --skill case-study-writer

インストール後、Claude Code で/case-study-writerを入力して読み込まれたか確認します。

詳細

導入事例ライター

Case Study Kit の構成に沿って導入事例を作成します。これは標準の12セクション形式で、結果を先に示し、60秒で読み取れる構成です。導入事例は営業担当者のように、形容詞ではなく、数値と一連の意思決定で次の見込み客を説得します。

このスキルで作成できるもの

  1. Webサイトの導入事例ページ — ビジュアル用のマーカーをインラインで入れた12セクションの全文。CMSにそのまま登録できます。
  2. 1枚ものの概要 — 提案書に添付するPDF向けに要約したセクション。
  3. LinkedInへの引き継ぎ用 — 投稿作成プロセスに渡す、投稿用の要約。
  4. 要望に応じて、SMEインタビュー用質問票(まだ何も書かれていない場合)、デザイナー向けビジュアル概要、公開前チェックリストも作成します。

作業言語:ユーザーに合わせます。導入事例の言語:クライアントの市場に合わせます(不明な場合は確認してください。通常は英語です)。最初に必要な出力形式を尋ねます(既定値=Webサイトのページ)。

厳守事項

  • 捏造しない。 すべての数値は、ユーザーまたは提供資料から取得します。不足している数値には、見える形で [[уточнити: X]] のプレースホルダーを挿入し、すべてのプレースホルダーを最後に列挙します。指標、引用、期間を決して作り出さないでください。
  • 結果がなければ、導入事例にしない。 測定可能な成果がまだない場合は、その旨を伝え、影響を誇張する代わりに、以下の「弱い数値モード」を提案します。
  • 各セクションは150語以内。 60秒で読み取れるようにします。目標は「2000語」ではなく、明確さです。営業につながらないセクションは削除してください。
  • 成果 ≠ アウトプット。 結果はビジネス上の変化(導入前 → 導入後)です。機能は提供したものです。決して混同しないでください。
  • クライアントの機密保持/NDA。 クライアントの名前やロゴを使用してよいか確認します。使用できない場合は、匿名化します:「米国の従業員120人のMEPエンジニアリング企業」— 業界、規模、地域のみを記載し、名前は出しません。スクリーンショットに含まれるNDA対象データは、ぼかすか匿名化してください。公開してはいけない情報(数値、名前)を確認します。
  • 引用は提供資料からの一字一句そのままのものに限ります。 意味を変えない範囲で、文法を軽く整えることはできます。引き出し引用を最低2つ(1つは課題、1つは結果のセクション)と、全文の推薦コメントを1つ含めます。
  • CTAは必須で、疑問文で締めくくります。CTAがない導入事例は見込み客を逃します。
  • AIらしい決まり文句や否定形の対比は使わない。(«не X, а Y» は禁止。「最先端」「シームレス」「画期的」も禁止です。)能動態、過去形、具体的な表現を使います。仕上げに anticopywriting-ai を実行します。
  • 公開前に、すべての数値と名前をSMEの回答と照合して事実確認します。

Step 1 — ヒアリング(SME向け質問票 → 12 セクション)

ユーザーにメモや通話の文字起こしがある場合は、まずそこから回答を抽出し、不足分だけを尋ねます。何も書かれていない場合は、この質問票を出力します(提供チームまたはクライアントと45~60分の面談で回答してもらい、その後に進めます)。自由回答形式で尋ね、必ず数値を確認します。「正確な数値はわからない」と言われたら、範囲や概算を尋ねます。

  • A · クライアントの背景(→セクション2、3)— 会社の事業内容、市場/地域、従業員数、他社との違い、関係者は誰だったか(氏名ではなく役職)、契約形態、期間、当社チームの構成。(自分で調査できます。)
  • B · 課題(→セクション4)— 必要としていたビジネス上の成果と、そのタイミングで必要だった理由(期限、投資家、競合他社)、最も難しかった技術面の要素(レガシーシステム、統合、負荷、データ)、デリバリー上の課題(スケジュール、チーム、不安定な要件、タイムゾーン)、解決しなかった場合のコスト、過去の試み/他社ベンダーと失敗した理由。
  • C · 当社を選んだ理由とアプローチ(→セクション5)— 競合他社や社内対応ではなく当社を選んだ理由、どのように始まったか(ディスカバリー/ワークショップ/監査)、主なマイルストーンと日付(第0週 → リリース)、進行中に変わったこと(スコープ、優先順位)。
  • D · ソリューション(→セクション6)— 3つの課題(ビジネス/技術/デリバリー)それぞれをどのように解決したか、主なアーキテクチャ/プロダクト上の決定とその理由、意図的なトレードオフ(スコープの削減、MVPへの集中)、ソリューションを最もよく表す画面/フロー(→デザイナー)。
  • E · 成果 — 数値必須(→セクション7)— 主な成果指標と数値(必須)、3~4つの指標の導入前 → 導入後(時間、費用、コンバージョン、ユーザー数、成長率)、ビジネス上の成果(売上、資金調達、コスト削減、スピード、リテンション)、クライアントが今できるようになったこと、ローンチ後のデータ(3か月/6か月)。
  • F · 成果物(→セクション8)— リリースした主な機能/モジュール4~6個、クライアントが最も評価していること。
  • G · 技術(→セクション9)— 技術スタック全体(フロントエンド、バックエンド、インフラ、統合、AI/データ)、これらの技術を選んだ理由。
  • H · 推薦コメント(→セクション4、7、10)— クライアントから公式な推薦コメント、氏名/役職/ロゴを提供してもらえるか、当社を推薦する理由を一文で、社名を公開できるか、または匿名化するか(NDA)。
  • I · 法務/メディア — 公開できない情報(NDAの対象となる数値、氏名、画面)、利用可能なブランド素材(ロゴ、チーム写真、プロダクト画面)。

Step 2 — 主軸を見つける

執筆前に、この事例は誰に何を売り込むのかを一文で述べます。ターゲット読者(過去のクライアントではなく、次の見込み顧客)にとって重要な成果を1つ選びます。それ以外はすべて、その成果を裏付ける内容にします。プロジェクトで多くの成果が得られた場合は、金銭またはリスクに最も直結するものを先に提示します。

ステップ 3 — 執筆(ウェブサイト形式・12 セクション、順序厳守)

各ソリューションを対応する課題に 1 対 1 で結び付けます。ひとつのストーリーとして、読者が課題 → 当社を選ぶ理由 → 実施内容 → 成果の順に読み進められるようにし、各セクションが次のセクションへつながるようにします。ビジュアルのプレースホルダーは文中に記載します (デザイナー向けです)。

  1. タイトル+主要指標 — [実施内容] + [主要な数値]。「X をどう構築したか」は不可。 例:「8 週間で MVP をリリース → 初の有料顧客 100 社とアクセラレーターからの資金 3 万ドルを獲得」。 数値は必須です。
  2. 概要スナップショット [SNAPSHOT] — タイトルのすぐ下に、ひと目で把握できるパネルを配置します: 業界 · 所在地 · チーム規模 · 契約形態 · 期間 · 技術スタック · 主要な成果。
  3. クライアントについて — 2~3 文で、事業、業界、市場での位置付け、従業員数を説明します。 冗長な説明は不要です。どのような企業で、なぜ信頼に値するのかを伝えます。
  4. 課題 — 3 つのサブブロックで構成します:
    • ビジネス上の課題 — 解決するビジネス上の問題。
    • 技術的な課題 — 技術面で最も難しかったこと。
    • デリバリー上の課題 — チーム/プロセス/スケジュール上の課題。 ここに、課題についての最初の引用文を挿入します [QUOTE]。何もしなかった場合のコストを明示します。
  5. 当社を選んだ理由+アプローチ — 選定理由と進め方を記載します:ディスカバリー → スプリント → 主要なマイルストーン。短いタイムラインを示します(第 0/2/6/8 週)。「なぜ信頼できるのか」という疑問に答えます。
  6. ソリューション → 課題と 1 対 1 で対応 — 各ソリューションで、解決する課題を明示します:
    • ソリューション → ビジネス上の課題: … [SCREEN]
    • ソリューション → 技術的な課題: … [DIAGRAM]
    • ソリューション → デリバリー上の課題: … 機能は切り離されたリストにせず、ここで自然に説明します。技術的な手順もここに記載します。このセクションと競合する独立した「アプローチ」セクションは設けません。事例の中で最も長いセクションにします(400~500 語)。
  7. 成果とビジネス価値 — 「ダッシュボードを構築した」ではなく、数値を使って導入前 → 導入後を示します [METRIC]。表:指標 · 導入前 · 導入後。その後、成果についての 2 つ目の引用文を入れます [QUOTE]。期間を明記します。
  8. 提供した機能 — リリースしたものを簡潔に列挙します(4~6 項目)。アウトプット ≠ アウトカムです。「成果」と混同しないでください。
  9. 技術スタック [STACK] — フロントエンド、バックエンド、インフラ、インテグレーション(ロゴ/リスト)。
  10. お客様の声(全文) [QUOTE] — 2~4 文の引用文に、氏名、役職、写真/ロゴを添えます。ROI または信頼について述べた最も力強いコメントを選び、成果の後に配置します。
  11. CTA — 同じ課題を抱える読者に向けた行動を 1 つ提示し、疑問文で締めくくります。 「同じような課題に直面していますか? → 打ち合わせを予約してください。」
  12. SEO/メタデータ — 対象キーワード(H1 と冒頭 100 語に含める)、メタタイトル(60 文字以内)、メタディスクリプション(155 文字以内)、すべてのビジュアルの代替テキスト、関連する事例/サービスへの内部リンク。

文体:淡々と具体的に、最上級表現は一切使いません。

文字数は希望ではなく必須条件です。 本文は 1500~2000 語。1200 語未満では事例ではなくプロジェクト紹介カードです。その場合は公開せず、事実を確認するため SME に再度問い合わせてください。セクションごとの目安:

セクション語数
タイトル+数値25
スナップショット60
クライアントについて120
課題250
当社を選んだ理由+アプローチ250
ソリューション400~500
導入前 → 導入後の成果200
提供した機能120
技術スタック80
お客様の声80
CTA40

文中の引用文 2 つでさらに約 60 語を加えます。ソリューションを最も長いセクションにしてください。 課題より短い場合、事例が作業内容ではなく問題の説明に終始しています。40 語程度のセクションでは内容が不十分に見えます。実際の判断や背景を加えて各セクションを充実させ、冗長な部分だけを削ってください。

数値が乏しい場合

クライアントが具体的な数値を開示できない場合(NDA、または導入前の数値を測定していない場合):

  • 運用面の変化を主軸にします:「3 つのツールと手作業でのコピー&ペーストから、ひとつのパイプラインへ」「これまで成果がゼロだったチャネルから初の SQL を 5 件獲得」など。
  • クライアントと合意した範囲や比率を使います(「約 2 倍高速化」「4 週間未満」など)。
  • 定性的な主張を指標のように見せてはいけません。

ステップ 4 — 派生フォーマット

  • 1ページ資料:見出し · 3つの統計タイル · 課題(2行) · ソリューション(3つの箇条書き) · 結果 (2行) · 引用 · 連絡先。1ページに収まります。
  • LinkedIn 引き継ぎ資料:5~7行の要約(フック候補 + 主要な数値 + 意外性のある詳細を1つ)。投稿作成プロセスへのINPUTであり、完成した投稿ではないことを明示してください。

ステップ 5 — デザイナー向けブリーフ(ビジュアルマーカー)

ドラフトに残された各マーカーは、制作するビジュアルを示します。

マーカー制作内容
[HERO]冒頭のヒーロービジュアル:利用状況が分かる製品画像 + バッジ形式の主要指標
[SNAPSHOT]一目で分かるパネル(アイコン:業界 / チーム / 期間 / 技術スタック)
[BEFORE/AFTER]導入前後の比較(指標または UI)
[DIAGRAM]アーキテクチャ / フロー / プロセス
[SCREEN]デバイスフレームに表示した製品画面。クリーンで高解像度
[METRIC]結果セクション用の大きな数値タイル
[STACK]横一列に並べたテクノロジーのロゴ
[QUOTE]クライアントの写真 / ロゴを添えた引用カード

デザイン要件:代理店のブランドカラー / フォント、画面の背景は白、実際のプロジェクト画面(NDA 対象の場合はぼかす / 匿名化)を使用し、ストックのモックは使わないこと。モバイルでのコントラストと可読性を確保すること(トラフィックの大半はスマートフォンから)。すべてのビジュアルに代替テキストを付けること。WebP 形式でエクスポートして最適化し、遅延読み込みを有効にし、可能な限り 200KB 以下にしてください。

ステップ 6 — 公開前チェックリスト

  • 見出しに数値が含まれている
  • スナップショットパネルが記入されている
  • 各課題に対応するソリューションがある(1対1)
  • 結果が数値を含む導入前→導入後の形式になっている
  • 本文が1500語以上で、ソリューションが最も大きなセクションになっている
  • 引用が2つ以上あり、完全な推薦コメントが1つある
  • CTA があり、クリックでき、疑問文で終わっている
  • すべての [markers] が最終ビジュアルに差し替えられている
  • 数値 / 名前 / 画面について法務承認を得ている(特に NDA 対象)
  • SEO:メタタイトル / 説明文、キーワード、代替テキスト、内部リンク
  • anticopywriting-ai でチェックする(AI の痕跡なし、否定的な並列構文なし)
  • モバイルで確認する
  • すべての数値の出典を記載するか、[[уточнити]] と記す — プレースホルダー一覧を最後に掲載する
  • 公開版から内部向けセクション / 参考文献セクションを削除する

コメント