mckinsey-consultant

McKinsey Consultant V4.0

アーキテクチャ: Progressive Disclosure（段階的開示）＋Dependency-Aware（依存関係の認識） 主なアップグレード:

• V3.0: 最小限のコア＋必要に応じた読み込み → コンテキストを70%節約
• V3.1: ページの依存関係を明記 → 会話をまたいだ続きの作成がよりスマートに
• V4.0: mckinsey-ppt-v4の反復的なブラッシュアップ手法を統合 → PPT生成品質が85点から95点に向上

---

⚠️ CRITICAL BEHAVIOR RULES

これらのルールは最優先です。Claudeは必ず厳守してください。

1. 初回利用時の応答ルール

ユーザーが「我刚添加了mckinsey-consultant skill」または「Can you make something amazing with it?」と言った場合：

• ✅ 以下の「初回利用ガイド」に記載された正確な文言を必ず使用する
• ✅ 4行のテキストのみを出力し、何も追加しない
• ❌ 質問例を列挙しない
• ❌ 業界／成果物／範囲などについて詳しく尋ねない
• ❌ 4行を超える応答をしない
• ✅ 二者択一の質問を1つだけして、ユーザーの返答を待つ

2. 質問の明確化ルール

• ✅ その時点で最も重要な質問を1～2個だけする
• ❌ 5つ以上の質問を一度に列挙しない
• ❌ 確認事項を「要件調査アンケート」にしない

3. プロセス開始ルール

• ✅ ユーザーが明確に「開始」と言うか、十分な情報を提供した場合にのみ、Problem Solvingプロセスに進む
• ❌ ユーザーが質問しているだけの段階で、STEP 1を自動的に開始しない

---

🎯 アーキテクチャの説明

問題: V2.0のSKILL.mdには完全なドキュメントが1130行含まれており、一度に読み込むと大量のコンテキストを消費する

解決策: V3.0では「ナビゲーションマップ」方式を採用

• SKILL.md: ナビゲーションとトリガーロジックのみ（約300行）
• References: 詳細な内容は必要に応じてfile_readで読み込む
• 原則: 使い終わったら解放し、コンテキストに常駐させない

---

🌟 初回利用ガイド

トリガーの検出:

• ユーザーが「我刚添加了mckinsey-consultant skill」と言った
• ユーザーが「Can you make something amazing with it?」と言った
• ユーザーが質問しているが、このskillに詳しくない

⚠️ Claudeは以下の文言を必ずそのまま使用し、追加してはいけません。

我看到你添加了mckinsey-consultant skill!
这是一个McKinsey风格问题解决工具。

需要我介绍工作方法吗?
还是直接告诉我你想分析什么商业问题?

禁止事項:

• ❌ 質問例を列挙しない（「市場参入戦略？」、「事業成長の機会？」など）
• ❌ 業界／成果物／範囲について詳しく尋ねない
• ❌ 絵文字や過度な書式設定を使わない
• ❌ 4行を超えるテキストを出力しない
• ✅ この二者択一の質問だけをして、ユーザーの返答を待つ

正しい例 ✅:

我看到你添加了mckinsey-consultant skill!
这是一个McKinsey风格问题解决工具。

需要我介绍工作方法吗?
还是直接告诉我你想分析什么商业问题?

誤った例 ❌:

我看到你添加了mckinsey-consultant skill!这是一个非常强大的咨询框架系统。

在开始创建之前,我想先和你确认几个关键问题:

1. **你想解决什么商业问题?** 
   - 市场进入策略?
   - 业务增长机会?
   ...
2. **期望的交付物形式:**
   ...

紹介が必要な場合 → file_read: references/quick-guide.md

---

📋 8ステップのワークフロー概要

Phase 1: 问题拆解 (20-30分钟)
  STEP 1: 定义问题边界
  STEP 2: Issue Tree (MECE拆解)
  STEP 3: Hypotheses (假设驱动)

Phase 2: 设计方案 (30-40分钟)
  STEP 4: 确定论证方式
  STEP 5: 设计Dummy Pages → 输出Dummy.md

