用途
该技能面向 Customer.io 的复杂问题排查与事故响应，适用于诊断复杂的消息投递问题、调查营销活动失败，以及执行事故处理流程。其目标产出包括：一份经过脱敏的最小根因记录（包含受影响环境、关联 ID、证据、缓解措施、负责人和后续行动），以及一套经过验证的恢复方案，避免重复投递、丢失同意状态或泄露收件人数据。
排查框架
对每个问题，先回答五个问题：预期行为与实际行为分别是什么；问题何时开始（检查部署历史与 Customer.io 状态页）；受影响范围是一个用户、一个分群还是所有人；问题出现在管道的哪个环节（API 调用、投递还是渲染）；发生频率是每次、间歇性还是一次性。
主要能力
- API 调试客户端：提供 DebugCioClient 类，封装 identify 与 track 调用，输出属性、耗时、成功/失败状态、状态码与错误信息。
- 用户调查脚本：通过 curl 测试 Track API 连通性，并给出仪表盘检查清单（用户是否存在、是否有 email 属性、是否被抑制、活动记录、分群归属、活动状态与触发事件）。
- 活动调试：列出常见症状与排查路径（活动未触发、用户未匹配、邮件未投递、Liquid 模板损坏、内容错误、发送延迟），并提供程序化触发调试函数。
- 网络诊断：检查 DNS 解析、TLS 证书、延迟采样以及平台状态页。
- 事故响应手册：按 P1（完全中断）、P2（高错误率）、P3（投递问题）、P4（Webhook 处理失败）分级给出处理步骤。
- 诊断命令：提供 API 健康检查、App API 检查与平台状态查询命令。
使用方式
前置条件包括：可访问 Customer.io 仪表盘（建议管理员权限）、应用日志访问权限、用于 API 测试的 curl。使用流程为：先运行 API 调试客户端确认认证与事件追踪是否正常；再用用户调查脚本检查用户画像与分群；随后按活动调试表逐项排查；必要时运行网络诊断；最后按事故等级执行对应手册。
适用场景
生产活动疑似延迟时，可将聚合队列/接收指标与合成对照事件比较，检查工作流/模板版本与不透明关联 ID，确认客户影响后执行文档化的暂停或回滚。升级时提交脱敏包；在验证幂等性与同意状态之前，不要导出收件人列表或重放整个活动。
限制
资料未提供该技能的具体收费、价格、平台支持范围或效果保证。部分操作（如导出收件人列表、重放活动）被明确禁止，除非已验证幂等性与同意状态。故障排查完成后，可继续使用 customerio-reliability-patterns 实现容错。