用途:将 Microsoft 365 管理中心(MAC)Copilot 报告的四份导出转为单文件 HTML 采用看板。四份报告为:Copilot 使用情况(按已授权用户)、Agents 按用户、Agents 按代理、Copilot Chat(含未授权用户)。适用时机:用户运行 /create-copilot-adoption-dashboard,或要求用真实数据填充并品牌化看板模板。
主要能力:计算许可证激活、习惯用户率、代理采用率、用户分群(Champion→Never)、热门应用界面、各代理使用份额、未授权 Chat 转化漏斗;输出自包含 .html(无库、无网络),每个占位符与示例数字均被替换;KPI 块与面板带 i 定义按钮,悬停显示底层用户数;图表下方给出框架推荐的下一步措施(KPI 触发型与持续培训/意识型)。
使用方式:先说明流程并列出所需四份报告;收集公司名(必填)与可选 Logo,用 Glob 在 input/**/*.csv 找文件;读取各 CSV 前两行核对表头并映射到 --usage / --agents-user / --agents-agent / --chat;运行 python scripts/build_dashboard.py --company "<Company>" [--logo input/<logo>] --usage input/<usage>.csv --agents-user input/<agents_user>.csv --agents-agent input/<agents_agent>.csv --chat input/<chat>.csv --out working/<Company>_Copilot_Adoption_Dashboard.html;读取脚本输出的 JSON 摘要,检查 periodDays 与 periodSource;用 CopyArtifact 发布到 output/,再用 Glob 确认。
限制:报告窗口取自导出的 Report Period 列(MAC 默认 28 天),不硬编码,仅用户明确要求时才传 --period;列无法映射时写 --col-map 并重跑,不得手改数字;报告缺失时对应面板显示 pending,不得编造数据;阈值来自框架可调,但应改参考文件而非输出;该技能仅报告聚合采用情况,不排名或评估个人,绩效问题应转交经理或 HR;休眠不作为推荐触发项。框架逻辑见 references/adoption-framework.md。