这个 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？
- 执行前应统一 uphy1-config 与 uphy0-config、jetson-customize-uphy 与旧路径名称，并核对 pin_verifier.py 和上下文文档的实际位置。
- 提交 overlay 前应增加明确的用户确认，并记录可恢复的提交回滚方案；确认 sidecar 不会误导性地记录本技能未修改的 ODMDATA。
- 必须依据实际 BPMP/kernel DTB、原理图、pinmap、DUT compatible 和 PHY 数据手册复核所有硬件参数；本文档本身不足以证明正确性。
- Shell / 命令行
- 本地文件系统
dtcfdtoverlaycppgit
使用 NVIDIA/skills 的 skills CLI 安装指定技能：npx skills add nvidia/skills --skill jetson-customize-mgbe --yes。CLI 会处理安装目标；源材料未规定手动复制到某个具体目录。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/jetson-customize-mgbe" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成，只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式，请优先按作者说明操作；想只在当前项目中使用，把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 为我的 Jetson Thor 定制载板启用 MGBE0 的 25G QSFP
- 配置 MGBE PHY 模式并 bring up 10G 光纤路径
在已满足前置条件的 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-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 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Jetson Thor MGBE/QSFP 配置 本页 ✓ NVIDIA · 官方 | 49 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| Jetson PCIe 控制器定制 ✓ NVIDIA · 官方 | 57 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| Jetson USB 端口定制 ✓ NVIDIA · 官方 | 55 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| Jetson 自定义载板派生 ✓ NVIDIA · 官方 | 53 · 谨慎使用 | ★ 3.8k | 今天 | Apache-2.0 |
| Jetson BSP 源码构建 ✓ NVIDIA · 官方 | 58 · 推荐 | ★ 3.8k | 今天 | Apache-2.0 |
与 jetson-customize-uphy 不同，本技能负责 MGBE 控制器侧的内核设备树和 PHY 配置，而 UPHY 技能负责通道分配及相关 ODMDATA 提交；引脚不匹配时则转交 jetson-customize-pinmux。
FollowSkills 如何评估这个 Skill？
技能声明了文件读写与 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、提交产物或第三方可复现实证，关键技术断言无法仅凭所给文件独立复核，因此低分。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →