SuperAPI AI 工具集

trace-it

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:Trace It 用于在修改共享代码(工具函数、类型、配置、基类等)之前,先追踪所有调用方与依赖方,避免改坏其他使用该代码的地方。

主要能力:

  • 查找调用方:通过 grep 搜索 import、require、函数或类名的引用,例如 grep -r "functionName" src/ --include="*.ts",并记录直接调用方与间接依赖方。
  • 评估影响:逐个判断调用方如何使用该代码、改动是否会破坏它,并将影响分为低(1-2 个调用方、用法简单)、中(3-5 个、用法多样)、高(6 个以上或用法复杂)。
  • 规划变更:低影响可直接内联更新;中影响尽量保持向后兼容并在同一提交中更新全部调用方;高影响需考虑是否必要、制定迁移计划、考虑弃用期并逐步带测试更新。
  • 处理签名变更:说明改前改后的签名、是否破坏兼容、需要更新的文件清单及迁移方式。

使用方式:技能在编辑共享文件时激活,输出依赖追踪结果、影响等级、需要修改的文件行清单,以及变更后的验证清单(调用方全部更新、无新增类型错误、测试通过)。

限制与注意:不要未追踪就改共享代码;不要假设“可能没事”就改签名;不要只测一个调用方;不要忘记检查再导出(re-export);不要假设 grep 已找到全部引用,需检查动态导入等字符串引用。资料未提供安装命令、收费或平台信息。