1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | power-bi-performance-troubleshooting-github-awesome-copilot | - |
| 作者/维护者 | 社区贡献者提交，经 GitHub 官方 github/awesome-copilot 合集仓库维护者审核合并 |
GitHub API |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/power-bi-performance-troubleshooting | - |
| 许可证 | MIT（仓库级） | GitHub API |
| GitHub Stars | 38,819（属整个 awesome-copilot 合集，不代表本技能自身热度） | GitHub API |
| Forks | 4,918（同上，属合集整体） | GitHub API |
| 最新版本 | 无独立版本号，内容最近一次改动为 2026-02-24（批量转换提交合并） | GitHub API |
| 安装方式 | gh skills install github/awesome-copilot power-bi-performance-troubleshooting（需 GitHub CLI），或手动复制目录 |
仓库文档 |
2. 功能介绍与亮点
这是一份系统化的 Power BI 性能故障排查框架，把“报告卡顿”这种模糊抱怨拆解成可执行的诊断流程：
- 四维问题分类：开局先把性能问题归到模型加载/刷新、报告页面加载、视觉交互响应、查询执行速度、容量资源瓶颈、数据源连接六类之一，并判断影响范围（全员还是特定用户、特定时段还是持续），避免一上来就瞎猜原因。
- 基线指标先行：要求先采集页面加载时间、视觉交互响应、查询执行时长、刷新耗时、内存/CPU 利用率等具体数字作为基线，再对照目标值（页面加载 <10 秒、交互响应 <3 秒等）定位差距。
- 给真实代码级修复方案：不止给建议清单，正文附带具体的 DAX 前后对比示例（如把嵌套
CALCULATE改写成VAR变量 +DIVIDE的优化写法），以及存储模式（Import/DirectQuery/复合模型）与容量扩容的具体调优路径。 - 分级排查工作流：提供 30 分钟快速检查清单、2-4 小时综合分析、1-2 周战略性优化三档工作流，用户可按问题紧急程度选择投入深度。
- 配套监控与沟通模板：附带周期性健康检查清单、KPI 告警阈值建议，以及问题上报与修复方案文档的标准模板，方便团队协作留痕。
- 该技能已通过
github/awesome-copilot仓库官方自动化技能质量校验器检查，被标记为“detailed”（内容详实）等级，未被标记任何格式或内容问题。
3. 适用场景
所属分类：数据分析与可视化（产出是针对 Power BI 报表/模型/查询的性能诊断与调优方案，服务于 BI 报表的可用性与响应速度这一典型数据分析场景）。
适用于任何被“报表打开慢”“切片器一点就转圈”“数据刷新老是超时”困扰的场景：企业内的 Power BI 开发者需要系统定位报表卡顿的真正原因，而不是凭感觉瞎调；数据分析师在把模型交付业务方前想先做一轮性能自检；IT/BI 运维团队需要一套标准化的问题上报与处理流程。因为流程从“30 分钟快速检查”到“两周战略优化”分了档，初级 BI 开发者也能直接照单排查，不必先具备资深调优经验。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——标准 Agent Skills 格式（SKILL.md + YAML front matter），复制到
.claude/skills/即可使用，纯文本分析与建议，无需额外工具。 - Codex：✅ 原生支持——Codex CLI 技能系统同样构建在开放的 Agent Skills 标准之上，且本技能不涉及代码执行或网络访问，无沙箱限制问题。
- OpenClaw：❓ 未验证，仓库文档未提及。
- Hermes Agent：❓ 未验证，仓库文档未提及。
5. 推荐理由
Power BI 报表变慢是几乎每个团队迟早会遇到的问题，但大多数人排查时只会“随手删几个视觉元素试试”，找不到系统方法。这个技能把模型、报告、查询、容量四个可能出问题的层面拆开，配上具体的基线指标和真实的 DAX 优化示例，让使用者能像专业顾问一样一步步定位瓶颈，而不是碰运气式调优；分级工作流也照顾了“临时救急”和“彻底根治”两种不同紧急程度的需求。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 官方 github/awesome-copilot 合集仓库出品，经官方维护者审核合并；专门检索未找到该子技能独立于合集之外的第三方讨论或市场收录数据 |
| 可用性 | 7 | 纯文本框架，无外部依赖，含真实 DAX 代码示例与分级工作流；内容最近一次改动为 2026-02-24（约 6.5 个月前，略超“近 6 个月维护”窗口） |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 纯文本分析与建议框架，不执行任何 shell 命令 |
| ② 运行时联网外发 | 不联网，不访问任何外部服务 |
| ③ API key/凭据 | 不需要任何凭据 |
| ④ 可疑指令 | 未发现 prompt injection 迹象或夹带无关推广内容 |
| ⑤ 作者/组织信誉 | GitHub 官方合集仓库，提交经 PR 审核（含自动化技能校验器检查）后合并，无刷星或自我造势迹象 |
| ⑥ License | MIT（仓库级），明确 |
| ⑦ 最近维护时间 | 2026-02-24，约 6.5 个月前 |
综合评分 = (7 + 7 + 9) / 3 = 7.67
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| semantic-model-authoring-microsoft-skills-for-fabric | 微软官方出品，面向已用 PBIP 版本控制或 Fabric 工作区的开发者，agent 直接协助批量建模、编写 DAX 并做校验 | 定位是“帮你写模型”的生成与校验工具；本技能定位是“帮你诊断已存在的性能问题”，两者服务模型生命周期的不同阶段 |
| power-bi-agentic-development | 按周迭代的 Power BI/Fabric 全流程 agent 技能市场，覆盖 DAX 调优与语义模型自动化 | 是一整套技能集合，DAX 调优只是其中一个模块；本技能是聚焦“性能故障排查”单一场景的独立框架，问题分类与基线采集方法论更系统 |
| power-bi-report-design-consultation-github-awesome-copilot | 把图表选型与仪表盘布局的经验封装为设计框架，解决“选什么图表、怎么排版”的问题 | 关注的是报表的视觉呈现质量；本技能关注的是报表能不能跑得快，两者互补而非重叠 |
索引内已有的 Power BI 相关技能集中在“建模自动化”与“报表设计”两类，本技能填补的是“报表已经做好但卡顿、需要系统排查”这一日常高频却此前空缺的场景。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
10. 安装使用方式
# 需要已安装 GitHub CLI
gh skills install github/awesome-copilot power-bi-performance-troubleshooting
# 或手动复制
git clone https://github.com/github/awesome-copilot.git
cp -r awesome-copilot/skills/power-bi-performance-troubleshooting ~/.claude/skills/安装后无需重启。直接向 agent 描述遇到的性能问题（如“这个报表页面打开要 20 秒，帮我排查”），技能会引导先分类问题、采集基线指标，再逐层给出诊断与优化建议。
11. 注意事项
- 本技能只提供诊断方法论与优化建议，不能直接连接 Power BI 服务自动执行修改，具体调整（如改写 DAX、调整存储模式）仍需使用者在 Power BI Desktop/Service 中手动应用。
- 内容最近一次改动约 6.5 个月前，若 Power BI 后续版本引入新的性能诊断工具（如更新版 Performance Analyzer），部分细节可能需要对照最新官方文档校准。
- 容量扩容、DirectQuery 网关优化等章节假设使用者已具备 Power BI Premium/Fabric 容量的管理权限，普通 Pro 授权用户可跳过对应部分。