用途:为已存在的智能体技能目录创建 NVIDIA 治理技能卡草稿,或在技能变更后刷新其现有卡片,也可用于技能负责人准备法律/安全评审材料。不适用于解释、列举、比较或讨论技能,不适用于创建或改写源技能,不适用于为模型、数据集、容器或完整系统等非技能资产生成卡片,也不替代人工法律、安全或所有者评审。
主要能力:先运行发现脚本提取技能文件、仓库信号、样式指南与模板等结构化信号;据此构建接地气的上下文 JSON(凭证需求仅含 requires_api_key_or_credential 与 credential_types 两个字段,词表见 references/style-guide.md);再用 Jinja 模板渲染 Markdown 卡片;最后校验渲染结果是否仍残留 VERIFY 或 SELECT 复核标记。
使用方式:前置条件为 Python 3 可用、运行 render_card.py 前已安装 jinja2、目标路径是含 SKILL.md 或 skill.md 的技能目录。先完整阅读 SKILL.md,从 $ARGUMENTS 解析目标目录(省略则用当前工作目录),保持声明的权限范围。依次运行 scripts/discover_assets.py、scripts/render_card.py、scripts/validate_submission.py。渲染前修正 schema 错误,人工复核并清除已解决的 VERIFY 与 SELECT 标记,确认无未渲染的 {{ ... }} 或 {% ... %} 模板片段。
限制:生成结果为草稿,必须由人工所有者复核;发现范围限于本地文件及目标路径可见的仓库元数据;渲染器只验证上下文结构,不验证字段值的法律或安全正确性;预置的限制与风险目录只是起点,应删除不适用条目。
故障处理:目录不存在时用绝对路径重跑发现;缺 jinja2 时安装后重跑渲染;上下文校验失败时按样式指南修正 JSON;标记未清除时逐项确认并修剪目录条目后重跑校验。