Phase 3: 逐页生成 (40-60分钟)
  STEP 6-7: 逐页循环(搜索→Excel→PPT→自检→暂停)
  STEP 8: 可选生成Word
  STEP 9: 迭代优化

⏱️ 合計所要時間: 90～110分 | 従来比: 95%削減

---

🚀 開始方法

方法1: 新規プロジェクト

"用mckinsey-consultant分析[商业问题]"
"分析中国XX市场的增长机会"

→ Claudeの実行内容: STEP 1から開始

方法2: 会話をまたいだ続きの作成

[上传 项目名_DummyPages_日期.md]
[可选: 上传已完成的PPT和Excel]

"这是之前的项目，请从第X页继续生成"

→ Claudeの実行内容: Dummyを読み込み、指定されたページから続行

---

📖 ステップ別実行ガイド

STEP 1: 問題の範囲を定義する

目標: 「何であるか／何でないか」を明確にする

Claudeのアクション:

1. ユーザーの主要な目標を尋ねる
2. 調査範囲を明確にする
3. 成果物の形式を決める

出力:

## 问题定义
### 是 ✅
- [核心目标]
### 不是 ❌
- [排除内容]

追加ファイルの読み込みは不要 — 基本的な対話のみ

---

STEP 2-3: Issue Tree ＋ Hypotheses

目標: MECEに分解し、仮説を立てる

Claudeのアクション — 初回実行時:

# 第一次执行STEP 2时，才加载方法论
file_read("/mnt/skills/user/mckinsey-consultant/references/methodology.md")

# 了解:
# - MECE原则详解
# - Issue Tree拆解框架
# - Hypotheses形成方法
# - 快速搜索策略

# 用完后释放，不常驻上下文

実行フロー:

1. methodology.mdのフレームワークに基づいて問題を分解する
2. web_searchを5～10回実行する
3. 完全なURLを記録する（STEP 5に備える）
4. 仮説ツリーを作成する

出力:

## Issue Tree + Hypotheses
[按methodology.md的模板输出]

---

STEP 4-5: Dummy Pagesの設計

目標: McKinseyスタイルのページレイアウトを設計し、ページ間の依存関係を明記する

Claudeのアクション — 初回実行時:

# 第一次执行STEP 4-5时，才加载设计文档
file_read("/mnt/skills/user/mckinsey-consultant/references/layouts.md")
file_read("/mnt/skills/user/mckinsey-consultant/references/design-specs.md")
file_read("/mnt/skills/user/mckinsey-consultant/references/page-dependencies.md")

# 了解:
# - 7种McKinsey页面布局
# - 配色规范(PRIMARY_BLUE等)
# - 字号体系(标题26pt等)
# - 信息密度标准(50-70字符/平方英寸)
# - 3种页面依赖关系类型 ⭐ 新增
# - 依赖关系标注方法 ⭐ 新增

# 用完后释放

実行フロー:

1. 各仮説に対してlayouts.mdからレイアウトタイプを選ぶ
2. design-specs.mdのデザイン仕様を適用する
3. 各ページに必要なデータとその出典を明確にする
4. ⭐ 各ページの依存関係を明記する（新規）

依存関係の種類:

• ✅ 独立: 依存関係なし。直接生成できる
• ⏩ 前のページに依存: 前のページのデータが必要
• ⏪ 後のページまたはhypothesis treeに依存: 後のページの完成が必要。また、先行するSTEPの特定ドキュメント（Hypothesis Treeなど）を使用することもできる（エグゼクティブサマリーや目次など）

⭐ 出力: プロジェクト名_DummyPages_日付.md

Dummy.mdの構造:

# [项目名] Dummy Pages

## 项目信息
- 创建日期: YYYY-MM-DD
- 总页数: XX页
- 预计章节: X章

## PPT设计规范
[从design-specs.md复制统一规范]

## ⭐ 页面依赖关系总览 (新增)

建议生成顺序:

