系统弃用与迁移
原名:deprecation-and-migration
为旧 API、旧功能和旧系统制定可回退的迁移路线。
中文 Skills 技能说明
用于下线或替换已有能力。技能会梳理使用方、兼容期、数据转换、告警和回退条件,先证明新路径稳定,再停止旧路径,避免直接删除导致用户业务中断。
上游能力依据
上游原始适用说明:Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.
上游 SKILL.md 主要章节(保留原文标题):
- Overview
- When to Use
- Core Principles
- Code Is a Liability
- Hyrum's Law Makes Removal Hard
- Deprecation Planning Starts at Design Time
- The Deprecation Decision
- Compulsory vs Advisory Deprecation
- The Migration Process
- Step 1: Build the Replacement
使用边界
先读取项目约定、依赖版本和现有测试,再提出最小改动。写文件、运行脚本、提交代码或发布前应检查差异并保留回退路径。
作者、翻译与许可证
- 原作者
- Addy Osmani
- 中文翻译
- CEOFans翻译
- 许可证
- MIT
- 上游来源
- https://github.com/addyosmani/agent-skills/tree/f49337711b7a932b4b338c1d4ad73384df8fd87d/skills/deprecation-and-migration
适用范围
平台:linux、macos、windows;标签:Deprecation、Migration、Refactoring
安全提示
基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件,请在最小权限环境中使用,高风险操作必须人工确认。
如发现侵权、许可证或安全问题,可在本页前台提交投诉,管理员复核后可立即下架。