migrate-eppo 是一个用于把特性开关(feature flags)从 Eppo 迁移到 Confidence SDK 的技能,属于 spotify/confidence-ai-plugins 集合中的 Confidence 插件。它通过读取 Eppo 的 REST API 获取开关定义,并按照明确的约定在 Confidence 中重建开关,再把代码中的 Eppo SDK 调用改造成 Confidence SDK 调用。
【用途与流程】 迁移分为两个阶段:第一阶段处理开关定义,把 Eppo 环境中的开关连同其分配、定向规则和变体拆分迁移到 Confidence;第二阶段处理代码改造,在开关已经存在于 Confidence 后,扫描代码库里的 Eppo 用法,按开关逐个生成改造方案,每个开关对应一个 PR,使改动保持小、可审查、可独立发布。
【主要能力】 技能提供三条命令:/migrate-eppo plan flags 规划开关定义迁移,/migrate-eppo plan code 规划代码改造,/migrate-eppo execute <plan-file> 交互式执行计划。技能强调计划必须自给自足、与具体智能体无关、与语言无关:外部数据只通过显式渠道获取(Eppo REST API 配合 curl,以及 Confidence MCP),不进行临时浏览;执行时不需要再回源查询信息;语言和框架在计划阶段动态检测,并从 confidence-docs MCP 获取对应 SDK 指南。SDK 选型上始终优先 OpenFeature 的本地解析(local resolve),其次是远程解析,仅在平台不支持本地解析时使用,避免直接 SDK。
【迁移范围判定】 由于 Confidence 与 Eppo 的分配哈希不同,同一个主体无法在迁移后保持相同的变体分配。技能在扫描时把每个开关归入一个类别:稳定门控或全量发布可直接迁移;部分曝光(任一分配中曝光比例低于 100)默认排除,用户可在执行时选择加入并确认目标发布比例;正在进行的实验默认排除,因为迁移会打乱分臂并污染指标,应先于 Eppo 结束实验;已结束或陈旧的实验需询问迁移为已确认变体的发布还是排除;Switchback 类型被阻止,因为其按时间窗口分配的方式在 Confidence 没有对应物;在环境中不活跃的开关默认排除,可选择加入后迁移为关闭状态;已归档开关默认跳过;使用不支持操作符(如通用正则匹配、空值判断)的开关会被阻止,直到问题解决。所有被排除的开关都会在计划中列明类别和原因,用户可以在范围确认步骤覆盖默认处理。
【使用方式与前置条件】 Eppo 侧需要一个 Eppo API Key(不是 SDK Key),在 Eppo 仪表盘的 Admin > API Keys 生成,需要具备特性开关的读取权限;Eppo API 基础地址对大多数账户是 https://eppo.cloud/api/v1,自托管或特定区域部署需用户确认;认证头为 X-Eppo-Token。Confidence 侧需要 Confidence MCP,测试命令为 mcp__confidence__listClients,不可用时可通过 claude mcp add confidence --transport http --url https://mcp.confidence.dev/mcp/flags 安装并完成 OAuth 认证;第二阶段还需要 Confidence Docs MCP,测试命令为 mcp__confidence-docs__searchDocumentation,安装命令为 claude mcp add confidence-docs --transport http --url https://mcp.confidence.dev/mcp/docs。
【适用场景】 适用于正在使用 Eppo 管理特性开关、希望迁移到 Confidence SDK 的团队,尤其是希望按开关粒度分批改造代码、以 PR 形式逐步上线、并保留稳定门控类开关行为的场景。它也适合需要自动化扫描、生成可审查迁移计划的开发工作流。
【限制与注意事项】 技能会发送遥测事件以跟踪迁移进度、用户情绪和完成状态,资料说明这些调用失败时会被静默忽略、不阻塞流程。部分曝光和活跃实验类开关默认不迁移,原因是分配哈希不同导致主体分配无法保留。Switchback 和不支持的操作符类型无法迁移。Eppo 目前没有发布 Claude MCP 服务器,因此 Eppo 侧通过 curl 直接调用 REST API。代码改造阶段依赖 confidence-docs MCP 动态获取 SDK 指南,缺少该 MCP 时该阶段无法按设计执行。