live-dashboard

/digital-marketing-pro:live-dashboard

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

用途

创建并配置一个实时 Google Looker Studio 信息中心，并连接到品牌的营销数据源。根据业务模式（SaaS、电子商务、B2B、代理机构）自动选择合适的指标、维度和图表类型。无需手动提取数据，即可随时掌握最新的营销表现。通过提供自助式实时视图，展示对业务模式最重要的指标，并内置下钻功能和日期范围控件，从而免去定期生成报告的需要。

执行门槛（必须遵守，不能跳过）

默认情况下，此技能会生成一份供审核的信息中心规格说明。在通过此门槛之前，绝不能创建、发布、分享任何实时数据源，也不能将其连接到任何外部信息中心：

1. 将完整规格说明作为执行摘要呈现，其中包括数据源、已连接的账户、分享范围和刷新频率。
2. 用户必须输入 yes（或明确表示同意的等效内容），之后才能创建或分享任何外部信息中心。任何其他输入——含糊、暗示性、部分同意或未提供同意——都会取消操作；规格说明会保存，但不会在外部创建任何内容。
3. 输入含糊时绝不继续。创建失败时绝不自动重试。
4. 只有在用户输入 yes 后，才记录批准：python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"live-dashboard","platform":"<platform>","content_summary":"<one line from the Execution Summary>","risk_level":"<tier>"}'，然后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id}。如果任一命令出错，请停止并报告错误；绝不能使用其他工具绕过。如果这条记录存在，即证明此操作已执行批准步骤；但无法证明是谁输入了 yes。
5. 执行操作。通过 connector_executor.py 发出的写入操作需要 --approval-id，且只有匹配、未使用、未过期的记录才会触发（参见 /digital-marketing-pro:execute-action）。通过已连接的 MCP 服务工具执行的写入操作不受此代码检查约束：这依赖用户输入的 yes 以及宿主的权限提示。之后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（或使用 failure）。

所需输入

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

• 业务模式：saas（侧重经常性收入 — MRR、流失率、激活和扩张）、ecommerce（侧重交易 — 收入、AOV、转化率和产品表现）、b2b-lead-gen（侧重销售管道 — MQL、SQL、销售管道价值和 CPL）或 agency（侧重多客户 — 客户健康评分、利用率和跨客户表现）。这决定默认指标集、布局模板和可视化优先级
• 要连接的数据源：要将哪些平台接入仪表板 — Google Analytics（流量、行为、转化）、Google Ads（付费搜索表现、支出）、Meta Ads（付费社交表现、支出）、CRM（销售管道、交易数据、客户生命周期）、电子邮件平台（营销活动表现、列表健康状况）。可组合多个数据源，通过跨平台计算字段创建统一视图
• 要展示的主要 KPI：要在仪表板顶部醒目显示的 3-5 项核心指标 — 例如，SaaS 的 MRR 和流失率、电子商务的收入和 ROAS、B2B 的 SQL 和销售管道价值。这些指标会以记分卡组件呈现，并附带趋势指示和目标对比
• 仪表板受众：executives（高层记分卡，带趋势箭头，尽量减少下钻，聚焦业务成果）、marketing-team（完整的运营细节，包括渠道细分、营销活动级数据和诊断维度）或 client（品牌化展示视图，呈现相对于既定目标的表现、竞争背景和简洁的视觉设计）
• 刷新频率：数据更新频率 — real-time（在支持的情况下使用流式更新）、daily（适用于大多数场景的标准频率）、weekly（适用于对细粒度数据需求较低的高管仪表板）。这决定数据源缓存配置和提取计划

流程

