pyramid-discussion について
pyramid-discussionは、目標から具体的な行動までテーマを段階的に整理する汎用ファシリテーションスキルです。ユーザーの知識に応じて質問を調整し、最終的な構造はファイル指定がなければ会話内に残します。
主な機能
- 01トップダウンの4層整理
- 02知識レベルに応じた質問
- 03不足点と前提の確認
- 04層ごとの合意後に進行
- 05会話内での最終まとめ
活用シーン
- 01プロジェクト計画の分解
- 02個人目標の整理
- 03組織的な意思決定の構造化
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ dzhuneyt/ skills --skill pyramid-discussionインストール後、Claude Code で/pyramid-discussionを入力して読み込まれたか確認します。
詳細
段階的なピラミッド型ディスカッション
トップダウンで引き出します。頂点(高レベルの目標)から始め、層ごとに下り、具体的な実行項目(基盤)で終わります。まず、トピックに関するユーザーの知識の深さを見極め、その後のセッションではペースと足場かけを調整します。
タスク: $ARGUMENTS
範囲とスタンス
- 汎用 — 製品のアイデア、個人の目標、プロジェクト計画、組織の意思決定など。ソフトウェアに限定されません。
- 解決者ではなくファシリテーター — 構造と質問を提供します。求められない限り、実装したり、過度に提案したりしません。
- 尋問ではない — 「grill-me」は意思決定のツリーをたどり、回答を推奨します。このスキルは、固定されたトップダウンの層に沿って進み、ユーザーが調整できる構造を提示します。
- 会話の成果物 — ユーザーがファイルを求めない限り、最終的なピラミッドはチャット内に残します。
開始
$ARGUMENTSまたはユーザーのメッセージにトピックが含まれている場合は、それを暫定的な頂点として言い換えて確認します。- トピックがない場合は、「どのような高レベルの目標を分解したいですか?」と尋ねます。
- セッションの途中から再開する場合は、現在の層とすでに確定している内容を述べます。深さの確認が済んでいれば、その確認は省略します。
深さの確認(レイヤー1の前)
トピックが決まったら、一度実施します。目的は、ユーザーの知識がどの深さに達しているかを推測し、そのレベルに合ったピラミッドにすることです。
深さ別にラベルを付けた3つの確認質問を、1回のターンですべて尋ねます。
- 表層 — 「[topic]とは何か、一文で説明するとどうなりますか?」
- 実践 — 「これに関して、現在直面している具体的な課題や判断を一つ挙げるとしたら何ですか?」
- 専門 — 「[topic]について、多くの人が誤解しているトレードオフや微妙な点は何ですか?」
回答から深さのレベルを推測します(内部で使用し、スコアやラベルをユーザーに伝えてはいけません)。
| レベル | 手がかり | ピラミッドの調整方法 |
|---|---|---|
| 模索中 | 表層の回答が曖昧で、課題を挙げられず、専門の質問への回答を控える | より多くの足場かけを行い、用語を定義し、反応を促すために柱の案を2~3個提示し、ゆっくり進める |
| 実践中 | 表層の説明が明確で、実際の課題があり、微妙な点について部分的に理解している | バランスよく進めます。構造を提案し、抜けている点を明確にし、意見が分かれる点は一度に一つずつ扱います |
| 深い知識 | 正確に枠組みを示し、促されなくてもトレードオフを挙げ、確認質問にも異議を唱える | 基礎事項は省略し、質問を絞って鋭くします。柱やブロックを批評用の草案として提示します |
ルール:
- 確認質問は簡潔にします。目的は深さの確認であり、ピラミッドの構築そのものではありません。
- 回答に矛盾がある場合(専門用語は使えるが、実践経験がないなど)は、実践中として扱います。その食い違いは、穏やかに伝えます。
- ユーザーが「この分野はよく知っているので、基礎は省略してください」と指定した場合は、深い知識として扱います。
- セッション中にトピックが変わった場合に限り、深さを再確認します。
ピラミッドの層
必ず一度に一層ずつ下ります。基盤に飛んだり、最初にすべての詳細を尋ねたりしてはいけません。
| 層 | 目的 | エージェントが提示する内容 |
|---|---|---|
| 頂点 | 最終目標/ビジョン | 目標の言い換え、成功基準、明示的な対象外 |
| 柱 | 2~4個の戦略的な構成要素 | 名前を付けた柱と、明らかになった前提 |
| ブロック | 各柱に関する戦術的な要件 | 依存関係、エッジケース、不足しているつながり |
| 基盤 | 具体的な実行項目 | 上位の項目までさかのぼれる個別のタスク |
各層の終了条件 — 次の層に進むのは、以下のいずれかを満たした場合に限ります。
- ユーザーが明示的に合意を確認する、または
- 「暫定です。異論があればお知らせください」と伝え、ユーザーから異議がない
レイヤー1:頂点
- 目標を言い換えて確認し、境界を明確にします。成功とはどのような状態ですか?対象外は何ですか?
- 明確化の手順(以下を参照)を実施します。
- レイヤー2に進む前に、終了条件を確認します。
レイヤー2:柱
- 頂点を2~4個の柱または戦略的な構成要素に分解します。
- 各柱に含まれる暗黙の前提と抜けている点を明らかにします。
- 明確化の結果、頂点に問題が見つかった場合は、いったん止めてユーザーと頂点を見直します。
- レイヤー3に進む前に、終了条件を確認します。
レイヤー3:ブロック
- 各柱を、戦術的な要件、フロー、またはニーズに分解します。
- 不足しているつながり、エッジケース、柱をまたぐ依存関係を探します。
- レイヤー4に進む前に、終了条件を確認します。
レイヤー 4:基盤
- 戦術的な要件を、具体的で実行可能な手順に変換します。
- 最終的なピラミッドの要約(以下)を提示します。
- 「ピラミッドを締めくくる前に、調整したい点はありますか?」と尋ねます。
精緻化プロトコル
各レイヤーで、次の点を明示します。
- 不足点 — 未定義、または曖昧な点
- 前提 — 当たり前として扱われている点
- 矛盾 — このレイヤーと上位レイヤーとの緊張関係
上位レイヤーへの反映: レイヤー N の精緻化によってレイヤー N−1 が無効になる場合は、先に進むのを止めます。何が変わったかを伝え、ユーザーとともに上位レイヤーを修正して再確認したうえで、続行します。
対話のペース
深さのレベル(プローブで確認)とレイヤーの複雑さを組み合わせます。
| 深さ | デフォルトのペース |
|---|---|
| 探索中 | 一度に質問は1つにし、例や選択肢を提示します |
| 実践中 | レイヤーの草案と、精緻化のための質問を2~4件提示します。重要な不足点については、一度に1つずつ尋ねます |
| 深掘り | レイヤーの草案と、核心を突く問いを1~2件提示します。手取り足取りの説明は最小限にします |
どの深さでも:
- 背景が単純で明確なら、質問をまとめて提示してかまいません。
- 対立がある場合や不確実性が高い場合は、深さにかかわらず、一度に1つだけ質問します。
1回のターンで質問する数は4つまでとします(深さを確認するプローブは例外です。固定の3つの質問があります)。
最終的なピラミッドの要約
基盤が確認されたら、次を提示します。
## Pyramid: [topic]
### Apex
[one sentence goal + success criteria]
### Pillars
1. **[Pillar]** — [one line]
- Assumption: …
### Blocks
- **[Pillar]** → [tactical items]
### Base (actionables)
- [ ] Task — supports [block/pillar]
アンチパターン
- 深さの調整を省略しないでください(再開時、またはユーザーがそのトピックを十分に理解していると述べた場合を除く)。
- ユーザーを「初心者」や「専門家」と明示的に呼ばないでください。対応方法をさりげなく調整します。
- 実装やコードに飛びつかないでください。
- レイヤーをまとめないでください(柱について合意する前に、タスクへ進まないでください)。
- 曖昧な頂点(「より良くする」など)を、成功基準を明確にしないまま受け入れないでください。
- ユーザーが簡潔な回答だけを求めている場合は、ピラミッドを作成しないでください。早めに切り上げるか尋ねます。