Jetson 文档绑定器
将本地 Jetson 参考文档注册到活动目标平台配置中。
技能仅绑定预下载文档指针，不负责下载，并对自动匹配要求用户确认，多匹配项不得静默绑定；但会原地修改活动配置，未明确备份、事务性写入或回滚方案，且允许记录未存在路径和未经验证的 URL，因此扣分。
流程、异常分支、重复运行合并规则和故障提示较完整；但依赖的上下文契约、模板、目录和 YAML 库未在本次材料中得到复现，且没有该技能的实际测试套件覆盖关键路径。静态上限为10，故扣分。
触发场景、输入条件、文档槽位和不适用的自定义载板字段均有说明，并披露一层目录扫描限制；但没有中文交互、语义误触发边界或不同环境适配证据，因此扣分。
文档结构清晰，包含版本、许可证、前置条件、限制、故障排查、引用和可维护的重跑说明；但缺少独立 Instructions 和 Examples 章节，作者格式不完整，许可证信息在材料间存在 Apache-2.0 与 CC-BY-4.0 双重表述，维护责任和变更记录仍不够明确。
技能能将用户确认的文档路径写入 profile，直接服务下游知识库流程；但评估仅含2个正向任务，codex effectiveness 为32%，且没有关键输出的独立复现证据，静态评估不超过7，故保守扣分。
提供了评估报告、任务定义和预期行为，形成有限可审计证据；但没有该技能的可执行测试、真实日志或多源交叉验证，且报告结论无法仅凭材料独立复现，因此低分。
- 原地写入活动 profile 前应增加备份或可恢复机制，并明确写入失败时的处理。
- 应统一许可证和作者信息，并补充独立的 Instructions、Examples、版本变更和维护责任说明。
- 路径校验规则存在张力：流程允许绝对路径和 URL，但故障排查称 documents.* 必须为相对路径；应明确一致的安全边界。
- 一层深度、仅按文件名 glob 匹配可能导致漏绑定或错误绑定，用户应核对产品、版本和原理图对应关系。
这个 Skill 能做什么，适合哪些场景？
jetson-link-docs 面向 Jetson Linux 或 IGX 目标平台配置，负责把已下载的参考文档路径写入活动 profile 的 documents 区块。它可扫描指定文档目录，并通过大小写不敏感的文件名匹配建议开发者指南、设计指南、原理图、引脚复用表等文件。所有自动匹配结果都需要用户确认，多候选文件则要求用户选择。该技能只注册文件指针，不负责下载、复制或重命名文档。
解析活动目标 profile 和文档槽位 schema；解析 documents.root_path，默认使用 workspace/Documents；读取 BSP 平台目录中的 Product Token；对文档目录执行一次、深度为一层的大小写不敏感 glob 扫描；提示用户确认或选择匹配结果；接受本地路径或 URL；使用可保留注释和格式的 YAML 写入器更新活动 profile 的 documents 区块；输出绑定、手动输入和跳过字段的摘要。
- Jetson 初始化目标完成后，用户已将开发者指南、原理图或 pinmux 文件放到本地，需要登记到 profile。
- 现有 Jetson 目标 profile 中的参考文档已更换，需要修改或移除对应路径。
- jetson-generate-kb 报告没有记录文档，用户需要修复 documents 配置。
- 使用自定义载板时，需要为自定义载板登记原理图或 pinmux 文件。
- 文档目录中存在多个候选版本，需要人工确认以避免绑定错误产品资料。
这个 Skill 有哪些优点和局限？
- 专门处理 Jetson/IGX profile 的 documents 区块，职责清晰。
- 支持 SKU 和产品 token 的文件名匹配，并要求用户确认，降低错误绑定风险。
- 支持增量重跑，保留既有绑定，且设计为保留 YAML 注释和格式。
- 可处理本地路径和 URL，并允许跳过可选文档字段。
- 只注册指针，不下载、复制或重命名文件。
- 自动扫描只检查一层目录，分层归档的文档可能需要手动选择。
- 依赖活动 profile、固定 schema，以及 ruamel.yaml 或等效的往返 YAML 写入器。
- 源文档未提供测试套件、支持平台清单或性能数据。
如何安装这个 Skill？
使用仓库 README 支持的 skills CLI 安装：npx skills add nvidia/skills --skill jetson-link-docs --yes。README 未规定特定安装目录；CLI 会处理安装目标。
如何使用这个 Skill？
先确保存在活动 Jetson/IGX 目标 profile，并将参考文档放在 profile 的 documents.root_path、默认 workspace/Documents，或准备好手动提供的路径。然后向代理提出："将已下载的 Jetson 参考文档绑定到当前目标 profile；扫描文档目录并让我确认每个匹配结果。" 该技能会提示未匹配字段，并将确认后的路径写回活动 profile。它不会下载文档；如果没有活动 profile，应先使用 jetson-set-target 或 jetson-init-target。