用途：在 PBIP 项目中以 PBIR（Power BI Enhanced Report）文件格式创建和修改 Power BI 报表，生成可被 Power BI Desktop 与 Power BI 服务直接打开的 .Report/ 文件夹及其中全部 JSON 文件，并支持通过截图工作流在桌面端做实时验证。
主要能力：生成报表级文件（definition.pbir、report.json、pages.json、version.json）、页面与视觉对象（page.json、visual.json、mobile.json）、书签、自定义主题、图片资源与报表扩展；提供格式化、筛选器、条件格式、主题、表达式、移动布局等参考文档；附带校验与打磨脚本（validate_report.py、finalize_pbir.py、design_quality_check.py、pbir_gate.py）。
使用方式：需 Node.js 20+，全局安装 npm install -g @microsoft/powerbi-report-authoring-cli @microsoft/powerbi-desktop-bridge-cli，用 powerbi-report-author --version 与 powerbi-desktop --version 确认；用 powerbi-desktop status 检查桌面端状态。写入视觉角色、格式化对象、枚举值、选择器或表达式编码前，先用 CLI 能力查询（catalog/formatting）；每批编辑后用 powerbi-report-author validate "<path-to-.Report-dir>" 校验；视觉改动走 Edit → Validate → Reload → Screenshot 循环。Phase 4c 可用 python skills/power-bi-report-authoring/scripts/pbir_gate.py --report <path> --style <style> 统一门禁。
适用场景：从设计规范或设计简报出发构建新报表、修改现有 PBIR 报表、添加页面与视觉对象、配置主题与书签、移动端布局、自定义视觉对象注册等。
限制：不得凭记忆猜测 PBIR JSON；不要创建旧版视觉类型（card、table、matrix、map、filledMap）；视觉改动不可跳过桌面端验证；自定义视觉对象需说明选用理由并在 report.json 的 publicCustomVisuals 中注册；若 CLI 不可用，validate_report.py 不能替代 schema 校验。画布尺寸 1664 × 936，工具提示页 320 × 240。命名使用小写 kebab-case。