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.
Install
npx skills add sandbaseai/workbuddy-skill --skill deprecation-and-migrationgit 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-migrationPersonal 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:公告与迁移契约 公开通知至少包含:
Details
- Skill name
deprecation-and-migration- Repository
- sandbaseai/workbuddy-skill
- 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
Access Control Security Best Practices
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/workbuddy-skill
Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.
Doubt Driven Development
9sandbaseai/workbuddy-skill
Use when a non-trivial decision, high-impact action, unfamiliar code change, or safety-sensitive claim needs a bounded adversarial review before it stands.
Debugging Strategies
9sandbaseai/workbuddy-skill
Use when investigating a reproducible or intermittent bug, performance regression, crash, or unexpected behavior with evidence, bounded hypotheses, minimal experiments, and regression verification.
Feature Dev
5euxx/claude-skills-for-copilot
Guided feature development with multi-agent codebase understanding, architecture design, and implementation review. Use when starting a new feature or implementing a significant change.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.