1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | deprecation-and-migration-addyosmani-agent-skills |
| 作者/维护者 | Addy Osmani（addyosmani/agent-skills 仓库维护者） |
| 来源链接 | https://github.com/addyosmani/agent-skills/tree/main/skills/deprecation-and-migration |
| 许可证 | MIT（GitHub API 核实） |
| GitHub Stars | 合集仓库整体 80,943；该数字属整个合集仓库，不代表本技能自身热度（GitHub API） |
| Forks | 8,735（仓库整体，GitHub API） |
| 最新版本 | 无独立版本号；子目录最近一次功能性提交为 2026-06-27（GitHub API commits 核实）；所属仓库最新发布版本 0.6.5（2026-07-26） |
| 安装方式 | npx skills add addyosmani/agent-skills --skill deprecation-and-migration，或手动复制 skills/deprecation-and-migration/ 目录 |
2. 功能介绍与亮点
deprecation-and-migration 把“什么时候该拆、拆了怎么迁”这两件工程里最容易被拖延或做错的事，变成一套可直接照抄的决策框架与迁移模式集合，核心立场是代码是负债而非资产——每一行代码都有持续的维护成本，功能价值不等于代码本身的价值。
核心内容包括：
- 弃用决策五问：是否仍提供独特价值、有多少消费者依赖它、替代方案是否存在、每个消费者的迁移成本、不弃用的持续维护成本——五问按顺序回答完即可判断维护还是拆除。
- 强制 vs 建议性弃用：建议性弃用（无硬截止日期，靠文档与警告）与强制性弃用（有安全风险或维护成本不可持续时的硬截止日期+必须提供迁移工具）的适用边界与操作差异。
- 四步迁移流程：先建替代方案（不能空手弃用）→ 公告并文档化 → 按“责任规则”（谁拥有旧系统谁负责把用户迁移过去）逐个消费者迁移 → 确认零使用后移除旧系统。
- 四种迁移模式：Strangler Pattern（新旧系统并行、流量逐步切换）、Adapter Pattern（适配器包一层旧接口调用新实现）、Feature Flag Migration（按标志位逐用户切换）、数据库 Schema 迁移的 Expand/Contract 模式——附带“
name字段改名为full_name“的完整分步实操示例（扩展加列→双写→回填→切读→收缩删列各自独立部署，每一步都可单独回滚）。 - Zombie Code（僵尸代码）识别：给出“6 个月无提交但仍有消费者”“无人认领”“依赖有已知漏洞却无人升级”等具体信号，要求要么指派owner维护、要么走弃用流程,不能无限期搁置。
- 常见借口对照表与红旗清单：把“先加列再删旧列，就一行代码的事”这类真实场景中的合理化借口逐条反驳，并列出“schema 改动与依赖它的代码在同一次部署中上线”等危险信号。
3. 适用场景
所属分类：工程效率与代码质量。适合需要下线旧系统/旧 API、把用户从一套实现迁移到另一套、或正在纠结“这段没人管但还有人依赖的代码到底该不该留”的初中级开发者与团队；数据库 Schema 迁移一节尤其适合处理“字段改名”“表结构调整”这类容易一步走错就锁表或线上报错的高风险变更。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 仓库提供专属 Claude Code marketplace 安装流程（/plugin marketplace add + /plugin install） |
| Codex | ✅ 原生支持 | 仓库另提供 Codex 原生插件安装路径（codex plugin marketplace add），通过 .codex-plugin/plugin.json 直接读取 skills/ 目录，装好后用 @deprecation-and-migration 触发 |
| OpenClaw | ✅ 支持（通用安装器） | README 推荐的第三方通用 CLI vercel-labs/skills 官方 Supported Agents 表格列出 openclaw，安装路径 ~/.openclaw/skills/ |
| Hermes Agent | ✅ 支持（通用安装器） | 同一 CLI 的 Supported Agents 表格列出 hermes-agent，安装路径 ~/.hermes/skills/ |
5. 推荐理由
“这段代码还留不留”“这次迁移该怎么分步走”这类问题很容易凭直觉拍板，拍错了轻则留下没人敢动的僵尸代码，重则一次 Schema 改名就锁表或让线上报错。这份技能把两件事都变成了可以直接照抄的流程：弃用该走建议性还是强制性、迁移该用哪种模式、Schema 改动为什么必须拆成扩展-回填-收缩三个独立部署而不能一步到位——每一步都给了具体做法而不是“要谨慎”这种原则性提醒，能帮初中级开发者省下大量“这样做安不安全”的判断成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 子目录提交历史中，一位在 GitHub 上有一定关注度的独立外部贡献者提交并被合并入正文的“数据库 Schema 迁移（Expand/Contract）“整节内容，属实质性、已生效的外部参与；仓库整体 80,943 stars 属整个合集仓库，不代表本技能自身热度 |
| 可用性 | 9 | 单文件 SKILL.md 内容完整详尽，覆盖决策框架、四种迁移模式、完整分步实操示例与两套验证清单；仓库自带该子技能专属的自动化评测夹具（evals/cases/deprecation-and-migration.json）；纯 Markdown 复制即用，无需任何配置或付费依赖；子目录本身近 1 个月内有实质性更新 |
| 安全性 | 9 | 详见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① shell 命令与权限范围 | 无任何脚本或 shell 命令，正文仅含 TypeScript/Markdown 伪代码示例，均为讲解用途 |
| ② 运行时联网外发 | 无，纯本地文档阅读与决策指导，不涉及任何网络请求 |
| ③ API key/凭据 | 不涉及，技能本身不处理任何凭据 |
| ④ 可疑指令 | 逐段检读 SKILL.md 全文，未发现隐蔽指令或提示注入迹象 |
| ⑤ 作者/组织信誉 | 个人开源作者（前 Google Chrome DevRel），仓库完全开源可审计 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 子目录本身最近提交 2026-06-27，所在仓库整体持续活跃维护（最近一次推送 2026-07-26，最新发布 0.6.5） |
综合评分（三项均值）：8.33
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 deprecation-and-migration 的差异 |
|---|---|---|
| contentful-migration（contentful/skills） | Contentful CMS 内容模型迁移执行工具，聚焦单一 CMS 平台的数据结构变更操作 | 只覆盖 Contentful 这一个平台的具体迁移动作；deprecation-and-migration 不绑定任何具体产品，提供的是“该不该弃用、怎么分阶段迁移”的通用决策框架，适用于任意技术栈 |
| databricks-migration（microsoft/skills-for-fabric） | 面向 Databricks 迁移到 Microsoft Fabric 平台的一次性数据平台迁移向导 | 只解决“从 A 平台搬到 B 平台”这一个具体迁移任务；deprecation-and-migration 覆盖 API、数据库 Schema、整个系统弃用等更广的场景，且额外提供 Zombie Code 识别与弃用类型判断，不局限于平台间搬迁 |
| migrate-radix-to-base-shadcn-ui | 专攻一次性 UI 组件库替换（Radix UI 迁移到 Base UI/shadcn） | 只处理前端组件库这一类窄场景的具体替换步骤；deprecation-and-migration 是跨场景的通用方法论，Strangler/Adapter/Feature Flag/Schema Expand-Contract 四种模式可组合应用于组件库替换之外的任何系统迁移 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。已知的外部参与是 GitHub 提交记录中一位独立贡献者补充的“数据库 Schema 迁移（Expand/Contract）“整节内容，该内容已被合并进正文并成为该技能目前篇幅最长、示例最完整的部分。
9. 其他补充
deprecation-and-migration 是 addyosmani/agent-skills 工程技能库（覆盖 Define/Plan/Build/Verify/Review/Ship 全生命周期共 24 个技能）中 Ship 阶段的成员，与同仓库的 ci-cd-and-automation、shipping-and-launch、observability-and-instrumentation 等技能定位互补，可在同一项目中前后配合使用。该技能拥有仓库自带的专属自动化评测夹具（evals/cases + evals/fixtures 结构），说明其内容质量有回归测试托底，而非仅靠人工维护。
10. 安装使用方式
- 通用 CLI（推荐，覆盖全部四个目标 Agent）：
npx skills add addyosmani/agent-skills --skill deprecation-and-migration - Claude Code Marketplace：
/plugin marketplace add addyosmani/agent-skills /plugin install agent-skills@addy-agent-skills - Codex 原生插件：
安装后用codex plugin marketplace add addyosmani/agent-skills@deprecation-and-migration触发 - 手动安装：克隆仓库后，将
skills/deprecation-and-migration/整个目录复制到对应 Agent 的 skills 目录（如 Claude Code 的~/.claude/skills/） - 安装后注意事项：无需重启 Agent；用“这段代码还要不要留”“帮我规划这次迁移”“这个字段改名怎么分步上线”等触发短语调用
11. 注意事项
- 技能提供的是决策框架与迁移模式，不是自动化迁移工具——Feature Flag 基础设施、灰度路由、Schema 回填脚本等仍需用户自行搭建或调用其他工具完成
- Schema 迁移示例以关系型数据库为背景给出，非关系型存储或特殊约束的场景需要自行调整具体步骤，但 Expand/Contract 的分阶段思路可直接套用
- 强制性弃用要求“提供迁移工具+文档+支持”，技能本身只给出这个要求，不提供现成的迁移工具生成能力