Agent Skills
› franklioxygen/agent-workflows
› migration-planning
migration-planning
GitHub用于规划安全的数据、API及配置迁移，涵盖兼容性设计、分阶段发布（准备、回填、切换、清理）、验证回滚及部署排序。适用于审查或设计涉及架构变更的发布计划。
Trigger Scenarios
用户要求设计数据库或API迁移方案
需要审查兼容性敏感的发布计划
制定数据回填或特征开关 rollout 策略
Install
npx skills add franklioxygen/agent-workflows --skill migration-planning -g -y
SKILL.md
Frontmatter
{
"name": "migration-planning",
"description": "Plan safe schema, data, API, contract, and configuration migrations with rollout phases, backward compatibility, validation, rollback, data backfill, and deployment sequencing. Use when Codex is asked to design or review a migration, breaking API change, database change, data backfill, feature-flag rollout, or compatibility-sensitive release."
}
Migration Planning
Quick Start
- Run
scripts/migration_signal_scan.py <path>when a repository or change path is available. - Read references/migration-checklist.md before finalizing the plan.
- Follow shared safety, validation, and scope rules in ../_shared/references/skill-operating-rules.md.
- Prefer expand-contract migrations for databases and public contracts.
- Do not run migrations, mutate data, deploy, commit, or push without explicit permission.
Planning Workflow
- Identify what is migrating: schema, data, API, event contract, config, dependency, or runtime behavior.
- Define compatibility requirements: old code with new data, new code with old data, old clients with new API, rollback path.
- Split rollout into phases:
- Prepare: additive changes, dual-read or dual-write, feature flags.
- Backfill: idempotent, resumable, observable data changes.
- Switch: traffic or behavior moves to the new path.
- Contract: remove old fields, code, flags, or compatibility shims only after safety is proven.
- Produce a migration plan with validation and rollback for every phase.
- Mark irreversible steps explicitly and require approval before execution.
Output Rules
- Include deployment order and rollback order.
- Include data validation queries or checks.
- Include monitoring and alerting signals.
- Include blast radius and expected duration.
- State what must be true before removing compatibility code.
Version History
- 063f52c Current 2026-07-05 20:14
