用途:在修改 src/lib/、src/services/、src/utils/、src/hooks/、共用元件等高扇入文件,或改名、删除、搬移文件与 exported symbol、修改导出函数签名前,先列出依赖方,避免「改 A 坏 B」的回归。
主要能力:脚本会向上找到最近的 package.json 作为项目根;若已安装 madge,优先用 madge --reverse 列出依赖方,否则回退到 grep,搜索 src/、app/、lib/、test/ 等目录下的 import / require 语句,输出依赖方文件路径与实际引用的 symbol。目前仅支持 TypeScript/JavaScript(.ts .tsx .js .jsx .mts .cts),非 TS/JS 文件直接略过,不中断流程。
使用方式:调用 ${CLAUDE_PLUGIN_ROOT}/skills/deps-check/scripts/deps-check.sh <file-path>。根据依赖方数量决定策略:0 个可直接改;1-3 个需 Read 每个依赖方确认;4 个以上先回报影响范围,确认是否拆成多步骤或加 deprecation shim。动手前用一两句话告知用户影响范围,确认后再编辑;过程中若发现动态 import、re-export 等新依赖关系,再补跑一次。改完运行 npx tsc --noEmit 或 npx tsc --noEmit --incremental 做类型检查验证。
适用场景:重构、改名、删除、修改 public API、修改导出函数等。纯新增文件、只改 private/local symbol、样式或文案调整、测试文件自身无需触发。
限制:目前仅支持 TS/JS,其他语言需自行在脚本中增加分支;无法捕捉事件、全局状态等隐性耦合,这类情况需靠 bug-fix-learning 记录。可选将脚本挂到 PreToolUse hook 上,在 Edit 或 Write 前自动执行。