1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | jetson-diagnostic | GitHub API |
| 作者/维护者 | NVIDIA（Jetson Team），仓库归属 NVIDIA Corporation | GitHub API / SKILL.md |
| 来源链接 | https://github.com/nvidia/skills/tree/main/skills/jetson-diagnostic | — |
| 许可证 | Apache-2.0（仓库根目录 LICENSE-APACHE，SKILL.md 同步声明） |
GitHub 仓库文件 |
| GitHub Stars | 5,019（合集仓库整体，非本技能个体热度，见第 6 章说明） | GitHub API |
| Forks | 459 | GitHub API |
| 最新版本 | 0.0.1（SKILL.md version 字段） |
SKILL.md |
| 安装方式 | npx skills add nvidia/skills --skill jetson-diagnostic --agent <agent>，或手动复制目录 |
仓库 README / 安装文档 |
2. 功能介绍与亮点
jetson-diagnostic 是 NVIDIA 官方为 Jetson / IGX 边缘设备提供的只读健康快照工具，把 tegrastats、jtop、procrank、nvpmodel 等分散命令统一成一次调用。
- 一键快照：
scripts/snapshot.sh输出结构化 JSON，覆盖型号、内存、GPU 显存、温度、功耗、磁盘、进程、服务状态。 - 硬件栈自适应：自动区分 Thor 系列的
nvidia.ko栈与 Orin 系列的nvgpu栈，避免后者nvidia-smi返回桩值造成的误判。 - 零副作用：明确只读，不改
nvpmodel、不触发jetson_clocks、不动服务。 - 防臆造设计：数据缺失时要求如实说明而非编造数值，对沙箱主机路径不可见的情况给出降级提示。
- 属于 NVIDIA 官方 “Verified Agent Skills” 体系，发布前经软件与 agent 专属风险扫描签名。
3. 适用场景
所属分类：DevOps 与基础设施（设备健康监控/运维诊断，见第 7 章判定说明）。
面向在 Jetson AGX Orin / Orin NX / Orin Nano / Thor 等边缘设备上做机器人、机器视觉或本地大模型部署的开发者：在调优推理服务或排查“设备变慢/发烫/内存吃紧”之前，先拿到一份可信的实时基线，而非翻查多个命令手工拼状态。
4. 跨Agent兼容性
- Claude Code：原生支持。安装 CLI 提供
--agent claude-code，写入.claude/skills/。 - Codex：原生支持。CLI 提供
--agent codex，Codex 直接读取.agents/skills/。 - OpenClaw：SKILL.md 正文明确提到 “NemoClaw/OpenClaw sandbox” 场景并给出专门降级提示，作者有针对性适配，但可用性取决于沙箱是否开放主机可见性。
- Hermes Agent：未在仓库文档或 SKILL.md 中找到相关信息，未验证。
5. 推荐理由
它把 Jetson 设备诊断从“记住七八个命令、手工比对输出”变成一次结构化调用，由 NVIDIA 官方维护并经内部安全扫描流水线签发，只读、零副作用的安全边界写得清楚，是同类边缘设备运维工具里少见的、专为 agent 使用场景设计的产品。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | NVIDIA 是 agent skills 领域公认的一线硬件厂商；仓库整体 5,019 星为合集热度，不代表本技能个体数据；未检索到该子技能自身独立的第三方讨论或采用数据 |
| 可用性 | 9 | 单条 CLI 命令即可安装到目标 Agent；SKILL.md 文档详尽（用途、前置条件、输出契约、错误处理、局限性齐全）；对应目录最近一次同步于 2026-06-22；开源免费，无付费依赖 |
| 安全性 | 9 | 明确只读、无外联、无需凭据；License 清晰；作者为 NVIDIA 官方 Jetson Team；经官方安全扫描流水线签发；无可疑指令或混淆代码迹象 |
| 综合 | 8.3 | 三项均值 |
安全检查清单：①无破坏性 shell 操作，仅只读诊断脚本；②不联网外发数据；③无需 API key/凭据；④无可疑指令迹象；⑤作者为 NVIDIA 官方团队；⑥License 明确；⑦近期有维护记录。
7. 跟同类Skills相比的优势
| 工具 | 定位 | 与本技能的差异 |
|---|---|---|
jetson-stats（jtop，社区工具） |
Jetson 社区最广泛使用的交互式终端监控面板 | 面向人眼阅读的实时仪表盘，需人工解读；本技能输出结构化 JSON，专为 agent 直接消费设计 |
tegrastats（NVIDIA 官方 CLI，随系统自带） |
单行滚动式底层遥测输出 | 数据密集但未加工，不同硬件栈字段含义还不同；本技能做了硬件栈自适应与字段归一化 |
| 通用 Linux 服务器监控类技能 | 面向云主机/容器的资源监控 | 缺乏 Jetson 专属知识（SKU 识别、显存归属判断、功耗模式校验等），读不出边缘设备真实状态 |
8. 用户评价
尚未检索到针对 jetson-diagnostic 本身的具名用户评价。其所属的 NVIDIA “Verified Agent Skills” 体系已获独立第三方关注：AI 工程师 Zen van Riel（曾任职 Microsoft 与 GitHub）在技术博客中评价该体系“代表了 agent 能力治理方式的根本转变”，认为签名机制“确认下载的 skill 与 NVIDIA 审查签署的版本完全匹配”，同时指出该框架“目前主要聚焦 NVIDIA 生态工具”。
9. 其他补充
该技能同属 NVIDIA 官方 “skills” 仓库，内容由各产品团队每日自动同步，覆盖 Jetson、Holoscan、NeMo、TAO 等多条产品线，并支持统一 CLI 安装到 Claude Code、Codex、Cursor 等多种 Agent。
10. 安装使用方式
推荐方式（需 Node.js/npm）：
npx skills add nvidia/skills --skill jetson-diagnostic --agent claude-code将 --agent claude-code 替换为 --agent codex 等即可装到其他受支持 Agent；可重复传入 --agent 一次装多个。装完在 Claude Code 里运行 /reload-skills 生效。
手动方式（无 Node.js 环境时）： 复制仓库 skills/jetson-diagnostic/ 整个目录（含 SKILL.md 与 scripts/），放入对应 Agent 的技能目录，如 Claude Code 的 ~/.claude/skills/。
安装后无需重启系统，直接在 Jetson 设备主机上向 Agent 提问“这台 Jetson 现在什么状态”即可触发。
11. 注意事项
- 须运行在真实 Jetson/IGX 主机、或能看到主机系统路径的沙箱中，否则脚本会报告“无法访问”而非虚构数据。
- 读取显存明细通常需要 root 权限，非特权运行时相关字段可能为空。
- 当前版本号 0.0.1，属早期版本，字段结构未来可能调整。
- 仅提供只读诊断、不负责修复；需配合同仓库其他技能（如内存回收）动手处理。