SuperAPI AI 工具集

deprecation-process

设计与创作

查看项目

更新于 10-16 01:31

技能介绍

用途:为设计系统中的组件、令牌(token)、变体或模式制定端到端废弃计划,产出包含时间线、消费方沟通与迁移指引的文档。

主要能力:1)明确废弃对象、原因与替代项;2)执行用量审计,使用 ripgrep 命令统计导入文件数、JSX 实例数、受影响应用与关键路径,并生成按消费方拆分的表格(含实例数、是否关键路径、迁移工作量估算、联系人);3)编写废弃计划,含决策树(替代项是否覆盖 80% 以上用例)、迁移输入映射表、时间线(通知日、支持窗口、移除日,移除需随主版本发布)、代码与 Figma 层面的废弃机制(JSDoc @deprecated、DTCG $deprecated、console.warn、lint 规则、Figma 重命名与取消发布)、Mermaid 甘特图、沟通计划、例外情况、间接影响范围与回滚预案。

使用方式:安装后需先核对 frontmatter 的 references 路径是否齐全;若缺失(如安装器丢弃 knowledge-notes/ 目录),应停止并让用户按 1-INSTALL.md 重装并运行 verify-install.sh。审计时可运行资料中给出的 rg 命令(如 rg -l -U 统计文件数、rg -o 统计出现次数),无代码库访问权限时应请用户自行运行并提供输出。

适用场景:设计系统维护、组件或令牌的版本升级与移除规划,尤其适合有多团队消费的大型系统。

限制:用量计数仅为下限,不覆盖动态导入、字符串拼接类名与其他仓库中的使用;跨仓库消费方需通过 gh search code 查找后逐个统计。小系统(组件少于 5 个)建议考虑归档或隐藏而非完整废弃,且沟通应以直接对话为主。迁移指南由 change-communication 技能编写,本技能仅提供其所需输入,不重复起草公告。