Jetson 健康快照
以只读方式汇总 Jetson 的硬件、资源与服务状态。
技能明确限定为只读,禁止改电源模式、清缓存、停服务和安装软件,并要求权限不足时说明限制;脚本主要读取系统遥测,未见外传、凭据窃取或破坏性默认行为。扣5分:未充分说明进程、服务和内核遥测可能包含敏感运行信息,也未定义输出脱敏、用户确认、最小sudo授权或恢复机制;来源归属和Apache-2.0许可较清楚。
文档给出脚本入口、参数、平台检测、空值保留和错误处理,并包含跨平台GPU数据源逻辑说明。扣14分:提供的源材料未包含关键的snapshot.sh,无法静态核对默认主路径;没有提交覆盖关键路径的测试套件,且mem_summary.sh通过GPU名称判断nvidia-smi可用性,与文档所述能力探测存在不一致。按静态校准不超过10分。
目标用户、Jetson场景、触发语句、非适用的变更任务、容器/主机可见性要求和特定硬件限制均有说明,且失败时不替换为通用Linux数据。扣4分:未提供中文交互或本土网络适配说明,且依赖Jetson主机、debugfs、sudo和本地工具,非Jetson环境适用范围较窄。
文档包含用途、触发条件、前置条件、脚本表、报告规范、限制、错误处理、输出契约、安全和跨平台说明;版本、作者、标签及Apache-2.0元数据存在,BENCHMARK记录了静态发现。扣6分:缺少推荐的Examples章节,作者格式不完整,缺少明确维护责任人、变更日志和更新路径;脚本依赖说明仍有隐含的运行时假设。
技能覆盖身份、内存、GPU、温度、功耗、磁盘、进程和服务状态,并规定按问题选择JSON快照或紧凑内存摘要;BENCHMARK报告了基于8个任务的有效性和正确性结果。扣9分:评估数据集不可见,关键snapshot.sh未提供,且静态审查无法确认代表性输出在真实环境中始终可用。按静态校准不超过7分。
源代码、输出契约、平台检测逻辑、官方文档链接和BENCHMARK结果提供了可审计材料,且区分了观察数据与推断。扣1分:BENCHMARK缺少原始数据和复现步骤,关键脚本未在材料中出现,无法独立重现关键路径;按静态校准不超过5分。
- 提交或部署前应补齐并审查snapshot.sh及其测试,验证文档所述GPU能力探测与实际实现一致。
- 进程、服务和debugfs输出可能暴露运行环境信息;应明确脱敏策略、sudo最小权限范围以及是否需要用户确认。
- 当前材料未给出中文输出约定或大陆网络环境说明,跨环境使用前需验证AgentSkills路径解析和本地工具可达性。
这个 Skill 能做什么,适合哪些场景?
Jetson Diagnostic 面向正在运行的 NVIDIA Jetson 主机,生成统一的健康快照。它读取设备身份、内存、GPU、温度、电源、磁盘、进程和候选服务状态,并以 JSON 或简明文本形式输出。该技能只观察状态,不修改电源模式、服务或缓存。运行环境必须能访问 Jetson 主机的系统路径和进程数据。
运行 scripts/snapshot.sh,输出身份、内存、GPU、温度、电源、磁盘、最高资源占用进程和候选服务的 JSON 快照;可用 --human、--tegra-secs N 和 --top-procs N 调整输出。运行 scripts/mem_summary.sh 可获取 RAM/GPU/交换空间摘要,运行 scripts/detect_jetson.sh 可识别 Jetson SKU、代际和产品线。技能还根据运行时可用的数据源使用 nvidia-smi 或 NvMap 归因进程级 GPU 内存,并保留不可访问工具对应的 null、false 或空字段。
- Jetson 开发者想确认设备 SKU、变体、L4T 版本和总内存时,先获取身份快照。
- 设备运行缓慢、过热或内存不足时,运维人员同时查看温度、最高占用进程和 GPU/NvMap 负载。
- 用户想了解 GPU、CPU 或电源模式的当前状态时,使用统一 JSON 输出。
- 用户贴出 tegrastats 行并需要解释时,结合该技能提供的字段参考。
- 在运行 Jetson 内存审计、无头模式、推理内存调优、LLM 服务或基准测试前,先建立基线测量。
这个 Skill 有哪些优点和局限?
- 覆盖设备身份、内存、GPU、温度、电源、磁盘、进程和服务状态。
- 只读设计,明确禁止修改电源模式、停止服务、安装软件或调优推理参数。
- 针对 Thor、AGX Orin、Orin NX 和 Orin Nano 提供平台识别及 GPU 数据源回退逻辑。
- 脚本对工具缺失和权限不足有明确的 null、false 或空字段处理。
- 依赖 Jetson 主机可见性;普通沙箱可能无法访问所需的系统路径和进程数据。
- NvMap debugfs 通常需要 root 权限,非特权运行可能无法提供进程级 GPU 内存。
- 该技能只报告观察结果,不会直接修复性能、温度或内存问题。
- 提供的材料没有说明该技能的测试套件或测试覆盖范围。
如何安装这个 Skill?
使用仓库 README 提供的 CLI 安装指定技能:
npx skills add nvidia/skills --skill jetson-diagnostic --yes
README 未说明该单技能在各客户端中的具体安装目录;CLI 会提示或按参数选择安装位置。
如何使用这个 Skill?
在已加载该技能的代理中提出具体请求,例如:"What is this Jetson, and show its current GPU, thermal, memory, and power state?"。优先运行 scripts/snapshot.sh;需要简短内存信息时运行 scripts/mem_summary.sh。如果运行时支持 run_script,则调用相应脚本;否则从仓库根目录使用 bash 运行。若脚本无法访问 Jetson 主机,应在 Jetson 主机或具备主机可见性的沙箱中重试。
这个 Skill 与同类方案有什么区别?
它将 tegrastats、jtop、procrank、NvMap debugfs、nvpmodel、free、swapon、df 和 systemctl list-units 等工具产生的不同信息汇总到统一视图中;这些工具仍是底层数据来源或参考。