1. 加载品牌上下文：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前启用的品牌标识，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。提取商业模式、关键指标、行业垂直领域、用于仪表板主题的品牌颜色，以及已连接的平台凭据。检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南。如果不存在品牌，询问：“先设置一个品牌吗（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 根据商业模式模板设计仪表板布局：选择合适的指标层级和页面结构。对于 SaaS：第 1 页概览（MRR 计分卡、流失率、CAC、LTV、CAC:LTV 比率），第 2 页获客漏斗（按渠道展示流量到试用再到激活和付费的转化），第 3 页留存（群组留存曲线、扩张收入、净收入留存率）。对于电子商务：第 1 页概览（收入、AOV、转化率、ROAS），第 2 页产品表现（热门产品、类别细分、库存周转速度），第 3 页渠道组合（按渠道归因的收入、按广告系列划分的 ROAS）。对于 B2B：第 1 页概览（MQL、SQL、销售管道价值、赢单率），第 2 页漏斗（从潜在客户到 MQL、SQL、商机再到成交，展示各阶段的转化率），第 3 页渠道效率（按渠道展示 CPL、每个 SQL 的成本、每个商机的成本）。对于代理机构：第 1 页客户组合概览（客户健康评分、管理的总支出、资源利用率），第 2 页按客户深入分析（可选择客户的筛选器，并展示完整 KPI 集），第 3 页跨客户基准对比。
3. 将数据源映射到仪表板组件：对于布局中的每个组件，确定哪个已连接的 MCP 可提供所需数据——Google Analytics MCP 用于流量和行为指标，Google Ads MCP 用于付费搜索数据，Meta MCP 用于付费社交数据，CRM MCP 用于销售管道和交易指标，电子邮件 MCP 用于广告系列表现。标记需要尚未连接的数据源的组件，并提供连接指引。
4. 生成 Looker Studio 配置：生成完整的仪表板规范——数据源连接参数（账号 ID、媒体资源 ID、日期范围）、计算字段公式（跨平台混合 ROAS、加权转化率、自定义 KPI 计算）、图表规范（图表类型、维度、指标、排序顺序、条件格式）、筛选器控件（日期范围选择器、渠道筛选器、广告系列筛选器、受众细分筛选器），以及包含组件位置和尺寸的页面布局。
5. 创建仪表板设置说明：生成在 Looker Studio 中实施仪表板的分步指南——如何创建每个数据源连接，如何按照规范构建每个页面和组件，如何使用准确公式配置计算字段，如何设置筛选器控件及其交互方式，以及如何应用品牌主题（颜色、字体、Logo 位置）。在有帮助时，附上截图或视觉参考。
6. 提供仪表板模板链接或导出配置：此插件不附带 Looker Studio MCP 服务（注册表中没有 google-looker-studio 连接器）。默认情况下，将完整配置导出为结构化规范文档，以便手动实施，并完整定义每个组件及其数据源映射。只有在用户自行连接了 Looker Studio MCP 服务时，才可以尝试直接创建——而且只有在通过上文的执行门槛后才能尝试。

输出

结构化仪表板交付内容，包括：

• 仪表板设计规范：完整的布局文档，包含页面结构、组件位置、图表类型、指标、尺寸、各组件的数据源和条件格式规则，并按页面整理，同时附上可视化布局说明
• Looker Studio 设置指南：从空白仪表板到完整配置的实时视图的分步实施说明，包括数据源创建、页面构建、组件配置、计算字段公式和筛选器设置
• 各平台的数据源连接说明：针对各数据源的平台专属连接指南，包括 Google Analytics 媒体资源 ID 和视图选择、Google Ads 账号关联、Meta 广告账号授权、CRM API 连接、电子邮件平台集成，以及所需权限和范围
• 计算字段公式：所有自定义计算字段的 Looker Studio 精确公式语法，包括跨平台混合指标、自定义 KPI、环比计算、目标比较字段和条件格式逻辑
• 筛选器和下钻配置：所有交互控件的规范，包括带预设选项的日期范围选择器、渠道和营销活动筛选器、受众细分选择器，以及带参数传递的跨页面下钻链接
• 仪表板维护清单：持续维护任务，包括数据源凭据刷新计划、新增营销活动或渠道、KPI 定义变更时更新计算字段，以及每季度根据业务模式演变审查指标相关性

使用的 Agent

• analytics-analyst — 根据业务模式和行业基准选择指标，设计符合目标受众信息层级需求的仪表板布局，映射数据源以确定哪些已连接的 MCP 为哪些组件提供数据，并遵循可视化最佳实践，包括选择图表类型、搭配维度与指标、设定条件格式阈值，以及设计下钻路径
• execution-coordinator — 生成 Looker Studio 配置（默认导出规范；google-looker-studio MCP 未随附，只有在用户已连接自己的 Looker Studio MCP 时才直接创建），包括设置数据源、创建计算字段、指定组件和配置筛选器控件；此外，还负责设置带有品牌颜色的仪表板主题，并导出设置说明或实时仪表板链接