主要版本迁移指南：映射表、有序步骤、回滚和陷阱。
概览
主要版本迁移指南：映射表、有序步骤、回滚和陷阱。 主版本迁移指南（对照表、脚本顺序、回滚、常见坑）。— 详见 README.zh.md。 - 构建API、标志和配置的前后表 - 命令升级步骤（包括代码模组槽位） - 文档回滚和不可逆数据风险 - 提供复制粘贴检查表和陷阱列表 本地单仓库：技能/迁移指南/。 完整迁移文档：概述、表格、步骤、自动化、回滚、陷阱、检查清单、常见问题解答。 ../../output/samples/migration-guide-example-01.md
概述（AI 翻译）
主要版本迁移指南：映射表、有序步骤、回滚和陷阱。
中文简介： 主版本迁移指南（对照表、脚本顺序、回滚、常见坑）。— 详见 README.zh.md。
这项技能的作用
- API、标志和配置的前后表构建
- 订单升级步骤（包括代码修改槽）
- 文档回滚和不可逆数据风险
- 《Ship》一份复制粘贴清单和陷阱列表
安装
本地单一注册：skills/migration-guide/。
选项
| 选项 | 值 | 默认 |
|---|---|---|
lang |
en ·zh ·bilingual |
en |
from_to |
例如1.x→2.0 |
来自用户 |
surface |
library ·cli ·api ·sdk ·mixed |
library |
automations |
none ·codemod ·script ·both |
none |
length |
lite ·standard ·full |
standard |
何时使用
| 使用 | 不要 |
|---|---|
| vN → vN+1 带休息 | 仅补丁发布说明 |
| 支持需要可执行步骤 | 发明不在差异中的 API |
| Codemod + 手动修复路径 | 在单一变更日志行中隐藏断点 |
交付
完整迁移文档：概述、表格、步骤、自动化、回滚、陷阱、检查清单、常见问题解答。
参见SKILL.md。
示例
`…/…
本页由 AI 翻译，技术细节请以原文为准。
README
Migration Guide
Major-version migration guides: mapping tables, ordered steps, rollback, and pitfalls.
中文简介： 主版本迁移指南（对照表、脚本顺序、回滚、常见坑）。 — 详见 README.zh.md.
What this skill does
- Builds before/after tables for APIs, flags, and config
- Orders upgrade steps (including codemod slots)
- Documents rollback and irreversible data risks
- Ships a copy-paste checklist and pitfalls list
Install
npx skills add / --skill migration-guide
Local monorepo: skills/migration-guide/.
Options
| Option | Values | Default |
|---|---|---|
lang |
en · zh · bilingual |
en |
from_to |
e.g. 1.x→2.0 |
from user |
surface |
library · cli · api · sdk · mixed |
library |
automations |
none · codemod · script · both |
none |
length |
lite · standard · full |
standard |
When to use
| Use | Don’t |
|---|---|
| vN → vN+1 with breaks | Patch-only release notes |
| Support needs executable steps | Invent APIs not in the diff |
| Codemod + manual fix path | Hide breaks in a single changelog line |
Deliverable
Full migration doc: overview, tables, steps, automation, rollback, pitfalls, checklist, FAQ.
See SKILL.md.
Example
../../output/samples/migration-guide-example-01.md
License
MIT — see LICENSE.
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add neowolf1712-ghnc9/migration-guide