开发与工程

系统弃用与迁移指南

帮助工程团队安全淘汰旧系统、迁移用户并验证移除结果。

48/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 107k
最近更新
13 天前
License
MIT
deprecationmigration-planninglegacy-codedatabase-migrations
+2feature-flagsexpand-contract

这个 Skill 能做什么,适合哪些场景?

这是一个面向软件工程团队的弃用与迁移工作流技能,适用于旧系统、API、库或功能的替换与下线。它要求先评估系统价值、用户规模、替代方案和维护成本,再选择渐进式迁移策略。内容涵盖绞杀者模式、适配器、功能开关,以及数据库的扩展—迁移—收缩流程。完成弃用后,技能要求通过指标、日志和依赖分析确认没有活跃使用者,并清理旧代码及相关文档。

引导代理判断是否应维护或弃用现有系统,区分建议式与强制式弃用,规划替代方案、公告、迁移指南和分批迁移步骤。它提供绞杀者模式、适配器模式、功能开关迁移和数据库扩展—迁移—收缩的操作模板。它还要求检查活跃消费者、测试回滚路径、批量执行数据回填,并在移除后验证旧代码、测试、文档和配置是否已清理。

适合
  • 负责旧 API 替换的工程师,需要评估消费者数量、迁移成本和替代方案是否就绪。
  • 准备下线不再需要的产品功能的团队,需要制定公告、迁移工具和移除时间表。
  • 维护重复实现或无人负责的遗留代码的团队,需要决定继续指定负责人还是制定迁移计划。
  • 进行数据库字段或模式变更的开发团队,需要避免在同一次发布中直接重命名或删除字段。
  • 需要低风险切换服务实现的团队,希望通过适配器、功能开关或分阶段流量迁移完成切换。

如何安装这个 Skill?

使用前请注意
  • 这是静态审查,未执行任何迁移、脚本或 CI;不要将文档中的“production-proven”或验证清单视为已证实事实。
  • 应用该技能时应先获得用户对弃用、数据变更和删除范围的明确确认,并补充备份、回滚、权限和敏感数据处理方案。
  • 仓库发布者未通过 FollowSkills 企业注册表验证,身份应视为未知;使用前应独立核实来源和维护状态。
开始前你需要
Agent 需要具备
  • 本地文件系统

该技能属于包含 24 个技能的仓库。安装整个集合:npx skills add addyosmani/agent-skills。先浏览可用技能:npx skills add addyosmani/agent-skills --list。只安装本技能:npx skills add addyosmani/agent-skills --skill deprecation-and-migration。仓库也提供 Claude Code、Cursor、Antigravity CLI、Gemini CLI、Codex 等工具的安装方式;具体平台步骤见仓库 README。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/deprecation-and-migration" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

在已加载该技能的编码代理中提出具体任务,例如:评估是否应弃用 OldService,并制定包含替代方案、消费者迁移、回滚路径和最终移除验证的计划。 也可以请求:为 name 到 full_name 的数据库字段迁移设计扩展—迁移—收缩步骤。 SKILL.md 未规定专用命令、脚本或固定输出格式。

这个 Skill 有哪些优点和局限?

优点
  • 提供从决策、公告、分批迁移到最终移除的完整流程。
  • 明确强调替代方案、迁移工具、使用量验证和回滚路径。
  • 包含数据库模式变更的可逆分阶段方法,并要求破坏性操作单独发布。
  • 通过常见借口、红旗和验证清单约束迁移质量。
局限
  • 内容是通用工程工作流,没有针对特定语言、数据库或部署平台的实现脚本。
  • 源材料没有提供测试结果、性能数据或实际采用案例。
  • 迁移成本、消费者规模和维护成本仍需要使用者自行收集和量化。
  • 数据库示例以 TypeScript 和通用数据库流程说明,不能直接视为所有技术栈的可执行方案。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
系统弃用与迁移指南 本页 48 · 谨慎使用 ★ 107k 13 天前 MIT
Supabase 开发助手 55 · 谨慎使用 ★ 2.8k 24 天前 MIT
Azure 应用配置 Python 技能 ✓ Microsoft · 官方 53 · 谨慎使用 ★ 2.7k 3 个月前 MIT
增量实现 52 · 谨慎使用 ★ 107k 13 天前 MIT
Azure 应用配置 TypeScript 技能 ✓ Microsoft · 官方 47 · 谨慎使用 ★ 2.7k 3 个月前 MIT

仓库 README 提到可与 Superpowers 和 Matt Pocock's skills 对比,并链接到比较文档;提供的源材料没有给出针对本技能的具体差异,因此无法进一步判断。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
48/ 100 五分制 2.4 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全13 / 25 · 2.6/5

技能明确要求渐进迁移、零消费者验证、指标/日志检查、分阶段数据库变更和可测试 down path,降低破坏性风险;但未规定用户确认、最小权限、数据流披露、敏感数据处理、依赖安全或一般迁移的回滚机制,因此扣分。

2可靠稳定8 / 20 · 2.0/5

流程结构一致,包含决策问题、迁移步骤、模式、红旗和验证清单;但没有可执行脚本、异常输入处理、失败反馈或针对该技能关键路径的专门测试,静态评估下不超过10分,故扣分。

