neowolf1712-ghnc9/migration-guide
Developer toolsMajor-version migration guides: mapping tables, ordered steps, rollback, and pitfalls.
Overview
Major-version migration guides: mapping tables, ordered steps, rollback, and pitfalls. 主版本迁移指南（对照表、脚本顺序、回滚、常见坑）。 — 详见 README.zh.md. - 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 Local monorepo: skills/migration-guide/. Full migration doc: overview, tables, steps, automation, rollback, pitfalls, checklist, FAQ. ../../output/samples/migration-guide-example-01.md
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.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add neowolf1712-ghnc9/migration-guide