用途:在修改 better-result 的 API、类型或运行时语义时,审计已知下游依赖方是否受影响,适用于提交 PR 前的兼容性检查。
主要能力:脚本依据 npm registry 元数据解析最新版本与提交,对公开 GitHub 仓库检出已发布的 gitHead,私有或不可用仓库则回退到 npm pack 审计已发布源码。默认检查的依赖包括 @prisma/compute-sdk、@prisma/streams-server、@prisma/streams-local、create-better-t-stack、@better-t-stack/template-generator。
使用方式:在 better-result 仓库中运行 node .agents/skills/audit-better-result-dependents/scripts/audit-dependents.mjs 并传入变更涉及的标识符模式,例如 isTaggedError 'TaggedError.is' 'toJSON';未提供模式时脚本搜索常见用法。先本地验证:bun run fmt、bun run check、bun run test、bun run lint。随后用 read 检查实际匹配文件,区分通用守卫与类专属守卫,评估运行时破坏、类型破坏或安全三类结论,报告需含包名、版本、审计来源、匹配项与风险结论。
限制:@prisma/compute-sdk 可能指向私有或 404 仓库,克隆失败时审计 npm 包源码;审计期间不得修改克隆的依赖仓库,仅使用临时目录。其余细节暂未提供。