系统弃用与迁移指南
帮助工程团队安全淘汰旧系统、迁移用户并验证移除结果。
技能明确要求渐进迁移、零消费者验证、指标/日志检查、分阶段数据库变更和可测试 down path,降低破坏性风险;但未规定用户确认、最小权限、数据流披露、敏感数据处理、依赖安全或一般迁移的回滚机制,因此扣分。
流程结构一致,包含决策问题、迁移步骤、模式、红旗和验证清单;但没有可执行脚本、异常输入处理、失败反馈或针对该技能关键路径的专门测试,静态评估下不超过10分,故扣分。
触发场景和主要适用任务清楚,覆盖系统、API、功能及数据库迁移;但未明确非适用边界、输入输出契约、语义触发排除条件,也未提供中文支持或中国大陆网络环境说明,故扣分。
文档分层清晰,包含 frontmatter、流程、示例、模式、红旗和验证清单;仓库提供 MIT 许可、团队信息和安装说明,但该技能没有版本、变更记录、明确维护责任或更新路径,故扣分。
内容能直接指导弃用决策、增量迁移和 expand/contract 数据库变更,具有较强实用性;但没有可直接运行的迁移工具或经过验证的代表性输出,非数据库场景的回滚、确认和支持流程也不完整,静态上限为7分,故扣分。
技能提供检查清单和具体步骤,仓库 CI 会验证整体技能结构并运行评估;但未见该技能专属测试、第三方证据或可独立复现的结果,且 CI 覆盖范围与本技能关键行为的对应关系不明,故仅给有限分数。
- 这是静态审查,未执行任何迁移、脚本或 CI;不要将文档中的“production-proven”或验证清单视为已证实事实。
- 应用该技能时应先获得用户对弃用、数据变更和删除范围的明确确认,并补充备份、回滚、权限和敏感数据处理方案。
- 仓库发布者未通过 FollowSkills 企业注册表验证,身份应视为未知;使用前应独立核实来源和维护状态。
这个 Skill 能做什么,适合哪些场景?
这是一个面向软件工程团队的弃用与迁移工作流技能,适用于旧系统、API、库或功能的替换与下线。它要求先评估系统价值、用户规模、替代方案和维护成本,再选择渐进式迁移策略。内容涵盖绞杀者模式、适配器、功能开关,以及数据库的扩展—迁移—收缩流程。完成弃用后,技能要求通过指标、日志和依赖分析确认没有活跃使用者,并清理旧代码及相关文档。
引导代理判断是否应维护或弃用现有系统,区分建议式与强制式弃用,规划替代方案、公告、迁移指南和分批迁移步骤。它提供绞杀者模式、适配器模式、功能开关迁移和数据库扩展—迁移—收缩的操作模板。它还要求检查活跃消费者、测试回滚路径、批量执行数据回填,并在移除后验证旧代码、测试、文档和配置是否已清理。
- 负责旧 API 替换的工程师,需要评估消费者数量、迁移成本和替代方案是否就绪。
- 准备下线不再需要的产品功能的团队,需要制定公告、迁移工具和移除时间表。
- 维护重复实现或无人负责的遗留代码的团队,需要决定继续指定负责人还是制定迁移计划。
- 进行数据库字段或模式变更的开发团队,需要避免在同一次发布中直接重命名或删除字段。
- 需要低风险切换服务实现的团队,希望通过适配器、功能开关或分阶段流量迁移完成切换。
这个 Skill 有哪些优点和局限?
- 提供从决策、公告、分批迁移到最终移除的完整流程。
- 明确强调替代方案、迁移工具、使用量验证和回滚路径。
- 包含数据库模式变更的可逆分阶段方法,并要求破坏性操作单独发布。
- 通过常见借口、红旗和验证清单约束迁移质量。
- 内容是通用工程工作流,没有针对特定语言、数据库或部署平台的实现脚本。
- 源材料没有提供测试结果、性能数据或实际采用案例。
- 迁移成本、消费者规模和维护成本仍需要使用者自行收集和量化。
- 数据库示例以 TypeScript 和通用数据库流程说明,不能直接视为所有技术栈的可执行方案。
如何安装这个 Skill?
该技能属于包含 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。
如何使用这个 Skill?
在已加载该技能的编码代理中提出具体任务,例如:评估是否应弃用 OldService,并制定包含替代方案、消费者迁移、回滚路径和最终移除验证的计划。 也可以请求:为 name 到 full_name 的数据库字段迁移设计扩展—迁移—收缩步骤。 SKILL.md 未规定专用命令、脚本或固定输出格式。
这个 Skill 与同类方案有什么区别?
仓库 README 提到可与 Superpowers 和 Matt Pocock's skills 对比,并链接到比较文档;提供的源材料没有给出针对本技能的具体差异,因此无法进一步判断。