SuperAPI AI 工具集

impact-check

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:在修改任何符号(函数、类、变量、配置键)之前,先映射所有依赖方,避免改动共享代码时漏掉调用者。适用于编辑共享工具、基类或广泛引用的模块,以及在重命名或删除前、作为安全变更或 propose 的第一步。非目标:不修改代码(仅输出),也不为尚未文档化的符号新建 wiki 条目(只记录缺口)。

主要能力:按符号名并结合文件模式在任意规模代码库中搜索全部 import、调用与引用;逐条记录文件路径、行号及使用方式;将引用分为 Direct(直接调用或导入符号本身)与 Indirect(依赖该符号产生的行为,例如读取其输出);单独列出测试文件中的引用并提示需同步更新;若符号在 wiki/ 中尚无文档则记为缺口;最终生成输出报告草稿并更新 wiki 索引与日志。

使用方式:先准确确定待修改的符号,再在代码库中搜索其所有 import、调用与引用,逐条记录路径、行号与使用方式并分类,报告完整清单。若文件外零引用须明确说明。测试引用单独标注。wiki 缺口仅记录,不创建条目,条目须待代码提交后再写(参见 verify-before-commit)。

规则与限制:技能执行期间不得修改任何内容,仅输出;代码库较大时须同时按符号名与文件模式搜索;不得因缺少直接调用者就假设符号未被使用,须检查间接依赖。失败边界:同名符号有多个定义时须先澄清具体符号;文件外无引用属于成功,但须明说;代码库过大或搜索出错时标记为部分完成,并记录已扫描范围。

输出:在 llmwiki/wiki/sources/draft/ 下写入 DDMMYY-<ten>.md 草稿(含 type、status、tags、timestamp 等字段及 What、Output、Files 等段落),并更新 index.md 与 log.md;仅当零产出且零决策时才跳过。示例:修改 src/utils/date.ts 中 formatDate(d) 签名,可得到 12 个 Direct、2 个 Indirect 及 3 个测试引用,并生成对应草稿。配置键 retry_limit 虽无直接调用者但经 config[key] 动态读取,应归为 Indirect,不得报告为未使用。