Jetson 目标知识库生成器
扫描 Jetson BSP 与源码树，生成按目标配置组织的知识库快照。
技能明确限制为只读扫描 BSP/source 树，并禁止抓取 URL；但会无确认覆盖写入目标 KB，未定义备份、回滚或并发保护，且可能把本地文档路径写入输出，因此扣分。
流程、输入校验、缺失路径处理、扫描边界和失败提示较具体；但未提供可执行脚本、依赖锁定、异常输入覆盖或端到端测试，静态评估不超过 10 分，故扣分。
目标用户、触发时机、输入字段、输出位置和不适用场景较清楚，并支持无 source/documents 的降级；但未说明中文交互或中国大陆环境适配，触发条件主要依赖相邻技能和特定 profile 约定，故扣分。
文档结构完整，包含概览、流程、限制、前置条件、故障排查、引用和版本；但缺少 Examples/Instructions 专门章节，版本变更记录和明确维护更新路径不足，且 SKILL.md 的 Apache-2.0 与仓库 NOASSERTION、skill-card 的双许可证表述存在治理不一致，故扣分。
目标是生成可直接阅读的 per-target Markdown 快照，输出结构和确认摘要定义明确，评测文件也显示正向任务存在可观准确率；但仅有两项内部任务、无静态可核验代表性产物，且结果仍需用户审阅，故按静态上限保守扣分。
提供了固定 revision、评测报告和 evals.json，可审计技能预期行为；但无独立第三方复现、无覆盖该技能关键路径的提交测试套件或真实 CI 证据，因此不超过 5 分并扣分。
- 覆盖写入 target-platform/<profile-stem>.md 前不会请求确认，也没有回滚机制；应在生产使用前增加备份或原子写入策略。
- 输出会记录本地文档路径和存在性，需确认这些路径不包含敏感信息。
- 许可证声明不一致，应由维护者明确 SKILL.md 的适用许可证及其与仓库许可证的关系。
- 评测仅含两个正向任务且无负向任务，无法充分验证误触发、边界输入或中国大陆环境可用性。
这个 Skill 能做什么，适合哪些场景？
该技能面向 NVIDIA Jetson Linux BSP 工作流，为当前活动目标生成一份 Markdown 知识库快照。它检查 BSP 目录布局、源代码树、芯片匹配的设备树文件，以及配置文件中记录的文档引用。输出文件保存在目标配置旁边，并可在 BSP、源码或文档引用变化后重新生成。它适合需要快速了解当前 Jetson 目标结构的工程师，但不会编辑 profile YAML 或执行深度递归扫描。
解析活动目标 profile，要求其中存在有效的 bsp_image.root_path；使用一级目录列表检查 BSP 顶层目录和 canonical 子树，验证 flash_config，并筛选匹配模块 ID 与 SKU 的 nvpmodel 配置文件。若存在 source.root_path，则检查源代码树的指定子树，并按芯片族筛选设备树文件，最多记录 30 项。它检查 documents.* 中本地路径是否存在，原样记录 URL 但不访问 URL。最后以当天日期生成或覆盖 target-platform/<profile-stem>.md，并输出简短摘要。
- Jetson 工程师刚准备好新的 BSP profile，需要快速记录 rootfs、bootloader、source 等目录是否存在。
- 开发者更新 BSP 源码树后，希望查看 kernel、OOT 驱动和设备树目录的当前布局。
- 调试刷写配置时，需要确认活动 flash_config 和对应模块 SKU 的 nvpmodel 文件。
- 团队维护多个 Jetson 目标 profile，需要为每个目标生成可供后续会话查阅的文档快照。
这个 Skill 有哪些优点和局限？
- 输出涵盖 BSP 布局、源码布局、设备树、nvpmodel 和文档引用的单一 Markdown 快照。
- 支持重复运行，并在每次运行时覆盖旧知识库。
- 明确限制为一级目录列表和定向文件筛选，避免对大型 BSP 进行递归扫描。
- 离线记录文档 URL，不会抓取外部内容。
- 必须有有效且存在的 bsp_image.root_path，否则不会生成知识库。
- 只执行有限的目录发现，不提供完整递归文件索引或文件内容分析。
- 芯片族映射仅覆盖 p3701、p3767 和 p3834；其他 module.id 会跳过设备树前缀筛选。
- 源材料没有提供此单项技能的测试套件、平台覆盖或运行性能证据。
如何安装这个 Skill？
README 为整个 NVIDIA/skills 集合提供安装命令：npx skills add nvidia/skills。也可以使用 npx skills add nvidia/skills --skill jetson-generate-kb --yes 安装此技能。源材料没有说明其他安装方式或特定版本要求。
如何使用这个 Skill？
先按技能要求准备活动目标 profile，并确保 bsp_image.root_path 指向磁盘上存在的 BSP 目录；source.root_path 和 documents.* 为可选项。可向已加载该技能的 agent 请求：“为当前活动 Jetson profile 生成目标知识库”。技能会写入 target-platform/<profile-stem>.md；若 BSP 根目录缺失或不存在，它会拒绝生成。