迁移规划器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install migration-planner
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 migration-planner。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Migration Planner 是 Openclaw Skills 的架构规划技能，可检查遗留单体或分布式系统、映射限界上下文、研究技术选项、识别迁移切入点，并制定分阶段现代化路线图。它支持当前代码库、本地路径，以及克隆到临时只读工作区的代码库 URL。
默认目标技术栈为 .NET，包括 Blazor WebAssembly、.NET MAUI、ASP.NET Core、EF Core、YARP 和 OpenTelemetry，同时保留用户选择其他技术栈的自由。每项建议均有研究依据，代码库观察结果附有文件和行号证据，并且在交付进入 SPEC、GitHub Issues 和执行阶段之前，为每个领域制定回滚策略和兼容性测试方法。

应用场景

规划从旧版 WebForms、MVC、WinForms、WPF、Xamarin、jQuery、AngularJS、PHP、Java、Node.js、Python、Delphi 或 COBOL 迁移。
将单体拆分为服务，或将多个服务整合为模块化单体。
使用绞杀者无花果模式逐步现代化系统，而非冒险进行大爆炸式重写。
评估从 .NET Framework 迁移到现代 .NET 或用户选择的其他目标技术栈。
分析源代码库 URL，同时将计划和产物写入单独的持久化目标代码库。
映射限界上下文、依赖风险、共享数据库、集成点和安全债务。
在将已批准工作交给下游执行技能之前，为每个领域创建一份迁移计划和 Draft SPEC。
当目标代码库尚不可用时，生成仅包含分析的路线图。

工作原理

确定源代码库和目标代码库，并区分原地现代化、重写和仅分析模式。
将基于 URL 的源代码库连同完整历史克隆到临时目录，记录 origin 和 HEAD SHA，并确保源代码库严格只读。
如果用户未指定目标技术栈，则使用葡萄牙语（pt-BR）向用户确认；默认推荐 .NET，但绝不强加。
检查代码库根目录、分支、远程仓库、子模块、解决方案布局、可用工具、GitHub 身份验证和同级技能。
执行强制研究，涵盖代码结构、入口点、依赖项、限界上下文、耦合、技术栈版本、EOL 状态、风险、集成和安全债务。
将引用明确的研究产物写入 migration-plan/research/，包括依赖、领域、技术栈、风险和安全债务分析。
使用绞杀者无花果原则选择迁移方向并设计切入点、门面、路由边界、功能标志、数据策略和回滚点。
在 migration-plan/domains/ 下为每个限界上下文创建一份基于证据的领域计划，包含目标架构、迁移步骤、兼容性测试、回滚和成功指标。
在 migration-plan/00-roadmap.md 中汇总执行顺序、领域依赖、横切关注点和未决问题。
为每个领域调用一次 write-specs 以创建 Draft SPEC 文件，然后停在明确的 pt-BR 审批关卡。
获批后，调用 create-issues 为每个领域创建或关联一个 Epic 和一个切片 Issue，并保留路线图依赖关系。
将获批且已关联的 SPEC 交给 orchestrator，然后在 .claude/memory/ 下写入带日期的恢复状态，以便幂等地重新运行。

配置指南

Migration Planner 不会实施应用程序代码，且 SKILL.md 未定义单独的软件包安装命令。请在 Openclaw Skills 主机中注册该技能，使其 references/ 目录可用；如果需要继续规划之外的交付，请确保已安装下游技能 write-specs、create-issues 和 orchestrator。
建议进行以下环境检查：
git status --porcelain
git remote -v
gh auth status
dotnet --info
对于通过 URL 提供的源代码库，工作流会在临时目录中进行完整的只读克隆：
SRC_DIR="$(mktemp -d)/src"
git clone "$SRC_DIR"
git -C "$SRC_DIR" rev-parse HEAD
git -C "$SRC_DIR" remote get-url origin
目标代码库必须是本地路径，或克隆到经用户确认的持久化位置的 URL；不要将 /tmp 用于目标产物。对于私有代码库，请向用户确认访问权限，而不要尝试处理凭据。如果 gh、dotnet、MCP 服务器或配套技能不可用，则将受影响阶段记录为受阻，同时继续独立的规划工作。

数据架构

该技能按研究、路线图、领域、规范和恢复状态职责组织产物。
位置 用途 主要内容
migration-plan/00-roadmap.md 汇总迁移路线图 方向、阶段、执行顺序、依赖、横切关注点和未决问题
migration-plan/research/dependency-map.md 依赖分析 模块、集成、NuGet/npm 依赖项和 file:line 证据
migration-plan/research/domain-candidates.md 限界上下文映射 候选领域和耦合比率
migration-plan/research/stack-research.md 技术验证 遗留版本、EOL 状态、目标技术栈研究、迁移指南和 URL
migration-plan/research/risk-assessment.md 交付风险跟踪 风险矩阵、依赖、缓解措施和迁移限制
migration-plan/research/security-debt.md 安全发现 硬编码机密、过时加密、身份验证问题和已脱敏引用
migration-plan/domains/01-domain-{name}.md 各领域迁移计划 当前状态、目标状态、切入点、步骤、测试、回滚和成功指标
.specs/SPEC-{YYYYMMDD}-{slug}.md 领域交付规范 每个限界上下文一份 Draft SPEC，并关联其领域计划
.claude/memory/migration-planner-{YYYYMMDD}.md 恢复和幂等状态 研究摘要、领域、SPEC 路径、Issue 链接、路线图顺序和待办事项
元数据和证据约定包括源 origin URL、源 HEAD SHA、代码库上下文、代码库声明的 file:line 引用、外部声明的已验证 URL、已脱敏的机密引用、目标技术栈决策、SPEC 状态、Issue 关系和依赖顺序。输出写入目标代码库，绝不写入临时源克隆。

高级特性

完整历史克隆支持共同变更分析，同时确保源代码库保持只读。
证据优先的规划要求代码库观察结果附有
file:line
引用，技术建议附有已验证的 URL。
限界上下文映射通过耦合分析识别可行的迁移领域。
绞杀者无花果设计支持 YARP、ASP.NET Core 中间件、依赖注入切入点、UI 岛屿、事件拦截，以及非 .NET 目标的等效模式。
默认 .NET 目标策略涵盖 Blazor WebAssembly、.NET MAUI、ASP.NET Core、EF Core、OpenIddict 或 Entra ID、OpenTelemetry 和兼容性测试工具，并以当前版本研究为准。
每个迁移步骤都会在淘汰遗留路径之前，加入特征化、兼容性、契约或黄金主测试安全网。
安全防护措施可防止机密和 PII 进入计划，并标记需要重新设计而非直接移植的遗留安全债务。
严格的人为审批关卡可防止在 pt-BR 中明确确认
sim
之前创建 Issues、分支、提交、部署或执行任务。
各领域交接集成
write-specs
、
create-issues
、
orchestrator
、
execute-specs
tdd-spec
，且不会重复创建已有 Issues。
恢复状态文件使重新运行具有幂等性：已映射到 SPEC 或 Issue 的领域不会重新规划。
缺少工具、MCP 服务器或配套技能时会透明降级，并且只阻塞依赖它们的阶段。

name: migration-planner license: MIT
description: "Use when planning the migration of a legacy system or monolith — analyzes the source codebase (current repo, or a repo URL cloned to a temp dir) and produces an evidence-based Strangler Fig migration plan with per-domain SPECs. Default target is .NET (Blazor WebAssembly, .NET MAUI, ASP.NET Core); other stacks allowed by user decision. Do NOT use to implement code or when approved SPECs already cover the migration."