Jetson PCIe 控制器定制
为 Jetson Thor 或 Orin 定制 PCIe 控制器状态、通道数和链路速率。
技能明确限制只修改内核设备树 overlay，不编辑 ODMDATA；要求用户确认计划，遇到冲突停止并询问，禁止自主 git reset --hard，并要求引脚、原理图和状态 sidecar 交叉核验。这些措施降低了权限越界和不可逆风险。扣分在于提交 BSP/硬件配置会产生外部影响，未明确备份、回滚执行流程或敏感输入处理；仓库许可证元数据为 NOASSERTION。
流程、前置条件、失败分支、dtc/fdtoverlay 预检和故障排查较完整，静态 happy path 可信。扣分在于没有可见的提交测试套件或 CI 覆盖关键路径，且 frontmatter 版本 0.0.1 与 sidecar 示例 generator_version 0.1.0 不一致；仅作静态评审，按上限不超过 10 分。
触发条件、适用平台、RC/EP 边界、前置依赖和非适用的 UPHY lane allocation 场景描述清楚，适合 Jetson Thor/Orin 定制载板。扣分在于输入文档、工作区结构和多个 sibling skill 依赖较重，缺少中文交互或中国大陆网络可达性的明确说明，语义触发边界仍需依赖代理判断。
目录结构和渐进式文档较好，包含 procedure、gotchas、限制、输出格式、版本和维护来源，且提供明确的 NVIDIA 归属与许可证文本。扣分在于缺少推荐的 Instructions 和 Examples 章节，作者格式不符合验证器要求，frontmatter 许可证与仓库/skill-card 的双许可证表述不完全一致，缺少明确 changelog 和维护更新路径。
技能直接产出带 marker 的 kernel-DT overlay，并覆盖拓扑、引脚、lane、speed、兼容性和 ODMDATA 一致性检查；基准报告显示 Codex 正确性 85%、有效性 54%，表明有实际边际价值。扣分在于只有 2 个正向任务、没有负向任务，结果仍依赖真实 BSP、DTB、原理图和下游 skill，静态评审不能确认产物可直接用于刷机，因此不超过 7 分。
源文件提供逐步流程、命令、sidecar schema、审计注释要求和固定 revision 范围，基准文件也记录了有限的评测结果。扣分在于没有可独立复现的测试套件、CI 证据或第三方材料；基准报告的执行细节和原始产物不足，故只能给有限静态可审计分，不超过 5 分。
- 执行会修改并提交 BSP/设备树仓库，必须在真实提交前保留可恢复版本并由操作者确认目标、范围和回滚方式。
- 技能依赖 <uphy-state>、DTB、原理图、pinmap、Adaptation Guide 及多个 sibling skill；任一输入缺失或版本不匹配都可能导致错误 lane/status 配置。
- 评测仅含 2 个正向任务且无负向任务，不能证明误触发避免、异常输入处理或真实刷机成功。
- 需澄清版本号和许可证表述，并补充 Instructions、Examples、CI/测试与维护更新路径。
这个 Skill 能做什么，适合哪些场景？
该技能面向 Jetson Thor 和 Orin 自定义载板上的 PCIe 控制器配置。它结合 UPHY 状态、参考设备树、载板原理图和引脚图，生成每个控制器的内核设备树覆盖片段。技能会校验 ODMDATA 与内核覆盖层的一致性，但不会修改 ODMDATA。输出是提交到 bsp_sources 硬件仓库的内核设备树覆盖层变更。
读取活动目标配置、适配指南、模块设计指南、SoC TRM、参考 DTB、载板引脚图、原理图和 UPHY 状态 sidecar；反编译并比较 PCIe 拓扑；通过 AskUserQuestion 选择控制器并确认或调整计划；使用 pin_verifier.py 校验 CLKREQ、RST 和可选 WAKE 信号；为每个控制器生成并追加 fragment@N 到复合 .dts；运行 dtc 和 fdtoverlay 进行预检；检查 ODMDATA 与覆盖层；提交覆盖层变更并写入运行状态 JSON sidecar。
- Jetson Thor 自定义载板需要启用或禁用特定 PCIe 控制器时使用。
- Jetson Orin 的 PCIe 插槽或 M.2 接口刷写后未枚举时使用。
- PCIe 链路训练到错误的通道宽度或速率时使用。
- UPHY 重新分配通道并改变 PCIe 控制器启用状态后，补充内核设备树配置时使用。
这个 Skill 有哪些优点和局限？
- 覆盖 PCIe 控制器启用状态、通道数、链路速率和 RC/EP 模式配置。
- 同时检查内核设备树覆盖层与 ODMDATA，能报告矛盾配置。
- 针对自定义载板要求原理图和引脚图，包含拓扑与高速信号校验流程。
- 明确将生产编译和刷写注册交给 jetson-build-source。
- 依赖已完成的 jetson-init-source、jetson-derive-carrier 和 jetson-customize-uphy 流程。
- 自定义载板缺少原理图或 pinmux XLS 时会拒绝运行。
- 默认模式固定为 RC，EP 模式需要显式覆盖。
- 只输出内核设备树覆盖层，不负责修改 ODMDATA、编译生产 dtbo 或注册刷写配置。
- SKILL.md 未描述独立测试套件或已验证的平台组合。
如何安装这个 Skill？
使用 NVIDIA/skills 集合中的 skills CLI 安装：npx skills add nvidia/skills --skill jetson-customize-pcie --yes。也可先运行 npx skills add nvidia/skills --list 查看技能。源材料未规定其他安装方式。
如何使用这个 Skill？
准备活动 profile、Linux_for_Tegra Git 源码、载板派生结果、jetson-customize-uphy 生成的 UPHY 状态 JSON、相关硬件文档和 PATH 中的 dtc。然后向已加载该技能的 agent 提出“configure PCIe”或“enable PCIe controller”等请求。该技能要求先运行 jetson-customize-uphy，并仅生成内核设备树覆盖层；ODMDATA 由该上游技能管理。