agency-dashboard

/digital-marketing-pro:agency-dashboard

脚本位置。 如果您的宿主环境未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 文件夹同级。请使用 Python 3.10 或更高版本运行：python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

用途

生成汇总所有客户品牌健康指标的全局仪表板。一览活动情况、预算消耗进度、KPI 达成情况、内容管线和团队利用率，让代理机构管理层无需逐一打开各个账户，就能掌握运营状况。适用于每日站会、每周代理机构评审或按需健康检查。

所需输入

用户必须提供（或将收到提示提供）：

• 仪表板范围：所有品牌，或要纳入全局视图的特定品牌 slug 列表
• 时间段：当前周、月或季度——用于确定进度计算和比较时间窗口
• 详细程度：摘要（每位客户的整体健康评分）或详细（每位客户按活动拆分，并列出各项活动指标）
• 排序/筛选偏好：按健康评分、支出、收入或字母顺序排列客户——还可选择仅筛选风险账户（黄色/红色）
• 团队筛选（可选）：如果代理机构有多个团队组负责不同客户，可按账户负责人或团队组筛选
• 比较基准（可选）：将当前时段与上一时段、去年同期或计划/目标进行比较——默认为上一时段
• 警报阈值覆盖设置（可选）：自定义绩效下滑警报或预算消耗进度容差阈值——默认为绩效下滑 20%、进度偏差 10%
• 导出格式（可选）：选择以 Markdown、Google Sheets 或 Slack 消息格式输出——默认为 Markdown

流程

1. 加载品牌上下文：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前启用的品牌 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业上下文。另检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南；如果存在，加载其中的限制条件。检查 ~/.claude-marketing/sops/ 中是否有代理机构 SOP。如果没有品牌，则询问：“先设置品牌？（/digital-marketing-pro:brand-setup）”——也可以使用默认设置继续。
2. 枚举所有品牌：扫描 ~/.claude-marketing/brands/，查找所有已配置的品牌目录（排除 _active-brand.json）。对每个品牌，加载 profile.json，获取客户名称、行业、合作类型、合同日期、指定团队成员和 KPI 目标
3. 逐品牌提取营销活动数据：对于范围内的每个品牌，运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaigns，以获取正在进行的营销活动、状态、预算和目标（使用 --action get-campaign --id {id} 获取单个营销活动的详细信息）
4. 逐品牌提取执行状态：对每个品牌，运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-history，获取已记录的执行情况——已完成的交付物、发布和任务——然后在分析中推导待处理／逾期状态
5. 逐品牌检查预算进度：将当前周期的实际累计支出与计划支出进行比较——计算预算进度百分比，并按当前支出速度预测周期结束时的支出
6. 计算每位客户的健康评分：应用 skills/context-engine/agency-operations-guide.md 中的红黄绿（RAG）评分公式：
   • 绿色：各项 KPI 均按计划推进，预算进度正常（偏差在 10% 以内），没有逾期事项，内容管线运转顺畅
   • 黄色：有 1–2 项 KPI 存在风险，预算进度略有偏差（10–20%），事项即将到期，或待审批事项积压
   • 红色：KPI 大幅未达标，预算超支（>20%），错过截止日期，营销活动停滞，或 MCP 连接中断
7. 汇总整体客户组合 KPI：统计正在进行的营销活动总数、每月总支出、客户间平均 ROAS、潜在客户／转化总数、待交付物总数，以及整体客户组合健康状况分布（绿色／黄色／红色的数量和百分比）
8. 检查团队利用率：运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/team-manager.py" --action check-capacity --brand {slug}，评估当前团队工作负载——每位团队成员的可用产能、标记过载人员、服务不足风险客户，以及计费工时跟踪。**可选添加 Claude Code 成本项——仅限用户提供数据时。**该插件无法自行读取 Claude Code 用量。如果用户粘贴自己运行的 /usage 命令输出（这是他们在交互过程中运行的 Claude Code CLI 斜杠命令），则汇总其中报告的各模型令牌／成本数据，添加一项“Claude Code 消耗”，以便管理层在收到月度账单前了解 AI 成本。模型名称应采用用户 /usage 输出中的名称——不要假设具体模型 ID。按品牌划分目录的工作区（~/work/clients/{slug}）可将数据归属到具体品牌。
9. 识别待审批事项：扫描所有品牌的执行日志，查找等待客户或内部审批的事项——将超过 48 小时的事项标记为逾期，并按品牌和紧急程度（常规、时间敏感、阻塞）分组
10. 列出即将到期事项：汇总所有品牌未来 7 天和 14 天内的截止事项——营销活动发布、内容交付日期、报告截止日期、合同里程碑、续约日期和 QBR 安排
11. 检测警报和异常：标记出现以下情况的品牌：主要 KPI 环比突然下降（>20%）、预算进度存在问题（比计划超前或落后 >10%）、营销活动停滞（连续 5 天以上没有活动）、MCP 连接失败，或凭据即将过期
12. 检查内容管线：汇总所有品牌的内容状态——草稿、审核中、已批准、已排期和已发布的内容项——找出内容在特定阶段停滞的瓶颈
13. 生成趋势对比：将当前客户组合健康状况与所选基准周期进行比较——通过方向箭头展示每位客户及整体客户组合的趋势是改善、稳定还是下降
14. 汇总客户组合仪表板：将所有数据整理为结构化仪表板，并按用户偏好排序；可深入查看任意单个客户的详细信息

输出

结构化的投资组合仪表板，包含：

• 投资组合健康度摘要：纳入范围的客户总数、健康度分布（绿色／琥珀色／红色的数量和百分比）、整体投资组合健康度得分（按客户支出加权）以及环比趋势方向
• 各客户健康度卡片：每个品牌对应的客户名称、健康度得分（RAG）、活跃营销活动数量、月度支出及进度状态、主要 KPI 与目标的对比及差值、下一个截止日期、如有则列出首要警报，以及指定的客户负责人
• 汇总 KPI 表格：整个投资组合的总支出、平均 ROAS、活跃营销活动总数、生成的潜在客户／转化总数、成本效益趋势，以及带方向箭头的环比对比
• 预算进度摘要：各品牌的进度状态（按计划、支出不足、超支），包括预计期末支出、与计划的金额和百分比差异，以及投资组合层面的进度汇总
• 团队利用率矩阵：每位团队成员的工作负荷（管理的客户数、分配的工时、产能百分比、可计费比例）、超负荷警报、新工作可用的余量，以及人员配置建议
• Claude Code 使用情况（按品牌） — 仅在用户提供了 /usage 数据时显示：按工作目录汇总并映射到品牌，使用用户的 /usage 输出所报告的模型层级，列出报告期内的 Token 总量和美元成本。对于 Claude Code 支出超过同一服务费档位投资组合中位数 2 倍的品牌，标记为需要审查合作模式或重新协商费率的候选对象。如果未提供使用情况数据，则完全省略此面板。
• 待审批队列：各品牌所有待审批事项，包括事项描述、已等待小时数、负责人、品牌、紧急程度以及延迟造成的预估影响
• 即将到期的截止日期（7／14 天）：按时间顺序列出即将到期的事项，包括品牌、交付物类型、负责人、剩余天数、依赖状态，以及错过截止日期的风险评估
• 内容管线状态：汇总所有品牌处于草稿、审核、已批准和已排期阶段的内容，列出各阶段数量并识别瓶颈
• 警报与异常面板：按严重程度排序，列出需要立即关注的业绩下滑、预算进度问题、停滞的营销活动、MCP 连接失败、凭证即将过期或逾期事项
• 合同与续约跟踪：即将续约的合同、合作里程碑，以及临近续约期的客户的留存风险指标
• 下钻指引：说明如何使用 /digital-marketing-pro:performance-report、/digital-marketing-pro:client-report 或 /digital-marketing-pro:credential-switch，深入调查单个客户并启用该品牌的上下文

使用的 Agent

• agency-operations — 投资组合汇总、各客户健康度评分、团队利用率分析、审批跟踪、截止日期汇总、预算进度计算、内容管线汇总和警报检测
• analytics-analyst — 指标分析、KPI 汇总、趋势计算、异常检测、投资组合业绩基准分析以及对比基准计算