1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | legacy-migration-planner |
| 作者/维护者 | Felipe Rodrigues（github.com/felipfr），发布于 Tech Leads Club 社区技能市场 |
| 来源链接 | https://github.com/tech-leads-club/agent-skills/tree/main/packages/skills-catalog/skills/(architecture)/legacy-migration-planner |
| 许可证 | CC-BY-4.0（技能自身，SKILL.md frontmatter 明确标注；仓库引擎代码另为 MIT） |
| GitHub Stars | 所属仓库整体 5,019（数据来源：GitHub API；该数字属 88 个技能共享的合集市场热度，不代表本技能个体） |
| Forks | 458（数据来源：GitHub API，仓库整体） |
| 最新版本 | SKILL.md 自述版本号 1.0.0；所属目录最近一次内容更新 2026-02-26（数据来源：GitHub API 提交历史） |
| 安装方式 | npx @tech-leads-club/agent-skills 交互式向导选装，或 agent-skills install -s legacy-migration-planner -a claude-code |
2. 功能介绍与亮点
legacy-migration-planner 是一个“高级迁移架构师”技能，专门产出证据驱动的遗留系统迁移计划——它只做规划，不写实现代码，执行交给用户或其他 agent。核心方法建立在 Strangler Fig（绞杀者无花果）模式之上，覆盖单体拆微服务、微服务收敛回模块化单体、跨语言重写、跨框架升级等任意迁移方向。
流程分两个强制阶段：
- RESEARCH（研究）：逐行分析现有代码库并标注具体
file:line；用 web 搜索与 context7（可用时）核实目标技术栈的最新文档与迁移陷阱；识别候选业务域边界；绘制依赖与风险矩阵。任何未经代码定位或未经外部核实的技术推荐都被明确禁止。 - PLAN（规划）：基于研究结论选定迁移方向与切割点，设计 facade/router 过渡层；为每个业务域单独产出一份迁移文件（现状、目标状态、迁移步骤、测试安全网、回滚方案、成功指标）；最后汇总为一份带阶段排期的总路线图。
配套 6 份独立参考文档（研究方法、规划方法、Strangler Fig 模式选型、评估与风险框架、测试安全网、前后端迁移专项策略），按需渐进加载，避免一次性占满上下文。技能明确写死“禁止猜测缩写或业务术语”“每条结论必须可追溯到具体代码行或外部链接”“不写实现代码”三条硬约束，纪律性在同类技能中较为突出。
3. 适用场景
所属分类：工程效率与代码质量
适合团队计划把遗留单体、旧框架系统或过度拆分的微服务迁移到新架构，需要一份可追溯证据、而不是泛泛而谈的迁移建议时使用。目标用户是负责推动系统现代化改造、需要向团队或管理层交付一份严谨迁移路线图的技术负责人。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。安装方式与所属市场其余技能一致，正文不依赖 Claude 专属交互工具。
- Codex：⚠️ 需适配。所属仓库官方支持列表明确包含 OpenAI Codex，但技能依赖的 context7 属可选 MCP 工具，Codex 环境若未接入会自动降级为纯 web 搜索，不影响核心流程可用性。
- OpenClaw：⚠️ 需适配。内容为标准 YAML frontmatter + Markdown 格式，理论上可手工迁移，但未见官方为 OpenClaw 提供的安装路径或测试。
- Hermes Agent：❓ 未验证，抓取到的材料中未提及该平台。
5. 推荐理由
多数迁移规划类技能给的是一份通用清单式建议，这一个把“先证据后结论”写成了硬约束：研究阶段必须先读代码、标行号、查最新文档，规划阶段才允许动笔，且每个业务域单独出一份含回滚方案的迁移文件，而不是一份笼统的路线图。对于需要向团队证明“这个迁移方案不是拍脑袋”的场景，这种强制留痕的工作方式比自由发挥的迁移建议更可复核。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 所属技能市场整体 5,019★，为 88 个技能共享的合集热度，不代表本技能自身；截至目前未检索到针对本子技能的独立第三方目录页面或具名讨论 |
| 可用性 | 8 | npx 一条命令即可交互安装，无需额外配置或付费依赖；SKILL.md 正文 + 6 份参考文档结构清晰、含完整工作流与输出模板；所属目录最近一次内容更新为 2026-02-26，距今约半年，此后未见针对性修订 |
| 安全性 | 9 | 技能内容全部为 Markdown 指令与参考文档，不含任何可执行脚本，无本地命令执行、无自身网络外发、无凭据索取；License（CC-BY-4.0）清晰；所属市场对目录内全部技能发布前统一执行 Snyk Agent Scan 静态扫描 |
| 综合分 | 7.33 | 三项均值 |
安全检查清单：①无 shell 命令执行，纯文本指令 ②无自身外联（研究阶段引导 agent 使用其自带的 web 搜索能力，非技能自带外发通道） ③无需 API Key 或凭据 ④通读 SKILL.md 与全部 6 份参考文档未见可疑指令或混淆内容 ⑤市场统一静态扫描 + 作者具名 ⑥License 清晰（CC-BY-4.0） ⑦所属目录最近内容更新 2026-02-26
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| legacy-migration-planner（本技能） | 端到端迁移策略：研究现状→定方向→设计切割点→逐域出计划→汇总路线图，含回滚与测试安全网 | 覆盖研究、方向判定、执行细节三个层次，产出物是可执行的分域迁移文件而非单一清单 |
| decomposition-planning-roadmap（同市场同目录） | 只负责“先拆哪个后拆哪个”的排序与优先级路线图 | 假定拆分候选已经识别完毕，不含代码库证据链、目标栈调研或回滚设计，更适合作为规划阶段的下游补充 |
| domain-driven-design-wondelai-skills | 领域驱动设计方法论参考与打分诊断，教如何划分限界上下文与聚合 | 面向“该怎么设计边界”这个建模问题，不产出迁移执行计划；可与本技能配合——先用它定边界，再用本技能规划怎么搬 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价或独立收录页面。
9. 其他补充
该技能隶属 Tech Leads Club 社区技能市场（@tech-leads-club/agent-skills）的“架构”类别，该市场以 npm 包分发、内置审计日志（agent-skills audit）与本地缓存管理，全部技能发布前经过统一的 Snyk Agent Scan 静态扫描。
10. 安装使用方式
交互式安装：npx @tech-leads-club/agent-skills，按向导选择 “Install skills” → 搜索 “legacy-migration-planner” → 选择目标 Agent → 选择复制或软链接方式。
命令行直装：agent-skills install -s legacy-migration-planner -a claude-code
安装后无需重启。在对话中提出“帮我规划一下这个系统的迁移方案”或提及“绞杀者模式”“单体拆微服务”“跨语言重写”等诉求即可触发；技能会先执行强制研究阶段（读代码、标行号、查最新文档），确认候选域与风险后才进入规划阶段产出文件。
11. 注意事项
- 技能只产出规划文件，不写实现代码，也不代为执行迁移——落地仍需人工或其他 agent 接手。
- 研究阶段依赖 web 搜索能力核实技术选型；context7 为可选增强，不可用时自动降级，不影响核心流程。
- 所属目录最近一次内容更新为 2026-02-26，此后未见针对性修订，长期维护频率有待观察。
- 产出物为多份独立 Markdown 文件（总路线图 + 分域计划 + 研究记录），使用前需为项目预留一个输出目录。