Migration Planner 是一个用于现有网站迁移的技能,定位为规划与验证优先,而不是生产环境变更工具。它的核心目标是创建可回滚的迁移计划,帮助团队在迁移前明确 URL 变更、重定向策略、SEO 资产保留、上线验证与回滚监控。
用途 该技能适用于需要对已有网站进行迁移的场景,例如更换域名、调整 URL 结构、重建或改进站点。它从 existing-site-analyzer 的证据和 rebuild-or-improve-advisor 的决策出发,确保迁移计划建立在已有分析结论之上,而不是凭空制定。
主要能力 技能提供五种操作模式:
- url-map:将旧 URL 映射到新 URL,并识别 canonical 决策。
- redirect-plan:规划 301/302 重定向规则,但不实际应用。
- seo-surface:保留标题、描述、标题标签、schema、sitemap、robots、llms.txt 与内部链接。
- launch-checklist:定义上线前、上线时与上线后的验证事项。
- rollback:准备回滚方案、监控与告警标准。
使用方式 技能要求遵循固定工作流:首先阅读 references/migration-safety-contract.md;然后从 existing-site-analyzer 证据与 rebuild-or-improve-advisor 决策开始;使用 assets/migration-plan.template.md 模板;构建 URL/变更映射,包含旧 URL、新 URL、状态、重定向类型、canonical 规则、元数据/schema 保留说明;再加入 sitemap、robots、schema、内部链接、llms.txt、分析工具与站长工具验证检查;所有生产操作在用户明确批准部署、DNS、重定向、GSC/站长工具或服务器变更之前,均标记为 Planned。
交接结构 技能定义了交接形状,包含:迁移模式、决策来源、URL 映射路径、重定向计划、SEO 表面保留、所需上线批准、回滚计划、监控、下一负责人、检查项。
适用场景 适用于需要规划网站迁移、重定向策略、SEO 资产保留、上线检查与回滚监控的团队,尤其关注迁移安全与可回滚性的场景。
限制与安全规则 技能明确禁止在未获得明确批准的情况下应用重定向、在生产环境编辑 robots/sitemap、部署、变更 DNS 或提交 GSC/站长工具变更。不得在计划中存储私有分析导出、令牌、Cookie 或验证码。除非命令或产物存在,否则不得将迁移检查标记为 Ran。如果仍存在高 SEO 风险,在定义回滚与监控之前阻止上线交接。
验证 编辑该技能时,需运行以下命令: python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/migration-planner python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/migration-planner python3 -m json.tool $CODEX_HOME/skills/migration-planner/evals/evals.json >/dev/null