Community编程与开发github.com

NenadZivotic/lite-agent-skills

在安装 npm 包前快速检查其健康状况 — 最新版本、距离上次发布的日期、弃用标志、许可证以及过时/弃用启发判断。只需一次未经身份验证的注册表请求。当用户询问 npm 包是否维护或安全添加时使用。

lite-agent-skills 是什么?

此技能在安装 npm 包前提供快速健康检查,通过一次对 registry.npmjs.org 的 GET 请求获取公共注册表元数据。它返回最新版本、距离上次发布的时长(天数)、弃用标志、许可证以及一个基于发布时效的过时/弃用启发判断。比较新旧版本时,它不会安装包或执行任何代码,确保安全。该技能适用于 Node 18+ 环境,无外部依赖,通过标准输出返回 JSON 格式报告,并在失败时返回非零退出码。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NenadZivotic/lite-agent-skills/tree/HEAD/npm-package-health-lite

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

npm 包健康检查(精简版)

网络访问(已声明)

一次 GET 请求到 registry.npmjs.org/<package> — 公共注册表元数据。不访问其他主机,不发送任何数据,不安装软件包,不执行任何代码。

边界

  • “过时”是基于发布时效的启发判断 — 不活跃的包不一定被放弃。
  • 此精简版不包含每周下载统计(完整版有第二个 API 调用)。

1. 运行

需要 Node 18+,零依赖。

node <skill-dir>/scripts/health.mjs <package-name>

输出 JSON 到标准输出;如果获取失败则 exit 1,缺少参数则 exit 2。

2. 读取报告

  • latest、lastPublish、ageDays、deprecated、license、health。
  • 标志:存在 deprecated 字符串、ageDays > 730、license: null。

3. 报告

<package>@<latest>: <health>
last publish Y days ago · license <spdx|none> · deprecated <yes/no>
<单行建议:安全添加/固定版本/考虑替代>

精简版 vs 完整版

完整的 npm-package-health 还报告每周下载量(api.npmjs.org)、维护者数量和依赖项数量。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能