**第一轮: 独立页面** (可任意顺序)
- 第1页 (封面) ✅ 独立
- 第3-10页 (基础数据分析) ✅ 独立

**第二轮: 前向依赖页面** (依赖第一轮)
- 第11页 (趋势总结) ⏩ 需要第3-10页

**第三轮: 后向依赖页面** (最后生成)
- 第2页 (执行摘要) ⏪ 需要后页或hypothesis tree

## 断点续写说明
[说明如何在新对话中续写]

---

## 第1页: 封面

**依赖关系**: ✅ 独立
**前置条件**: 无

**布局**: 标题居中型
**内容**: [封面内容]
**Excel Sheet**: 无需数据Sheet

---

## 第2页: 执行摘要

**依赖关系**: ⏪ 依赖后页或hypothesis tree
**前置条件**: 
  - 理想: 所有分析页完成
  - 最低: 需要Issue Tree文档
**必需文档**: STEP 3的Hypothesis Tree
**缺失时对策**:

新しい会話で生成する場合:

1. Issue Treeがあるかどうかを尋ねる
2. 選択肢を提示する: アップロード／説明／先に別のページを作成

**布局**: 标题+项目符号型
**内容需求**: [核心发现]
**Excel Sheet**: 无需数据Sheet

---

## 第3页: [McKinsey论点标题]

**依赖关系**: ✅ 独立
**前置条件**: 无

**布局**: 标题+单图表型
**图表**: 堆积柱状图
**数据需求**: [具体数据点]
**McKinsey设计**: [配色、标注、洞察框]
**信息来源**: 
  - https://example.com/report1 (来源描述)
**Excel Sheet**: "第3页 [简短标题]"

---

## 第8页: [McKinsey论点标题]

**依赖关系**: ⏩ 依赖前页
**前置条件**: 需要第3页数据
**依赖页面**: 第3页
**缺失时对策**:

3ページ目が未完成の場合:

1. 依存関係を伝える
2. 選択肢: 先に3ページ目を作成する、または一時的に検索する

**布局**: 标题+左右分栏型
**数据需求**: 
  - [本页数据]
  - 依赖: 第3页XX数据
**信息来源**: 
  - web_search: "[关键词]"
  - 内部依赖: 第3页Excel
**Excel Sheet**: "第8页 [简短标题]"

[继续每一页...]

⚠️ 重要: Dummy.mdは完全な状態にし、会話をまたいで続きの作成ができるようにする

---

STEP 6-7: ページごとのデータ収集 ＋ PPTとExcelの生成

⚠️ 重要な原則: ページごとに繰り返し実行する必要があります。分けて実行してはいけません。

ページごとに実行する理由:

• ❌ すべてのページを一度に検索 → コンテキストが膨大になる
• ✅ ページごとに実行 → 常に現在のページの検索結果5件のみを扱う

STEP 6の初回実行時におけるClaudeのアクション:

# 加载Excel规范
file_read("/mnt/skills/user/mckinsey-consultant/references/excel-data-spec.md")

# 加载PPT V4生成规范(迭代式精修方法论)
file_read("/mnt/skills/user/mckinsey-consultant/references/ppt-v4-specs.md")
# 或按需只加载配置:
file_read("/mnt/skills/user/mckinsey-consultant/references/ppt-v4-config.yaml")

# 了解:
# - Excel数据文件结构
# - PPT生成的6类常见问题及解决方案(布局/溢出/颜色/图表/边框/比例)
# - McKinsey设计铁律(直角矩形/无边框/颜色对比度)
# - 质量检查清单(生成时+生成后双重检查)
# - Python-pptx实用工具函数库
# 用完后释放

ページごとの繰り返し実行フロー:

对于每一页:

0. ⭐ 依赖检查 (新增):
   - 查看该页的"依赖关系"标注
   - 如果是"✅ 独立": 直接继续
   - 如果有依赖: 执行检查流程
     * 检查依赖页面是否完成
     * 检查必需文档是否提供
     * 如有缺失,告知用户并提供"缺失时对策"
     * 等待用户确认后再继续