3适用触发10 / 15 · 3.3/5

触发场景和主要适用任务清楚,覆盖系统、API、功能及数据库迁移;但未明确非适用边界、输入输出契约、语义触发排除条件,也未提供中文支持或中国大陆网络环境说明,故扣分。

4规范维护8 / 15 · 2.7/5

文档分层清晰,包含 frontmatter、流程、示例、模式、红旗和验证清单;仓库提供 MIT 许可、团队信息和安装说明,但该技能没有版本、变更记录、明确维护责任或更新路径,故扣分。

5有效结果6 / 15 · 2.0/5

内容能直接指导弃用决策、增量迁移和 expand/contract 数据库变更,具有较强实用性;但没有可直接运行的迁移工具或经过验证的代表性输出,非数据库场景的回滚、确认和支持流程也不完整,静态上限为7分,故扣分。

6证据核验3 / 10 · 1.5/5

技能提供检查清单和具体步骤,仓库 CI 会验证整体技能结构并运行评估;但未见该技能专属测试、第三方证据或可独立复现的结果,且 CI 覆盖范围与本技能关键行为的对应关系不明,故仅给有限分数。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 2fbfa004a019 评估证据[1][2][3][4][5]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能是否需要额外的软件或服务?
SKILL.md 没有指定 Node.js、数据库、容器、MCP 或网络服务依赖。实际迁移仍需要访问目标代码库及其指标、日志和依赖分析数据。
它是否建议立即强制用户迁移?
不建议默认强制迁移。技能默认采用建议式弃用,只有安全风险、进展受阻或维护成本不可持续时才使用强制式弃用。
数据库字段可以直接重命名吗?
不建议。技能要求采用扩展、回填和收缩阶段,并让旧代码与新代码在每个发布步骤中都保持有效。
什么时候才可以删除旧系统?
只有在替代方案已覆盖关键用例、所有活跃消费者都已迁移,并通过指标、日志或依赖分析确认零活跃使用后,才应移除旧系统。

同仓库的其他 Skills

均来自 addyosmani/agent-skills

开发与工程

增量实现

用可验证的小步迭代安全交付多文件工程变更。

★ 107k FS 52 谨慎使用 13 天前
自动化与运维

CI/CD 自动化工程指南

为项目建立可验证、可回滚的持续集成与部署流水线。

★ 107k FS 48 谨慎使用 13 天前
自动化与运维

安全发布助手

帮助工程团队以可观测、可回滚、渐进式的方式将变更发布到生产环境。

★ 107k FS 46 谨慎使用 13 天前
开发与工程

代码简化审查

在不改变行为的前提下,降低代码复杂度并提升可读性与可维护性。

★ 107k FS 57 谨慎使用 13 天前
开发与工程

规范驱动开发

在编码前把模糊需求转化为可验证的开发规范。

★ 107k FS 55 谨慎使用 13 天前
开发与工程

性能优化工程技能

通过测量、定位和验证,系统解决前端、后端、查询与数据库性能瓶颈。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

规划与任务拆解

将明确需求拆分为有依赖顺序、可实现且可验证的工程任务。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

怀疑驱动开发

在非平凡决策落地前,用新上下文主动寻找错误。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

合并前代码质量审查

在合并前从正确性、可读性、架构、安全性和性能五个维度审查代码变更。

★ 107k FS 49 谨慎使用 13 天前
开发与工程

工程技能导航器

根据任务阶段发现并调用合适的工程工作流技能。

★ 107k FS 46 谨慎使用 13 天前
开发与工程

浏览器 DevTools 测试

用真实浏览器运行数据验证、调试并测试网页应用。

★ 107k FS 59 推荐 13 天前
开发与工程

需求访谈助手

在规划或编码前,通过逐题访谈确认用户真正想解决的问题。

★ 107k FS 59 推荐 13 天前
开发与工程

测试驱动开发工作流

用可执行的测试先证明需求,再以最小改动实现、重构并验证行为。

★ 107k FS 57 谨慎使用 13 天前
开发与工程

Git 协作与版本发布规范

用可审查、可回滚的 Git 流程管理代码变更与版本发布。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

架构决策与工程文档助手

帮助工程团队记录决策依据、维护文档并保留长期代码上下文。

★ 107k FS 53 谨慎使用 13 天前
设计与前端

生产级前端界面工程

帮助 AI 编码代理构建可访问、响应式且符合设计系统的生产级用户界面。

★ 107k FS 53 谨慎使用 13 天前
自动化与运维

生产可观测性工程

为生产代码建立日志、指标、追踪与告警,让系统行为可见且便于诊断。

★ 107k FS 53 谨慎使用 13 天前
自动化与运维

安全加固工程技能

帮助编码代理在处理不可信输入、身份验证、敏感数据和外部服务时建立系统化安全防线。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

Idea Refine 创意打磨

把模糊想法转化为经过验证、可执行的产品方向。

★ 107k FS 51 谨慎使用 13 天前
开发与工程

官方文档驱动开发

让框架与库的实现决策基于当前官方文档,而不是过时记忆。

★ 107k FS 51 谨慎使用 13 天前

相关 Skills