NenadZivotic/lite-agent-skills

快速檢查 npm 套件在安裝前的健康狀況 — 最新版本、距離上次發布天數、棄用標記、授權條款，以及套件是否過時或棄用的啟發式判斷。僅需一次無需驗證的註冊表請求。當使用者詢問某個 npm 套件是否仍受維護或可安全加入專案時使用。

lite-agent-skills 是什麼？

這是一個輕量級的 npm 套件健康檢查工具，專為開發者與 AI 代理人設計，在安裝任何 npm 套件前快速評估其維護狀態。只需一次未經認證的 GET 請求至 registry.npmjs.org/<package>，即可取得最新版本號、距離上次發布的天數、是否被棄用（deprecated）、授權條款（SPDX 或無），並依據發布時效性提供「安全可加入」、「固定版本」或「建議尋找替代套件」的建議。支援 Node 18 以上環境，無需任何外部相依套件，輸出結構化 JSON 與人類可讀的報告。值得注意的設計界限：此工具僅根據發布日期判斷套件是否「過時」（stale），不包含每週下載量統計（完整版才有）。它不會實際安裝或執行套件程式碼，確保安全。此技能適合與 Claude Code、Cursor、Codex 等 AI 代理平台整合，讓代理人在加入新相依套件前自動執行此檢查，降低引進未維護或惡意套件的風險。

相容平台~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/NenadZivotic/lite-agent-skills/tree/HEAD/npm-package-health-lite

說明文件

npm 套件健康檢查 (精簡版)

網路存取 (已聲明)

一次對 registry.npmjs.org/<package> 的 GET 請求 — 公有註冊表中繼資料。不存取其他主機、不傳送任何資料、不安裝套件、不執行程式碼。

界線

「過時」是根據發布時效性的啟發式判斷 — 安靜的套件不一定被遺棄。
此精簡版不包含每週下載統計資料（完整版需要第二次 API 呼叫）。

1. 執行

需要 Node 18 以上版本，零相依套件。

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

標準輸出為 JSON；若擷取失敗則退出碼為 1，若缺少引數則為 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)、維護者數量以及相依套件數量。