Jetson 风扇曲线定制
在 Jetson BSP 中安全维护 nvfancontrol 风扇配置与启动默认值。
技能明确区分只读 bsp_image 与可写 source overlay，要求预览门、提交、传播集同步，并披露 sudo、刷写和 scp/systemctl 等外部影响；但未明确逐步用户确认、备份/回滚方案或权限最小化，故扣分。
操作、前置条件、格式约束和故障排查较完整；但依赖未提供的上下文文档和外部 Jetson 工作流，未见覆盖关键路径的测试或可执行验证，异常处理仍可能将硬件/平台诊断负担转给用户，故静态保守评分。
目标用户、Orin/Thor 平台、BSP-side 范围和触发词清楚，且不依赖海外在线服务；但输入契约、非适用场景边界、硬件差异处理和中文使用支持仍有限，故扣分。
有 frontmatter、版本、许可证、示例、限制、故障排查、benchmark 和 NVIDIA 归属信息；但版本仅 0.0.1，缺少明确 changelog、维护更新路径，作者格式存在 benchmark 报告指出的 schema 问题，且 SKILL.md 与 skill-card 的许可证表述不完全一致，故扣分。
能够覆盖新增、删除、编辑、默认值和只读列举，并给出 overlay、传播和部署流程；但曲线必须依赖真实热声数据，实际硬件文件和 tach 上限未提供，benchmark 中 effectiveness 仅 39%/49% 且未能静态独立复现，输出仍需人工审查，故扣分。
SKILL.md、评估任务和 benchmark 提供了可审计的规则及有限评估记录；但没有实际配置样本、CI 或关键路径测试，benchmark 也不是可独立核验的第三方执行证据，故未超过静态上限并扣分。
- 写入、提交、刷写或在线重启前应明确获得用户确认，并准备可恢复的配置备份与回滚步骤。
- 必须在目标 BSP 中核对实际 FAN_PROFILE、THERMAL_GROUP、RPM 上限和热声数据；示例曲线不能直接视为安全配置。
- 补齐并核验引用的 context 文档、版本变更记录、作者元数据和许可证表述。
这个 Skill 能做什么，适合哪些场景？
该技能用于在 Jetson/Tegra Orin 和 Thor 平台上管理 nvfancontrol 风扇配置。它支持新增、删除和编辑风扇曲线，以及修改启动时的控制模式、配置文件和调速器。修改仅写入 source overlay，BSP 镜像副本保持只读，并要求按工作流提交变更。写入后还需通过镜像提升和刷写链部署，或使用文档中的运行中设备复制与服务重启流程。
解析活动目标和 BSP/source 路径，定位对应的 nvfancontrol_<active-sku>.conf；读取 BSP 中的原始配置，并在 source overlay 中导入、编辑和提交 per-board 配置。它可列出风扇配置，新增或删除 FAN_PROFILE，调整 TEMP/HYST/PWM/RPM 曲线，修改 FAN_DEFAULT_CONTROL、FAN_DEFAULT_PROFILE 和 FAN_DEFAULT_GOVERNOR，并将同一修改同步到相关参考平台和派生载板配置。写入操作完成后，指导执行 /jetson-promote-image 与 /jetson-flash-image，或复制配置并重启 nvfancontrol.service。
- Jetson Orin 开发者需要新增 quiet 或 aggressive 风扇配置，并将其设为启动默认值。
- BSP 工程师需要调整已有风扇曲线的 PWM、RPM 或温度迟滞，以减少噪声或风扇频繁切换。
- 载板维护人员需要在活动 SKU、参考平台和同模块 SKU 的派生载板之间同步风扇控制修改，同时保留载板专属热区和转速参数。
- 系统集成人员需要列出当前 per-board 配置中的风扇配置和启动默认控制项。
- Jetson BSP 维护人员需要确保修改进入 overlay 提交记录，并在重新提取镜像后仍能保留。
这个 Skill 有哪些优点和局限？
- 覆盖新增、删除、编辑、列出配置和修改启动默认值等完整操作。
- 明确区分只读 BSP 镜像与可写 source overlay，保留 Git 变更轨迹。
- 针对派生载板只移植修改行，避免覆盖载板专属热区和 RPM 参数。
- 包含配置格式、校验规则、故障排查和部署流程。
- 仅处理 BSP 侧配置，不直接修改运行中设备的配置。
- 新增或修改曲线必须基于平台真实热声数据，技能不会替用户生成或跨芯片复制曲线。
- 需要活动目标、BSP 镜像、source Git 仓库以及对应 Jetson Linux 文件结构。
- 提供的材料没有展示测试套件、实测平台覆盖范围或性能基准。
如何安装这个 Skill？
使用 NVIDIA/skills 仓库提供的 skills CLI 安装：npx skills add nvidia/skills --skill jetson-customize-fan --yes。README 未规定该技能的手动复制目录或其他安装方式。
如何使用这个 Skill？
在已加载该技能的 Agent 中输入类似：add a profile called aggressive with the curve {0:255, 40:150, 80:0}，或 list defined fan profiles。执行写入操作前，需要存在活动目标、bsp_image 和 source Git 仓库，并确保相应 Linux_for_Tegra 路径存在；修改后运行 /jetson-promote-image 和 /jetson-flash-image，或者按说明将配置复制到设备并重启 nvfancontrol.service。
这个 Skill 与同类方案有什么区别？
与刷写完整 BSP 镜像相比，文档还提供一种不刷写的替代流程：直接复制 overlay 配置到运行中设备，再重启 nvfancontrol.service；这种方式仍属于运行时部署，并不会替代 overlay 提交和镜像工作流。