credential-switch

/digital-marketing-pro:credential-switch

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

用途

将当前凭据配置文件切换到其他品牌，以便管理多个客户。验证所有平台连接，并报告目标品牌可用的服务。确保在执行任何平台操作前，已启用正确的 API 密钥、令牌和环境变量，避免客户间数据泄露、广告支出投放错误，或在错误的账户上意外操作。

执行关卡（必需 — 不可跳过）

1. 将验证摘要作为执行摘要呈现，其中包括目标品牌、各平台的凭据状态以及任何警告。
2. 如果验证无异常，且只配置了一个客户凭据配置文件，则可以自动继续切换。如果存在多个客户配置文件，或有任何警告、缺失凭据或即将过期的凭据，则用户必须输入 yes（或明确表示同意的等效内容）——任何其他输入都会取消操作。
3. 输入含糊时，绝不继续。切换失败后，绝不自动重试。
4. 只有在用户输入 yes 后，才记录该操作：python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"credential-switch","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）。

所需输入

用户必须提供（或系统会提示用户提供）：

• 目标品牌 slug：要切换到的品牌 slug——必须与 ~/.claude-marketing/brands/ 中配置的品牌匹配，并且在 ~/.claude-marketing/credentials/ 中有对应的凭据配置文件
• 验证深度（可选）：以下选项之一：
  • 快速：检查环境变量是否存在且非空——速度快，不调用 API
  • 完整：测试每个已配置平台的实时 API 连接和令牌有效性——速度较慢，但可确认实际访问权限
  • 默认为快速验证，以加快切换速度
• 强制切换（可选）：如果目标配置文件存在缺失或过期的凭据，是否仍要在显示警告的情况下切换，或完全中止——默认为关键凭据缺失时中止（广告平台、分析平台）
• 原因（可选）：为切换日志添加简短备注——当多名团队成员共用系统时，有助于审计追踪（例如：“开始为 Acme Corp 编制月度报告”）
• 要验证的平台（可选）：指定要验证的平台，而非验证所有平台——如果当前任务只需要某些集成，则此选项很有用（例如，在付费媒体会话中使用“google-ads, google-analytics”）

流程

1. 检查当前上下文：读取 ~/.claude-marketing/brands/_active-brand.json，确认当前启用的品牌；读取 ~/.claude-marketing/credentials/_active-profile.json，确认当前凭据配置文件。切换前显示当前状态。
2. 确认目标品牌存在：确认目标品牌 slug 在 ~/.claude-marketing/brands/{slug}/profile.json 中有已配置的配置文件。如果未找到，从 ~/.claude-marketing/brands/ 列出所有可用品牌，并建议新品牌使用 /digital-marketing-pro:brand-setup，新客户使用 /digital-marketing-pro:client-onboarding 进行设置
3. 检查凭据配置文件是否存在：运行 credential-manager.py --action get-profile --id {slug}，确认目标品牌存在凭据配置文件。如果缺失，说明如何使用所需的平台凭据创建配置文件，并中止操作，提供设置说明
4. 验证凭据配置文件：运行 credential-manager.py --action validate-profile --id {slug}，检查各平台的凭据——确认 API 密钥已提供且非空、OAuth 令牌未过期，并且 .mcp.json 中配置的所有 MCP 服务都已设置必需的环境变量
5. 提供验证摘要：按平台显示验证报告——对每项已配置的服务，列出：
   • 平台名称和类型（广告平台、分析、CRM、社交、电子邮件）
   • 凭据状态：已配置 / 未配置 / 已过期
   • 必需的环境变量：已设置或缺失（注明具体变量名称）
   • 令牌到期日期（如适用）
   • 上次成功连接的时间戳（如有）
6. 检查近期操作：切换前，扫描 python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-history --limit 20，查看当前配置文件下近期记录的执行和交付情况，以确认上下文切换可能造成的影响。追踪器会记录已完成的运行（成功 / 失败）——它不提供实时的“进行中”动态，因此将最近的条目视为可能仍在处理中；如果有看起来仍在进行的操作，请提供具体操作详情并发出警告
7. 确认切换意图：如果验证顺利通过，则自动继续。如果存在警告（缺少非关键凭据、令牌将在 7 天内过期），则显示警告并请求确认。如果缺少关键凭据且未设置 force，则中止操作，并具体说明需要配置的内容
8. 切换凭据：运行 credential-manager.py --action switch-profile --id {slug}，启用目标品牌的凭据配置文件。此操作会更新当前配置文件引用，并为所有 MCP 服务加载对应的环境变量
9. 切换当前品牌：更新 ~/.claude-marketing/brands/_active-brand.json，将目标品牌设为当前品牌上下文，确保品牌配置文件与凭据保持一致，使后续所有命令都使用正确的客户
10. 确认切换成功：重新读取 _active-brand.json 和 _active-profile.json，确认切换已成功完成。如果请求了完整验证，则对关键平台（Google Ads、Analytics、CRM）进行快速连接测试，确认可正常实时访问
11. 记录切换：在 ~/.claude-marketing/credentials/switch-log.json 中记录切换事件，包括时间戳、先前品牌、新品牌、验证结果、任何警告以及原因（如有），以供审计
12. 报告新的当前上下文：显示新的当前品牌名称、slug、行业、业务模式、已配置的平台及其验证状态，以及缺失或即将过期凭据的任何警告。根据常见的切换后工作流，建议相关后续步骤

输出

凭证切换确认信息，包含：

• 先前上下文：切换前处于激活状态的品牌名称、标识和凭证配置文件——方便用户确认切换前使用的配置，并在需要时切换回来
• 新的激活上下文：当前激活的品牌名称、标识、行业、商业模式、主要营销渠道、合作类型和合同状态
• 平台验证报告：各平台状态表格——平台名称、是否已配置（是/否）、环境变量（已设置/缺失，并列出具体变量名称）、令牌状态（有效/已过期/不适用，如适用则显示到期日期）以及连接结果（已验证/未测试/失败，并附错误详情）
• 缺失凭证警告：品牌配置文件中已配置但缺少 API 密钥或令牌的平台，并提供添加凭证的具体说明——要设置哪个环境变量、从哪里获取凭证，以及该平台对当前工作流是必需还是可选
• 凭证即将过期提醒：任何将在 7 天内到期的令牌或密钥，并提供续期说明、紧急程度（提示/需要采取行动/严重）以及未续期的影响
• 活动操作检查：确认没有进行中的操作受到影响，或详细列出切换后可能需要处理的操作警告
• 切换日志条目：时间戳、先前品牌、新品牌、验证摘要、警告数量和原因——记录下来以供审计和故障排查
• 后续步骤：确认消息——“所有操作现在都将使用 [brand_name] 的凭证。已配置的平台：[list]。使用 /digital-marketing-pro:agency-dashboard 查看此客户的状态，使用 /digital-marketing-pro:client-report 生成绩效报告，或再次使用 /digital-marketing-pro:credential-switch 切换回先前的品牌。”

使用的 Agent

• agency-operations — 凭证配置文件管理、平台验证逻辑、活动操作安全检查、切换执行、上下文一致性验证、审计日志记录和切换后建议引擎