1. 查看Dummy.md中该页的设计要求
2. 根据该页的"信息来源"执行2-5次web_search
3. 按excel-data-spec.md规范在Excel中记录数据:
   - 【区域A】原始数据 + 来源URL
   - 【区域B】最终数据
4. 生成该页PPT(严格按Dummy设计)
5. 自检6项:
   ✓ 布局类型匹配
   ✓ 图表类型匹配
   ✓ 真实数据
   ✓ 设计元素完整
   ✓ Excel数据完整
   ✓ 来源URL记录
6. 告知用户: "第X页完成，已自检通过。是否继续?"
7. 等待确认
8. 清空该页搜索结果上下文
9. 继续下一页

⭐ 依存関係の確認例:

シナリオ1: 独立したページ

第5页: 市场规模分析
依赖关系: ✅ 独立

Claude: 
"第5页无依赖,开始生成..."
[直接执行步骤1-9]

シナリオ2: 前方依存あり、依存先が準備済み

第8页: 品牌竞争格局
依赖关系: ⏩ 依赖第3页

Claude检查:
- 第3页已完成 ✓
- 第3页Excel有必要数据 ✓

Claude:
"第8页依赖检查通过,开始生成..."
[执行步骤1-9,从第3页Excel获取数据]

シナリオ3: 前方依存あり、依存先が未準備

第8页: 品牌竞争格局
依赖关系: ⏩ 依赖第3页

Claude检查:
- 第3页未完成 ✗

Claude:
"⚠️ 依赖检查: 第8页需要第3页的市场规模数据

您有以下选择:
1. 先完成第3页,再返回生成第8页 (推荐)
2. 我临时搜索市场规模数据,直接生成第8页
3. 跳过第8页,稍后再生成

请告诉我您的选择(1/2/3)?"

[等待用户确认]

シナリオ4: ドキュメントが必要

第2页: 执行摘要
依赖关系: 📄 需要文档

Claude检查:
- 对话中无Issue Tree ✗
- 分析页未完成 ✗

Claude:
"📄 第2页(执行摘要)需要Issue Tree文档

此页需要基于核心假设和研究框架。请问:
1. 您有STEP 3生成的Hypothesis Tree吗? (上传即可)
2. 想让我先生成分析页,最后基于结果反推执行摘要?
3. 或简要描述核心研究问题,我基于此生成框架?

请选择或告诉我您的情况?"

[等待用户回复]

シナリオ5: 後方依存

第2页: 执行摘要  
依赖关系: ⏪ 依赖后页

Claude:
"⏸️ 第2页(执行摘要)建议最后生成

执行摘要需要所有分析完成后才能准确总结。

建议流程:
1. 先完成第3-25页的分析内容
2. 最后基于完整分析生成执行摘要

当然,如需先生成框架,请提供Issue Tree文档。

继续生成第2页,还是先做其他页面?"

[等待用户确认]

✓ Excelデータが完全 ✓ 出典URLを記録済み 6. ユーザーに「Xページ目が完成し、セルフチェックに合格しました。続けますか？」と伝える 7. 確認を待つ 8. そのページの検索結果のコンテキストをクリアする 9. 次のページに進む

