deprecation-and-migrationcommit 9f91cc4SKILL.md · 架构调优
弃用与迁移
指导如何下线旧系统、API 或功能，把使用方安全迁移到新实现，并用扩展/收缩方式完成数据库结构变更。
npx skills add addyosmani/agent-skills --skill deprecation-and-migration已选中命令，请手动复制。
- 权限
- read-repo
- write-files
- shell
- network
- 兼容工具
- Claude Code, Codex, Cursor, Copilot, Gemini CLI
- GitHub
- 112.3k
- 来源
- 社区 · Addy Osmani
- 状态
- 扫描通过
- 许可证
- MIT
- 分类
- 架构调优
核心规则
没有可用的替代方案就不要弃用，数据库列也绝不原地修改。
执行阶段
阶段 01做弃用决策
评估系统是否仍有独特价值、依赖方数量、迁移成本和继续维护的代价，默认选择建议式弃用。
阶段 02先建替代方案
替代方案需覆盖关键用例、附带文档和迁移指南，并已在生产环境验证，然后发布弃用公告。
阶段 03逐步迁移
逐个迁移使用方，可用绞杀者模式、适配器或功能开关；数据库按扩展、回填、收缩分阶段进行。
阶段 04移除旧系统
通过指标和日志确认零使用后，删除旧代码、测试、文档、配置和弃用公告。
权限说明（据 SKILL.md 整理）
| 能力 | 是否需要 | 说明 |
|---|---|---|
| 文件写入 | 需要 | 编写替代代码、适配器、迁移脚本和弃用公告，并删除旧代码及相关测试和文档。 |
| 命令执行 | 需要 | 运行测试和集成检查以验证行为一致，并在合并前执行迁移的回滚（down）路径。 |
| 网络外发 | 不需要 | 技能未要求访问外部网络或服务。 |
SKILL.md 头部信息（YAML）
---
name: deprecation-and-migration
description: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.
---相关技能
规则扫描无法覆盖所有风险，安装前请阅读此技能的 SKILL.md，确认权限后再使用。