Jetson BSP 源码构建
根据 Jetson BSP 源码变更重建设备树、内核和模块,并生成可部署清单。
技能明确限定输出留在 source.root_path,并通过 manifest 交给 promote 阶段,校验 profile、工具链和前置条件,也描述了原子写入与回滚相关的 Git 路径;但会自动复制文件、修改 Makefile/flash conf 并提交 Git,用户确认门槛主要以注释和流程约定呈现,缺少统一、明确的执行前确认及完整恢复步骤,因此扣分。
文档覆盖多种构建模式、依赖检查、脏仓库检测、失败路由和常见错误,异常反馈较具体;但本评估未执行脚本,实际 make 链、引用文件和边界条件无法复现验证,且部分关键逻辑依赖外部技能与未提供的工作区状态,因此静态上限内扣分。
触发词、目标用户、输入模式、自动选择规则和非适用场景较清楚,并支持 Jetson BSP 工作流;但没有明确中文交互要求、非 Jetson/非匹配 BSP 的完整边界,也未证明所有依赖在中国大陆网络环境可达,因此扣分。
信息架构、渐进式引用、参数、示例、限制、故障排查、版本和维护线索较完整,且 SKILL.md 标注 Apache-2.0;但作者仅为团队名、缺少明确维护负责人和 changelog,仓库 license metadata 为 NOASSERTION,skill-card 与前置许可证描述也存在治理信息不完全一致,因此扣分。
核心目标明确:按脏仓库选择构建模式、生成可供 promote 使用的 manifest,并报告下一步;示例和评测文件支持 happy path 的可用性,但没有本次静态审查可独立验证的真实构建产物或完整结果覆盖,输出仍需用户审阅和后续 promote/flash,因此按静态上限评分。
源文件包含详细命令、映射表、状态/manifest schema、限制说明和一份评测报告,提供了有限的审计线索;但评测报告的执行结果无法由当前材料独立复核,缺少真实 CI、提交的测试套件或多来源交叉证据,因此不超过静态上限。
- 执行会修改工作区文件并可能创建多个 Git 提交;应在运行前确认目标 profile、路径、分支和提交批次,并保留可恢复的工作树状态。
- 构建命令、引用文档和上游环境文件未在本次静态审查中执行验证;应在目标 BSP 版本上先进行受控试运行。
- manifest 依赖 source、bsp_image、dirty-repo watermark 及 promote 技能之间的隐含契约,任一状态不一致都可能导致漏报或错误部署。
- 没有证明中文提示或中国大陆网络可用性;apt、NVIDIA 文档和工具链获取可能需要额外的镜像或离线准备。
这个 Skill 能做什么,适合哪些场景?
该技能用于重建 NVIDIA Jetson BSP 的内核侧产物,包括 DTB、OOT 模块、内核内置模块和内核 Image。它从已配置的 BSP 与源码工作区读取目标平台、工具链和构建环境,依据脏仓库自动选择 dt、oot、kernel 或 full 模式。构建结果保留在源码树中,并写入供 jetson-promote-image 使用的清单。它适合已经完成目标、镜像和源码初始化的 Jetson BSP 定制流程。
读取活动目标平台配置、BSP 构建环境、源码路径和交叉工具链;检查必要主机软件包与源码仓库;依据提交水位和未提交修改检测脏仓库;调用 NVIDIA 提供的 Makefile 原语构建 DTB、OOT 模块、内核内置模块和 Image;在 dt 或 full 模式下注册复合自定义 overlay;将可追溯到脏源码仓库的产物写入 .build-manifest.yaml,并在成功后更新 .build-state.yaml。
- Jetson BSP 定制提交了设备树变更,需要只重建 NVIDIA DTB 的开发者。
- Jetson BSP 的 OOT 驱动仓库发生变化,需要重建六类 OOT 模块的开发者。
- 内核源码发生变化,需要同时生成 Image、内置模块和内核侧设备树的开发者。
- 多个内核侧仓库同时变化,或需要安装整合阶段的 BSP 集成工程师。
- 自动构建被中断,或源码通过 git pull 引入后需要手动重跑构建的开发者。
这个 Skill 有哪些优点和局限?
- 支持 dt、oot、kernel、full 四种构建模式,并可根据脏仓库自动选择。
- 使用 NVIDIA BSP 已有的构建原语,避免在技能中重复实现构建逻辑。
- 通过水位文件和清单追踪构建来源与产物,便于后续部署。
- 对工具链、源码布局、主机软件包和复合 overlay 注册提供明确检查。
- 依赖已完成初始化的 Jetson BSP、源码布局和 ARM64 交叉工具链,不能在技能内解析缺失工具链。
- OOT 模式要求此前已经构建过内核头文件。
- 不会直接把构建产物写入 BSP 镜像,也不负责最终刷写。
- overlay-only 配置变更会绕过该 Build 阶段;内核设备树变更必须遵循复合 overlay 约定。
如何安装这个 Skill?
使用仓库 README 支持的 skills CLI 安装:npx skills add nvidia/skills --skill jetson-build-source --yes。该技能目录位于 skills/jetson-build-source;README 未规定其他专属安装步骤。
如何使用这个 Skill?
先运行 /jetson-init-image 和 /jetson-init-source,确保活动目标平台、BSP 源码、kernel_src_build_env.sh 和 source.toolchain 已就绪。自动检测脏仓库并选择模式:/jetson-build-source。也可强制执行:/jetson-build-source dt、/jetson-build-source oot、/jetson-build-source kernel 或 /jetson-build-source full。构建成功后,下一步是 /jetson-promote-image。