Jetson Thor MGBE/QSFP 配置
为 Jetson Thor 通过内核设备树覆盖启用 25G、10G 或 1G MGBE 网络路径。
技能声明了文件读写与 shell 白名单、公开数据分类、禁止修改 ODMDATA 和上游 BSP，并要求针脚修复确认，降低了越权和误操作风险；但会直接写入并提交 bsp_sources，未明确提交前的用户确认、完整回滚和提交失败后的恢复流程，因此扣分。
主流程、前置条件、预检命令、失败条件和若干异常诊断较具体；但引用的上下文文件和脚本未在所给材料中提供，且 questions.json 中出现 uphy0-config、/modify-uphy 等与主文档不一致的旧命名，无法静态确认关键路径可运行，因此受静态上限限制并扣分。
目标用户、Thor 平台、QSFP/MGBE 场景及 UPHY、ODMDATA、pinmux 的边界描述清楚，且包含不适用条件；但仅支持 Thor，缺少中文交互说明和非 Thor 环境的更完整触发边界。核心流程依赖本地 BSP、硬件原理图和 DUT，未显示必须访问海外服务。
SKILL.md 有概览、触发条件、步骤、陷阱和引用，版本与责任团队基本可识别；但缺少 Instructions、Examples 和 FAQ，基准报告也指出这些缺失，许可证元数据为 NOASSERTION 而 skill-card 声明 CC-BY-4.0 与 Apache 2.0，且无明确 changelog 或维护更新路径，因此扣分。
文档给出了问题收集、DT overlay 片段、预检、提交和下游交接，理论上能完成核心配置；但评测结果中 effectiveness 仅约 43%–44%，且存在命名、路径和 sidecar 中 ODMDATA 字段等不一致，静态材料不能证明输出可直接使用，因此按静态上限保守给分。
包含固定修订中的流程、问题 schema、评测报告和具体命令，具备一定审计线索；但评测是内部单次小样本结果，缺少所涉脚本、CI、提交产物或第三方可复现实证，关键技术断言无法仅凭所给文件独立复核，因此低分。
- 执行前应统一 uphy1-config 与 uphy0-config、jetson-customize-uphy 与旧路径名称，并核对 pin_verifier.py 和上下文文档的实际位置。
- 提交 overlay 前应增加明确的用户确认，并记录可恢复的提交回滚方案；确认 sidecar 不会误导性地记录本技能未修改的 ODMDATA。
- 必须依据实际 BPMP/kernel DTB、原理图、pinmap、DUT compatible 和 PHY 数据手册复核所有硬件参数；本文档本身不足以证明正确性。
这个 Skill 能做什么，适合哪些场景？
此技能面向 Jetson Thor T264 定制载板上的 MGBE 控制器配置，可为 QSFP、10G 或 1G 光纤路径生成内核设备树覆盖。它根据 BPMP 分配、PHY 连接方式、引脚复用和载板文档配置控制器状态及 PHY 连接。技能会把修改写入 bsp_sources 硬件仓库中的复合自定义覆盖，并交由 jetson-build-source 编译和注册。它不负责 UPHY 通道分配，也不会修改 ODMDATA。
验证活动目标、载板配置、覆盖跟踪器和必需文档；通过问题流程收集控制器、PHY 模式、连接类型、I²C、复位 GPIO 和兼容字符串；反编译 BPMP DTB 以确定速度令牌格式；运行 pin_verifier.py 检查 MDC、MDIO、RESET 和 INT 引脚；在复合覆盖 DTS 中写入每个控制器的片段；使用 cpp、dtc 和 fdtoverlay 执行预检；写入运行状态 JSON sidecar 和摘要。它读取工作区、源代码、BSP 镜像 Linux_for_Tegra 及文档路径，并写入目标平台和 bsp_sources 硬件目录。
- Jetson Thor 定制载板将 QSFP 笼连接到 MGBE 控制器，需要启用 25G 链路时。
- 冷启动成功但配置的 mgbe<N> 显示 DOWN 或 NO-CARRIER 时。
- MGBE 控制器在系统中完全不出现，需要检查内核设备树和 PHY 连接时。
- 已由 jetson-customize-uphy 选择分配 MGBE 通道的 UPHY 配置后，需要完成控制器侧配置时。
这个 Skill 有哪些优点和局限？
- 明确生成内核设备树覆盖，并将复合覆盖编译职责交给 jetson-build-source。
- 覆盖 25G、10G 和 1G MGBE/QSFP 或光纤路径，并包含 PHY 连接检查。
- 明确禁止修改 ODMDATA、UPHY 分配和上游 BSP，边界清晰。
- 包含针对 BPMP DTB 令牌格式、MDIO 节点属性、覆盖兼容性和引脚复用的故障提示。
- 只针对 Jetson Thor T264 的 MGBE 场景，不负责 UPHY lane allocation、ODMDATA 或 flash-conf 注册。
- 定制载板缺少原理图或 pinmux XLS 时必须拒绝运行。
- 需要 dtc、fdtoverlay、cpp 和 git 等命令及多个已准备好的 BSP 工作流状态。
- 源材料没有提供测试套件、支持平台矩阵或实际硬件验证结果。
如何安装这个 Skill？
使用 NVIDIA/skills 的 skills CLI 安装指定技能：npx skills add nvidia/skills --skill jetson-customize-mgbe --yes。CLI 会处理安装目标；源材料未规定手动复制到某个具体目录。
如何使用这个 Skill？
在已满足前置条件的 Jetson Thor BSP 工作区中，向代理提出例如“为我的 Jetson Thor 定制载板启用 MGBE0 的 25G QSFP”或“配置 MGBE PHY 模式并 bring up 10G 光纤路径”。运行前需要活动 profile、Linux_for_Tegra/.git、载板 flash-conf 分支、UPHY 分配结果、适配指南/模块设计指南/SoC TRM；存在 custom_carrier 时还必须提供载板原理图和 pinmux XLS。技能会通过问题流程收集每个控制器的配置。
这个 Skill 与同类方案有什么区别？
与 jetson-customize-uphy 不同，本技能负责 MGBE 控制器侧的内核设备树和 PHY 配置，而 UPHY 技能负责通道分配及相关 ODMDATA 提交；引脚不匹配时则转交 jetson-customize-pinmux。