deprecation-and-migration：安全移除舊功能，不把使用者留在半路
規劃舊 API、功能與系統的棄用期限、相容期、使用者遷移與最後移除。
學完會知道
- 理解 deprecation-and-migration 在開發流程裡負責的工作
- 判斷什麼情況適合使用 deprecation-and-migration
- 完成通用 Skills CLI、Codex 或 Claude Code 安裝
開始前先準備
- 可使用支援 Agent Skills 的 coding agent
- 準備一個能實際驗證的小型開發任務
這個 Skill 在做什麼
規劃舊 API、功能與系統的棄用期限、相容期、使用者遷移與最後移除。
為什麼有用
新增功能有明確完成日，移除舊功能卻常拖成兩套系統長期共存。這個 Skill 先找出使用者與相依者，再安排通知、相容期、量測與真正的刪除條件。
適合什麼場景
- 舊 API 要被新版本取代。
- 兩套重複實作增加維護與安全成本。
- 資料或基礎設施遷移需要分批進行。
和站內相近內容的差別
EOL Message Skill 偏向對客戶說明產品停止服務。deprecation-and-migration 處理技術面與使用者遷移，包含相依盤點、相容期、量測和最後刪除。
如何安裝
想先查看可選清單，可以執行：
npx skills add addyosmani/agent-skills --list只安裝這一個 Skill：
npx skills add addyosmani/agent-skills --skill deprecation-and-migration安裝完整 24 個 Skills：
npx skills add addyosmani/agent-skills這個 Skill 的 SKILL.md 沒有引用上游根目錄的共用 references。只想使用這一個流程時，可以單獨安裝；若會串接其他開發階段，再裝整套會比較省事。
手動安裝時，先 clone 上游 repo，再把整個 Skill 資料夾放進代理使用的 skills 目錄：
git clone https://github.com/addyosmani/agent-skills.git來源資料夾是 skills/deprecation-and-migration/。如果上面列出共用 references，還要保留上游的相對路徑。
Codex
Codex CLI 0.122 以上可安裝整套原生外掛：
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills安裝後重新開啟 session。手動指定時輸入 @deprecation-and-migration；也可以直接描述任務，讓 Codex 依 Skill 的 description 自動選用。
Claude Code
Claude Code 可從 marketplace 安裝：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills此外掛也提供 /spec、/plan、/build、/test、/review、/code-simplify 與 /ship 等流程指令。這些指令會編排對應 Skills，不代表每個指令都只使用本頁這一個 Skill。
自動啟用還是手動指定
手動優先。移除與遷移可能破壞相容性，必須由人明確啟動、核准時間表與最後刪除條件。
在 Codex 手動呼叫的寫法：
@deprecation-and-migration
請依這個 Skill 的原始流程處理目前任務，完成後列出驗證證據。