msk-migration-confluentinc-agent-skills

1. 基本信息

项目	内容
名称	msk-migration-confluentinc-agent-skills
作者/维护者	Confluent, Inc.（官方，confluentinc 组织账号）
来源链接	https://github.com/confluentinc/agent-skills/tree/main/skills/msk-migration
许可证	Apache-2.0（GitHub API 获取，仓库级）
GitHub Stars	41（整个 confluentinc/agent-skills 合集仓库；该数字反映合集整体热度，不代表本子技能自身热度，GitHub API 获取）
Forks	4（同上，合集整体，GitHub API 获取）
最新版本	metadata.version 1.0.1；本子技能最近一次内容修订 2026-07-16，仓库整体最近一次推送 2026-07-31（GitHub API 获取）
安装方式	Claude 插件市场一键安装，或 `skills` CLI 按需安装单个技能（见第 10 章）

2. 功能介绍与亮点

这是 Confluent 官方发布的 AWS MSK（Managed Streaming for Apache Kafka）迁移到 Confluent Cloud 的评估与规划技能，主文档近 6 万字节，配 4 篇参考文档（评估方法、KCP 命令手册、MCP 集成、规划方法）与 1 份迁移画像模板。核心能力分三块：

迁移概念问答：Cluster Linking、KCP Gateway / Zero-Cut 免重启切换、Schema Linking 等概念解释，认证方式与网络架构对比，均基于自带参考文档与实时抓取的官方文档作答
环境评估：支持两条路径——若用户已安装 Confluent 开源工具 KCP（github.com/confluentinc/kcp）并有 AWS 凭据，可深度扫描生成 kcp-state.json 作为后续规划的权威画像；若没有，技能引导走约 11 组问题的人工访谈，填充 assets/migration-profile.yaml 达到同等效果——两条路径并存，覆盖了“没装工具/没有云权限”这一常见摩擦场景
迁移方案生成：产出集群类型、容量规划、网络、认证方式、切换方式（Cluster Linking 或 Gateway/Zero-Cut）、Schema 与 Connector 迁移路径、迁移前置工作清单与风险点的完整技术方案

亮点：

官方出品且有正式产品文档背书——Confluent 官方文档站 docs.confluent.io 专门收录本仓库全部技能，非仅托管在 GitHub
明确的认证边界设计：默认保留源端已支持 Confluent Cloud 的认证方式（mTLS/OAuth），仅在无法保留时才降级到 API Key，避免“一刀切”式的方案建议
显式凭据安全条款——正文写明“绝不显示或记录凭据、API Key、bootstrap server 密钥或 .env 文件内容”，且全部认证凭据以 service account 而非用户账号形式创建
明确的越界重定向——涉及集群实际配置、Cluster Linking 搭建、客户端切换等执行阶段操作时，技能主动引导至官方文档与 Confluent 客户团队，不假装能覆盖执行阶段

3. 适用场景

所属分类：DevOps 与基础设施——技能的产出物是消息队列基础设施的迁移评估报告与技术方案（集群选型、容量规划、网络、认证、切换策略），属于基础设施迁移规划范畴，而非对接第三方服务的应用层集成。

适合正在运行 AWS MSK、评估迁移到 Confluent Cloud 的平台工程师、SRE 或数据基础设施团队——无论是否已具备 AWS 权限或 KCP 工具，都能获得一份结构化的评估与迁移方案，可作为立项前的可行性分析材料或迁移项目的规划起点。

4. 跨 Agent 兼容性

Claude Code：原生支持——仓库提供 .claude-plugin/ 插件清单，可通过 /plugin marketplace add 与 /plugin install 直接安装
Codex：未验证——官方文档列出 skills CLI（npx skills add）“支持多数 agent”，但未点名 Codex
OpenClaw：未验证——SKILL.md 遵循标准 YAML front matter + Markdown 正文格式，理论上可迁移，但仓库文档未点名支持
Hermes Agent：未验证——同上，未见任何提及

5. 推荐理由

