power-bi-report-design

Power BI レポートの設計

PBIR ファイルを生成する前に、Power BI レポートを計画して設計します。このスキルは、 ビジネス要件とセマンティックモデルを、構造化された設計仕様書（および正規の Design Brief: YAML コントラクト）に変換します。これを power-bi-report-authoring スキルが読み込み、実際の .Report/ フォルダーを生成します。 このスキルが PBIR を編集したり、Fabric API を呼び出したりすることはありません。

公式ソース。 references/design.md および references/design/** は、 microsoft/skills-for-fabric powerbi-report-cli （MIT）の design モードをそのまま反映したものです。競合する場合は、こちらが優先されます。モードとスキルの対応： planning → power-bi-business-analysis、authoring → power-bi-report-authoring、 management → power-bi-management。

ドキュメントの検索。 Microsoft の最新の視覚化ガイダンスを確認するには、グラフの種類やパターンを推奨する前に Microsoft Learn（microsoft-learn-mcp ツール）を検索してください。ドキュメントには CLI に相当するものがないため、ここでは MCP が適切なツールです。

参照ファイル

役割別ファイル（フェーズ駆動型ワークフロー）

これらの役割別ファイルは、power-bi-developer エージェントの設計フェーズに対応しています。現在のフェーズに合ったファイルを読み込んでください。

役割ファイル	使用フェーズ	目的
references/strategist.md	フェーズ 4a	5 つの質問によるヒアリング、スタイル選定、レイアウト／グラフの選択を行い、設計仕様書を作成します
references/executor-base.md	フェーズ 4b	すべての実行担当者が継承する、2 パス（レイアウト → ナラティブ）の共通ルール
references/executor-executive.md	フェーズ 4b	エグゼクティブ向けの特性 — 視覚要素は最大 6 個（KPI は 3～6 個）、ビッグアイデアを示すタイトル、広い余白
references/executor-analytical.md	フェーズ 4b	分析向けの特性 — 視覚要素は 8～12 個、KPI ＋主要グラフ ＋ 3 列グリッド、直接ラベル
references/executor-operational.md	フェーズ 4b	業務運用向けの特性 — 視覚要素は 10～14 個、信号機式のステータス、大きなフォント
references/polisher.md	フェーズ 4c	finalize_pbir.py と design_quality_check.py を実行し、設計仕様書との整合性を確認します

共通規則とテンプレート

参照先	読み込むタイミング
references/shared-standards.md	必須の PBIR 設計ルール — 禁止パターン、グリッド、タイポグラフィのスケール、色の 60/30/10 比、アクセシビリティ、パフォーマンス予算。すべての役割で読み込む必要があります。
references/design-spec-reference.md	11 セクション構成の設計仕様書コントラクトのテンプレートと、7 項目の確認事項の承認表
references/layouts/layouts-index.json	ページレイアウトのスターターのインデックス（スロットの座標、スタイルタグ） — 横向きのレシピはすべて FHD 1920×1080 です
references/layouts/archetype-map.md	公式のアーキタイプ／バリアント（Executive A/B/C、Analytical A/B/C など）とライブラリのレシピとの対応、ギャップ、FHD のスペース配分と視覚要素の予算ルール
../power-bi-report-authoring/scripts/build_report_from_layout.py	承認済みのレシピとスロット仕様から PBIR の視覚要素を作成します（レシピを使うページにおける実行担当者のパス 1）
scripts/rescale_layout.py	レイアウトのスロットを別の 16:9 キャンバス（1280×720、2560×1440、ブラウンフィールドのサイズ）に合わせて拡大縮小します。--check はレシピのスロット表（グリッド、境界、重なり、余白）を検証します
references/layouts/*.md	個別のレイアウトレシピ（exec-overview-16x9、sales-performance、drillthrough-detail など）
references/chart-templates/chart-templates-index.json	グラフレシピのインデックス（構成 ＋ スロット ＋ 注意点）
references/chart-templates/*.md	個別のグラフレシピ（kpi-banner、bar-comparison、trend-line、yoy-variance、waterfall-bridge など）
assets/icons/	SVG アイコンライブラリ（Tabler／Lucide／カスタムセット）。ストラテジストは、7 項目の確認事項の項目 #6 でセットを指定します。
assets/images/	ラスター画像 — 背景、バナー、区切り線、デモ用ロゴ。
assets/layout-previews/	SVG サムネイル（レイアウトごとに 1 つ）。7 項目の確認事項の項目 #2 で使用します
assets/chart-previews/	SVG／PNG サムネイル（グラフレシピごとに 1 つ）。設計仕様書の §5 で使用します

公式デザインモード（Microsoft powerbi-report-cli よりそのまま引用）

references/design.md は公式モードガイドです（ワークフローのステップ 0～7、アーキタイプのルーター、注意点、正規の Design Brief: コントラクト）。トピック別ファイルは references/design/ にあります。以下のリポジトリ内のメモと矛盾する場合は、公式ファイルを優先してください。

リファレンス	読むタイミング
references/design.md	入口 — ワークフロー、アーキタイプのルーター、デザインコントラクト、注意点
references/design/tone-catalog.md	トーンカタログ — タイポグラフィ、パレット、密度、グリッド線、枠線、シグネチャー、後続の選択肢となるアイコン表現を定義した名称付きトーン、リミックスのルール
references/design/signatures.md	シグネチャーギャラリー — トーンとの一貫性を示すマトリックス付きの名称付きシグネチャー、新しいシグネチャーの作成
references/design/archetypes/*.md	ページごとのレイアウトバリエーション：executive-summary、operational-monitor、analytical-canvas、narrative-story、comparative-benchmark
references/design/archetype-composition.md	複数ページの構成と、ページ間でのバリエーションのローテーション
references/design/chart-selection.md	エンコーディングの階層、目的に応じたチャートの選択
references/design/visual-cookbook.md（および -part-02）	ビジュアルタイプごとの並べ替え、色、ラベル、条件付き書式のルール、テーマとビジュアルごとの設定の境界
references/design/layout.md、color.md、typography.md、interactivity.md	グリッドと構成、パレットと意味、文字サイズのスケール、ドリル、ブックマーク、クロスフィルター、ナビゲーションのモデル
references/design/brownfield.md	既存レポートの再設計、スタイル変更、テーマの差し替え、ブランド適用
references/design/accessibility.md、anti-patterns.md、pre-flight-checklist.md	引き渡し前の最終確認
references/design/design-brief.md（および -part-02）	引き渡し前に読む — Design Brief: テンプレート、layout_contract スキーマ、検証チェックリスト
references/design/assets/base.json	カスタムテーマに適用する、タイプ別の保護設定（textbox/card/table）を備えたベーステーマ

リポジトリ内のスキル間参照

| 参照 | 読むタイミング | |---|---| | 使用するグラフの種類を決めるとき — 判断マトリックス、厳守ルール（円グラフより棒グラフが適している理由） | | references/visual-vocabulary.md | 意図優先のカタログ：9つのデータ関係カテゴリ × 約70種類のグラフ（FT Visual Vocabulary / Gramener 版）を Power BI の visualTypes に対応付け | | references/visual-design-principles.md | 前注意的属性、ゲシュタルト原則、色彩理論、タイポグラフィ、ナラティブ構成、Kirk の5層デザインプロセス、アクセシビリティ設計（代替テキスト、タブ順、マーカー、コントラスト、チェックリスト） | | references/page-layout-templates.md | 基本レイアウト：概要、詳細、ドリルスルー、ツールチップ、グリッド、サイドバー、スコアカード、タブナビゲーション | | references/domain-report-structures.md | 業界別ページ構成：営業、製造、財務、サプライチェーン、小売、医療、テクノロジー | | references/theme-colors.md | テーマのアーキテクチャ、セマンティックカラー、業界別パレット、カスタムテーマ JSON のパターン、色覚多様性に配慮した代替案 | | ../power-bi-report-authoring/references/common-patterns.md | 再利用可能なコンポーネント：KPI 行、スライサーパネル、背景図形、ページナビゲーター、ビジュアル間の操作、TOP N グラフ（pbip-report と共有） | | references/navigation-patterns.md | ナビゲーションボタン、ブックマークタブ、戻るボタン、フィルターのリセット、ハブアンドスポーク、パンくずリスト、ページナビゲーター | | references/slicer-filter-patterns.md | フィルター範囲、スライサーの種類の選択、同期グループ、クロスフィルターとハイライト、既定の状態、フィルターとドリルスルーの使い分け、ペインの表示設定、RLS との連携に関する判断ガイド | | references/slicer-patterns/ | レシピ集 — 7つのファミリー（日時、カテゴリ、数値、検索、アーキテクチャ、ガバナンス、パラメーター）にわたる14種類のスライサー／フィルター構成レシピ（ASCII モックアップ + スロット + プロパティスニペット + 既定値 + アンチパターン）。インデックス：slicer-patterns/slicer-patterns-index.json | | ../power-bi-report-authoring/references/mobile-layout.md | モバイルデザインのルール、自動作成、ビジュアルの最小サイズ、書式設定、スライサーの動作、制限事項 | | ../power-bi-report-authoring/references/themes/*.json | すぐに使えるカスタムテーマファイル（8業界）— 正式なソース |

デザインワークフロー（概要）

ワークフロー全体は Strategist の役割（references/strategist.md）によって進められます。 以下の各ステップには詳細なリファレンスへのリンクがあります。リファレンスを読み込み、独自に導き出さないでください。

ステップ	アクション	主なリファレンス
1. 対象ユーザーと目的	データを優先した調査、5つの質問によるヒアリング（WHO、WHAT、BIG IDEA、ACTION、STYLE）、トーンとシグネチャ	references/strategist.md Steps 0–2 + references/visual-design-principles.md + references/design/tone-catalog.md + references/design/signatures.md
2. ページ構成	ドメインとページタイプに基づいてページを選択し、各ページをアーキタイプとバリアントに割り当てる	references/domain-report-structures.md + references/page-layout-templates.md + references/design/archetypes/*.md + references/design/archetype-composition.md
3. グラフの選択	分析タスクから始めて、グラフを選び、レシピを選ぶ	references/design/chart-selection.md + references/chart-selection-guide.md + references/visual-vocabulary.md + references/design/visual-cookbook.md
4. レイアウトと配置	Kirkの5層プロセス、Zパターン／Fパターン、8ピクセルグリッド	references/design/layout.md + references/visual-design-principles.md + references/layouts/
5. テーマと色	ブランドまたは業界のパレット、60/30/10ルール、コントラスト比4.5:1	references/design/color.md + references/theme-colors.md + references/shared-standards.md §3 + references/design/accessibility.md + references/design/assets/base.json
6. ナビゲーションとフィルター	パターンの選択とスライサーレシピのバインド	references/design/interactivity.md + references/navigation-patterns.md + references/slicer-filter-patterns.md + references/slicer-patterns/
7. モバイルレイアウト	出発点として自動作成し、タッチ操作／単一列向けに調整する	../power-bi-report-authoring/references/mobile-layout.md
8. デザイン仕様書とDesign Brief:の作成	11のセクションすべてを記入してから、標準のDesign Brief: YAMLを出力し、事前チェックリストを実行する	references/design-spec-reference.md + references/design/design-brief.md + references/design/pre-flight-checklist.md

厳守事項（円グラフは5個を超えない、3Dは禁止、虹色は禁止、ページあたりのビジュアル数の上限）は、 references/shared-standards.md §1で正式に定義されています。すべての役割で、まずこのファイルを読み込みます。 アンチパターンは、重大度の評価とともにreferences/design/anti-patterns.mdにまとめられています。

関連スキル

スキル	関係	タイミング
power-bi-report-authoring	下流（フェーズ4b）	デザイン仕様書を使用してPBIR JSONファイルを生成します
power-bi-dax-development	上流（フェーズ3）	メジャーカタログがビジュアル用のデータバインディングを提供します
power-bi-business-analysis	上流（フェーズ1）	要件からページ計画、対象ユーザー、KPI、ドメインを決定します
power-bi-performance-troubleshooting	横断的	レポートレベルの最適化（ビジュアル数、スライサー設計、クエリ削減）
power-bi-feedback-iteration	差し戻し	グラフ／レイアウトの再設計に関するフィードバックをこのスキル経由で反映します

---

フェーズ駆動型ワークフロー（エージェントに準拠）

上記の7ステップのワークフローは、従来のスキル内部のフローです。 power-bi-developer エージェントから呼び出された場合は、代わりにロールベースのフェーズゲートに従ってください。

エージェントフェーズ	読み込むロール	出力
4a デザイン戦略	references/strategist.md + shared-standards.md + layouts/chart-templates インデックス	記入済みの design-spec-reference.md
4a.5 7つの確認事項（Plan モードでのQ&A、ブロッキングなし）	(ロールファイルなし — 推奨デフォルトを提示する vscode_askQuestions パネル。フォールバックとして単一メッセージの要約)	Canvas / Pages / Audience / Style / Palette / Iconography / Navigation に関するユーザーの決定を記録（デフォルトの承認またはインライン編集）
4b 生成	references/executor-base.md + executor-executive.md / executor-analytical.md / executor-operational.md のいずれか1つ	PBIR ファイル（パス1 レイアウト → パス2 ナラティブ）
4c 仕上げとデザインQA	references/polisher.md	finalize_pbir.py → design_quality_check.py → validate_report.py → エビデンスパッケージ

フェーズ4a.5は、ブロッキングなしのPlanモードレビューです。1回の vscode_askQuestions 呼び出しで、ストラテジストが推奨するデフォルトとともに7つの決定事項を提示します。 ユーザーはパネル全体をワンクリックで承認するか、チャットで "proceed" / "go" / "looks good" と返信して承認できます。インライン編集では変更した項目のみが更新され、全面的な再設計の場合は4aに戻ります。Design Specなしで4bを実行してはならず、4bで再生成するたびに必ず4cを実行してください。