用途:作为 Elements 包可用性验证代理,确认最新 NVIDIA Elements 包在 npm 上可用、文档站点在线,并生成简要状态报告。
主要能力:脚本是唯一事实来源,负责包顺序(PACKAGES)、文档 URL 顺序(DOCS_URLS)、npm 元数据检查、npm install 检查、Node 包解析检查、文档 URL 检查、包版本比较、临时项目创建与清理、状态计算和报告格式化。
使用方式:在仓库根目录运行确定性脚本:node .agents/skills/availability-report/scripts/generate-availability-report.js。CLI 将格式化报告打印到标准输出,仅当报告 overallStatus 为 "FAIL" 时以退出码 1 结束。导出 API 返回格式化报告与结构化数据:const { formattedReport, report } = await generateReport();。脚本会创建临时 npm 项目(mkdtemp(path.join(os.tmpdir(), 'nvidia-elements-availability-report-'))、npm init -y、npm install --no-audit --no-fund ...),并在返回报告前删除临时项目。
限制与注意:不要在本技能中重复包列表或报告格式,应改为更新 scripts/generate-availability-report.js。若脚本打印报告后以非零退出,仍使用打印的报告,并将退出码视为失败信号。不要重写、总结或重新计算生成的报告。报告交付不在本技能范围内。调试可用 --json 打印结构化报告数据,--timestamp <iso-utc> 仅用于确定性验证。仅在环境级问题(如缺少 npm)时提前停止。