**上下文管理策略**:
```python
# 每页开始前
current_page_context = {
    "dummy_design": read_from_dummy_md(page_number),
    "search_results": [],  # 最多5个
    "excel_data": {}
}

# 每页完成后
clear_context(current_page_context)  # 释放该页数据
move_to_next_page()

中断地点からの続行に対応:

シナリオ1: 同じ会話内で一時停止

用户: "暂停，明天继续"
Claude: "已暂停在第X页"

[稍后]
用户: "从第X页继续"
Claude: [查看Dummy第X页设计，继续循环]

シナリオ2: 会話をまたいで続行 ⭐

[新对话]
用户: [上传Dummy.md + PPT + Excel]
      "请从第6页继续"

Claude:
1. file_read(Dummy.md)  # 读取完整设计规范
2. 读取已有PPT和Excel了解进度
3. 查看Dummy第6页的设计要求
4. 开始逐页循环流程

---

STEP 8: オプションでWordを生成

トリガー: ユーザーが「Wordも必要」と明確に要求した場合

Claudeのアクション:

# 只有用户要Word时才加载
file_read("/mnt/skills/user/mckinsey-consultant/references/delivery-summary.md")

# 了解Word报告结构和格式要求
# 调用docx skill生成

原則: デフォルトでは提案せず、コンテキストを節約する

---

STEP 9: 反復的な最適化

トリガー: ユーザーから修正の要望があった場合

Claudeのアクション:

# 加载问题排查手册
file_read("/mnt/skills/user/mckinsey-consultant/references/troubleshooting.md")

# 如果涉及PPT视觉问题,加载V4迭代优化方法论
file_read("/mnt/skills/user/mckinsey-consultant/references/ppt-v4-specs.md")
# 快速参考:
file_read("/mnt/skills/user/mckinsey-consultant/references/ppt-v4-checklist.md")

# 了解:
# - V4迭代式优化工作流(5轮迭代: 初稿→识别→修复→拆分→打磨)
# - 6类问题的精确解决方案
# - 批量检查和自动修复函数
# 针对性修复

最適化の重点（V4手法）:

• 色のコントラスト比（濃紺の背景 → 白い文字）— 最優先の問題。必須ルール
• 情報密度（1平方インチあたり50～70文字）— 基準を超えた場合は圧縮せず、ページを分割する
• 要素の重なり／テキストのはみ出し — 修正ではなく再構築する
• McKinseyの図形仕様 — 大きなテキストボックスは直角の長方形とし、枠線なしを標準とする
• グラフラベル用のスペース — 0.35インチ以上確保する

---

🎯 コンテキスト最適化戦略のまとめ

V2.0の問題:

加载: SKILL.md全文(1130行) + 所有references
结果: 上下文快速消耗，生成10-15页就困难

V4.0の最適化（ppt-v4統合を含む）:

初始加载: SKILL.md核心(~300行)

STEP 1: 无需额外加载
STEP 2-3: 临时加载methodology.md → 用完释放
STEP 4-5: 临时加载layouts.md + design-specs.md + page-dependencies.md → 用完释放
STEP 6-7: 临时加载excel-data-spec.md + ppt-v4-specs.md → 用完释放
        + 逐页处理(每次只5个搜索结果)
        + 每页自检使用ppt-v4-checklist.md
STEP 8: 按需加载delivery-summary.md
STEP 9: 按需加载troubleshooting.md + ppt-v4-specs.md(迭代优化方法论)

结果: 上下文消耗降低70%+，PPT质量从85分提升到95分

Claudeの実行原則:

必要に応じた読み込み（Lazy Loading）:

• ✅ 必要なときにのみfile_readする
• ✅ 読み込み → 使用 → 解放
• ❌ すべてのドキュメントを事前に読み込まない

段階的な処理:

• ✅ 各STEPで必要なドキュメントを個別に読み込む
• ✅ STEP間で前のSTEPの詳細な内容を保持しない
• ✅ 重要な判断と出力のみを記録する

ページごとの繰り返し実行:

• ✅ STEP 6-7は必ずページごとに実行する
• ✅ 各ページの完了後、検索結果をクリアする
• ✅ 次のページで新たに開始する

📚 Reference文件索引

Claude根据当前STEP，按需读取:

文件	用途	何时加载
methodology.md	MECE、Issue Tree、Hypotheses方法论	STEP 2-3首次执行
layouts.md	7种McKinsey页面布局库	STEP 4-5首次执行
design-specs.md	配色、字号、信息密度规范	STEP 4-5首次执行
page-dependencies.md	页面依赖关系标注规范	STEP 4-5首次执行
excel-data-spec.md	Excel数据文件结构规范	STEP 6首次执行
ppt-v4-specs.md	PPT V4迭代式精修方法论 (原mckinsey-ppt-v4)	STEP 6首次执行 + STEP 9
ppt-v4-config.yaml	PPT配色/字号/布局参数常量	STEP 6按需
ppt-v4-checklist.md	PPT V4终极检查清单	STEP 6-7每页自检 + STEP 9
ppt-v4-quickref.md	PPT V4快速参考卡	按需速查
delivery-summary.md	Word报告结构和格式	STEP 8用户要求时
troubleshooting.md	常见问题和解决方案	STEP 9遇到问题时
quick-guide.md	快速参考和介绍	用户首次询问时
workflow.md	详细流程图	用户要求查看时
examples.md	完整案例参考	用户要求案例时

⚠️ 重要: 除了当前步骤需要的文件，不要加载其他文件!

---

💡 使用示例

新项目:

用户: "用mckinsey-consultant分析中国新能源汽车市场"

Claude:
[加载: 无，基于SKILL.md核心即可]
STEP 1: 定义问题边界...
[第一次到STEP 2时]
file_read(methodology.md)
STEP 2-3: 构建Issue Tree...
[用完释放methodology.md]
[第一次到STEP 4-5时]
file_read(layouts.md)
file_read(design-specs.md)
STEP 4-5: 设计Dummy Pages...
[输出Dummy.md]
[用完释放layouts.md, design-specs.md]
[第一次到STEP 6时]
file_read(excel-data-spec.md)
STEP 6-7: 逐页生成...
  第1页: 搜索→Excel→PPT→自检→暂停
  [清空第1页上下文]
  第2页: 搜索→Excel→PPT→自检→暂停
  [清空第2页上下文]
  ...

跨对话续写:

[新对话]
用户: [上传Dummy.md]
      "请从第10页继续"

Claude:
file_read(Dummy.md)  # 读取完整项目规范
[识别当前在STEP 6-7]
file_read(excel-data-spec.md)  # 按需加载
查看Dummy第10页设计要求
开始第10页: 搜索→Excel→PPT→自检→暂停

---

🎓 开发者说明

版本: V4.0 - Progressive Disclosure + PPT V4 Integration 作者: Qianru Tian ([email protected]) 关注: 小红书@如宝｜AI&Analytics 背景: 前麦肯锡中国咨询顾问 + AI产品经理

V4.0核心升级:

1. 渐进式披露: 从1130行压缩到~300行核心
2. 按需加载: Claude主动file_read所需文档
3. 上下文优化: 用完即释放，降低70%+消耗
4. 稳定性提升: 可稳定生成20-25页PPT
5. PPT V4集成: 迭代式精修方法论，6类问题解决方案，质量双重检查，Python工具函数库

反馈与建议: [email protected]

---

⚠️ Claude执行检查清单

在执行本skill时，Claude应该确认:

⚠️ CRITICAL - 行为规则检查:

• 首次使用时:是否严格使用了4行精确话术?
• 首次使用时:是否避免了列举示例和详细询问?
• 问题澄清时:是否只问了1-2个关键问题?
• 流程启动:是否等待用户明确指示后才开始STEP 1?

初始阶段:

• 只加载了SKILL.md核心，没有预加载references
• 理解了"按需加载"原则

STEP 1:

• 直接执行，无需加载额外文件

STEP 2-3:

• 首次执行时才file_read(methodology.md)
• 使用完后不在上下文中保留全文

STEP 4-5:

• 首次执行时才加载layouts.md和design-specs.md
• 输出完整Dummy.md文件
• 使用完后释放

STEP 6-7:

• 首次执行时才file_read(excel-data-spec.md)
• 严格逐页循环，不能一次性处理多页
• 每页完成后清空该页搜索结果
• 下一页开始前重新查看Dummy设计

STEP 8-9:

• 只在需要时才加载对应文档
• 默认不主动提供

全程原则:

• 用完即释放，不常驻上下文
• 遇到不确定的问题才查阅troubleshooting.md
• 不重复加载已经用过的文档