云消息队列迁移是“评估阶段最容易做错”的基础设施决策之一——容量算少了、认证方式选错了、切换窗口规划不足，都可能在生产环境酿成事故。这份技能把 Confluent 官方的迁移方法论（KCP 工具链、Cluster Linking/Zero-Cut 切换策略、逐项风险清单）封装成 agent 可直接调用的评估与规划流程，且刻意设计了“无需预装工具”的人工访谈兜底路径，让还在可行性评估阶段、尚未接入 AWS 权限的团队也能拿到一份结构化方案。

6. 评分

维度	分数	说明
受欢迎程度	7	由 Confluent 官方发布，服务于其自有产品 Confluent Cloud，并被收录进 Confluent 官方文档站 docs.confluent.io；该子技能自身尚无独立于官方文档之外的第三方讨论或引用证据
可用性	9	`skills` CLI 一条命令即可按需安装；SKILL.md 逾六万字节配 4 篇参考文档与迁移画像模板，示例与操作步骤完整；最近一次内容修订在评估当月内，仓库整体持续活跃；无需额外付费依赖（KCP 工具可选，缺失时有等效人工访谈路径）
安全性	9	纯提示词/参考文档类技能，技能自身不含可执行脚本；仅引导用户自行安装并运行外部开源工具 KCP 扫描环境，扫描行为由用户主导而非技能静默触发；正文显式写明绝不记录或显示凭据、API Key；仓库许可证明确（Apache-2.0）；内容未见任何可疑指令或误导性说明

综合评分：8.3

7. 跟同类 Skills 相比的优势

项目	定位	与本技能的差异
kafka-schema-registry（同仓库）	扫描项目代码识别 Kafka 应用、提取 Schema、生成 Schema Registry 迁移的 Terraform 配置	面向应用代码层的 Schema 治理迁移，产出是代码/配置变更；本技能面向基础设施层的集群迁移评估与规划，产出是评估报告与技术方案，二者迁移对象不同（Schema vs 集群）
Lenses.io Kafka Skills（第三方）	面向 Kafka 生态的通用 AI Agent 技能集，覆盖 Kafka 运维与流处理场景	是覆盖面更广的通用 Kafka 工具集，未见针对“MSK 迁出”这一具体场景的专项评估流程；本技能专注单一迁移路径（MSK→Confluent Cloud），配套官方迁移工具链与切换策略对比
手工迁移评估（无 agent 技能）	依赖工程师人工阅读官方文档、自行梳理评估维度	缺少结构化的评估清单与自动化画像生成能力，容易遗漏容量、认证降级路径等细节；本技能将 Confluent 官方迁移方法论固化为可重复执行的流程

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。

9. 其他补充

同仓库还包含 flink-udf、kafka-streams-programming、developing-kafka-java-client、developing-kafka-python-client、confluent-cloud-cdc-tableflow 等面向不同 Kafka/Flink 开发场景的技能，覆盖从应用开发到基础设施迁移的多个环节，感兴趣的团队可按需在同一仓库中选取安装。

10. 安装使用方式

Claude Code（插件市场）：

/plugin marketplace add confluentinc/agent-skills
/plugin install streaming-skills-plugin@confluent-agent-skills

通用（skills CLI，按需安装单个技能）：

npx skills add confluentinc/agent-skills --skill msk-migration

安装后无需重启 agent；当用户提及“MSK 迁移”“move off MSK”“MSK to CC cutover”等意图时会自动触发。若已安装 Confluent 开源工具 KCP 并具备 AWS 凭据，可获得基于真实环境扫描的深度评估；否则技能会引导走人工访谈路径生成同等效果的迁移画像。

11. 注意事项

技能明确限定为 AWS MSK 迁移场景，不适用于开源 Kafka、Aiven、Confluent Platform 自建集群或 Redpanda 等其他来源的迁移评估
技能仅覆盖“评估”与“规划”两个阶段，实际执行阶段（集群配置、Cluster Linking 搭建、客户端切换）会被引导至官方文档与 Confluent 客户团队，需另行跟进
深度扫描路径依赖用户自行安装并授权外部工具 KCP 访问 AWS 账号，若团队对第三方工具接触云凭据有合规顾虑，建议改用技能内置的人工访谈路径