用途
本技能针对 JavaScript 或 TypeScript 项目,提供每周一次的 npm 依赖审计,并输出可直接用于决策的审计摘要。用户提出 npm 依赖审计、过期包检查等需求时适用。
主要能力
- 在目标项目中运行
npm outdated || true,收集过期依赖信息。 - 当项目存在有意义的锁文件时,同时运行
npm audit || true,收集安全公告。 - 将过期依赖按补丁(patch)、次版本(minor)、主版本(major)更新分组。
- 将安全公告按严重程度分组。
- 给出建议的安全升级顺序,从低风险的补丁和次版本更新开始。
- 标注主版本升级可能带来的破坏性变更、需要的代码改动以及测试覆盖缺口。
- 列出升级后项目应执行的具体验证命令。
- 识别当前包管理器证据,例如
package-lock.json、npm-shrinkwrap.json或 npm scripts。
使用方式
资料给出的循环启动提示为:
/loop 7d Start the "NPM Dependency Audit Weekly" loop.
Goal: deliver a weekly npm dependency audit summary.
Between iterations run: npm outdated || true
Exit when: summary is posted with recommended upgrades.
执行步骤:在目标项目中先运行:
npm outdated || true
当锁文件能使审计结果有意义时,再运行:
npm audit || true
若目录中没有 package.json,应停止并报告当前目录不是 npm 项目。报告保持直接简洁;除非用户明确要求执行升级工作,否则不应用升级。
适用场景
- 需要周期性掌握项目依赖陈旧程度的团队。
- 希望在安全公告与升级计划之间建立固定检查流程的项目。
- 需要在主版本升级前评估破坏性变更与测试覆盖情况的前置审查。
限制与约束
- 不修改检查命令或退出条件来强行让结果成功。
- 不跳过、禁用或绕过检查来让审计结果看起来干净。
- 若包元数据缺失、依赖解析失败,或审计输出被 registry/认证问题阻塞,应停止并报告阻塞原因。
- 资料未提供具体的价格、平台支持范围或与其他工具的集成信息。