Deprecation and Migration

Use when replacing or sunsetting an old system, API, library, feature, or schema; plan consumer migration, compatibility windows, usage proof, and safe removal.

9 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill deprecation-and-migration
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/deprecation-and-migration ~/.claude/skills/deprecation-and-migration

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 退役与迁移

代码、API、依赖和功能不仅有开发成本,还有测试、补丁、文档、兼容和认知成本。退役是移除不再值得维护的表面,迁移是把用户和消费者安全地带到替代方案。本 Skill 防止“发一个弃用通知就算完成”,要求先证明替代方案、量化使用者、分阶段迁移、验证零活跃引用,再单独移除旧系统。

## 核心边界

- 先读取真实消费者、依赖图、指标、日志、配置、文档和历史;不要仅凭搜索结果或“没人提过”宣布零使用。
- 生产数据、schema、流量、权限、开关和删除操作默认只读;实施、通知、切流、删除和发布要有独立授权、回滚点和负责人。
- 公开迁移文档只包含经过脱敏的契约、步骤和版本信息,不包含客户数据、凭据、私有地址或内部讨论。
- 数据库 schema 不能依赖一次回滚恢复:添加、回填、切读、停写、删除必须拆成兼容阶段。
- 默认 advisory 弃用;只有安全风险、阻塞关键进展或维护成本明确证明必须强制迁移时,才使用硬截止日期,并同时提供工具、文档和支持。

## 何时使用

- 替换旧系统、API、库或重复实现;
- 下线功能、删除死代码或治理无人维护的“僵尸代码”;
- 迁移生产数据库 schema,尤其是列/表重命名、拆分、合并和删除;
- 在新系统设计阶段规划未来可退役性;
- 需要决定继续维护旧系统还是投入迁移。

## Step 1:做退役决策

在写公告或删代码前回答并记录来源:

1. 旧系统是否仍提供独特价值?如果是,先维护或缩小范围;
2. 有多少用户、服务、脚本、报表、插件和外部消费者依赖它?如何测量;
3. 是否存在覆盖关键用例的替代方案?没有替代方案时不得直接退役;
4. 每个消费者的迁移成本、手工步骤、兼容风险和 owner 是什么;
5. 不迁移的持续成本是什么:安全漏洞、工程时间、依赖风险和机会成本;
6. advisory 还是 compulsory?选择的风险证据、截止日期和升级路径是什么?

形成 decision record,分离 `Observed`、`Estimated` 和 `Unknown`。低活跃度不能直接证明没有隐性消费者,因为未记录的行为也可能已经成为契约。

## Step 2:先构建并证明替代方案

替代方案必须:

- 覆盖旧系统的关键用例和权限模型;
- 有版本化 API/配置、迁移指南、示例、支持渠道和所有者;
- 在目标环境中经过代表性集成/生产证据验证,而不只是“理论上更好”;
- 明确性能、成本、数据一致性、错误语义和可观测性差异;
- 有 feature flag、adapter 或兼容层时,定义启用、退出和清理日期。

若替代方案尚未具备,不宣布最终删除;可以建立并行试用或仅发布设计计划。

## Step 3:公告与迁移契约

公开通知至少包含:
Read the full skill on GitHub

Details

Skill name
deprecation-and-migration
Path
skills/deprecation-and-migration/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Deprecation and Migration skill do?

Use when replacing or sunsetting an old system, API, library, feature, or schema; plan consumer migration, compatibility windows, usage proof, and safe removal.

How do I install the Deprecation and Migration skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill deprecation-and-migration. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Deprecation and Migration popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.