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 的 design 模式完全一致（MIT）；如有冲突，以此为准。模式 → 技能映射：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 Agent 的设计阶段。加载与当前阶段相匹配的文件。

角色文件	用于	用途
references/strategist.md	阶段 4a	5 个问题的需求收集、风格选择、布局/图表选择，生成设计规范
references/executor-base.md	阶段 4b	所有执行器继承的共享两轮（布局 → 叙事）规则
references/executor-executive.md	阶段 4b	高管风格——≤6 个可视化对象（3–6 个 KPI）、大创意标题、高留白
references/executor-analytical.md	阶段 4b	分析风格——8–12 个可视化对象、KPI + 主视觉 + 三列网格、直接标签
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 个部分的设计规范契约模板 + 七项确认签署表
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 / 自定义集合）。策划者会在七项确认的第 #6 项中绑定一个集合。
assets/images/	栅格图稿——背景、横幅、分隔线、演示用徽标。
assets/layout-previews/	SVG 缩略图（每种布局 1 张），用于七项确认的第 #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	基础主题，包含针对各类型（文本框／卡片／表格）的保护措施，可据此调整自定义主题

Repo 跨技能参考

| 参考 | 阅读时机 | |---|---| | 决定使用哪种图表类型——决策矩阵、硬性规则（为什么条形图优于饼图） | | references/visual-vocabulary.md | 意图优先目录：9 种数据关系类别 × 约 70 种图表（FT Visual Vocabulary / Gramener 版本），映射到 Power BI visualType | | 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. 受众与目的	以数据为先的调查，五问式需求收集（WHO、WHAT、BIG IDEA、ACTION、STYLE），确定语气和签名	references/strategist.md 步骤 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 的五层流程；Z/F 型布局；8 px 网格	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	回环	图表和布局的重新设计反馈通过此技能流转

---

分阶段工作流（与 Agent 对齐）

上述七步工作流是经典的技能内部流程。从 power-bi-developer Agent 调用时，请改为遵循基于角色的阶段关卡：

Agent 阶段	要加载的角色	输出
4a 设计策略	references/strategist.md + shared-standards.md + layouts/chart-templates 索引	已填写的 design-spec-reference.md
4a.5 七项确认（Plan 模式问答，不阻塞）	(无角色文件 — vscode_askQuestions 面板提供推荐默认值；也可回退为单条消息摘要)	记录用户对画布 / 页面 / 受众 / 风格 / 配色 / 图标 / 导航的决定（接受默认值或内联修改）
4b 生成	references/executor-base.md + executor-executive.md / executor-analytical.md / executor-operational.md 之一	PBIR 文件（第 1 遍：布局 → 第 2 遍：叙事）
4c 润色与设计 QA	references/polisher.md	finalize_pbir.py → design_quality_check.py → validate_report.py → 证据包

阶段 4a.5 是非阻塞的 Plan 模式审查：一次 vscode_askQuestions 调用会展示七项决定及 Strategist 推荐的默认值， 用户可以一次点击接受整个面板，也可以在聊天中回复 "proceed" / "go" / "looks good"。内联修改仅更新有变动的项目；完整重新设计则返回 4a。切勿在没有 Design Spec 的情况下运行 4b，并且每次重新生成 4b 的结果后都必须执行 4c。