1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | nemo-relay-get-started | GitHub API |
| 作者/维护者 | NVIDIA Corporation and Affiliates（NeMo Relay 团队） | SKILL.md |
| 来源链接 | https://github.com/nvidia/skills/tree/main/skills/nemo-relay-get-started | — |
| 许可证 | Apache-2.0 | SKILL.md / 仓库根 LICENSE |
| GitHub Stars | 2,877（合集仓库整体，非本技能个体热度）；所服务的独立产品仓库 NVIDIA/NeMo-Relay 另有 119 星、54 Fork、19 个开放 Issue | GitHub API |
| 最新版本 | SKILL.md 未单独声明版本号；所指向的 NeMo Relay 运行时当前并存 0.6、0.7 两个版本（见第 11 章） | SKILL.md |
| 安装方式 | npx skills add nvidia/skills --skill nemo-relay-get-started --agent <agent>，或手动复制目录 |
仓库 README |
2. 功能介绍与亮点
nemo-relay-get-started 是 NVIDIA 官方可观测性运行时 NeMo Relay 的新手引导技能，帮第一次接触 Relay 的用户，用最小改动跑出第一条可见的追踪证据。
- 三条试用路径按优先级排列：命令行包装（直接跑 Codex / Claude Code / Hermes）、已支持框架集成（LangChain、LangGraph、Deep Agents、OpenClaw）、语言级手工埋点（Python/Node.js/Rust），技能会替用户判断走哪条路而不是罗列全部选项。
- 改动前必须确认：写配置、改应用代码、发起会消耗模型的调用之前都要求先取得用户同意，且首轮试跑限定为只读、非敏感数据。
- 对已知坑有专门预案：例如 Codex Desktop 存在上游线程可见性 bug（引用了具体 issue 编号），技能会主动避免触发持久化安装、并给出恢复文档写法。
- 一次接线、按插件扩展：核心卖点是先把一个执行边界接上 Relay，之后通过插件配置（Observability、Adaptive、Guardrails、PII Redaction、成本估算等）改变行为，无需重复返工埋点代码。
- 同一仓库内还配套安装、埋点、可观测性配置、运行时调试等 9 个姊妹技能，形成完整的使用链路。
3. 适用场景
所属分类：DevOps 与基础设施（生产级 Agent 应用可观测性，见第 7 章判定说明）。
面向已经在用 Claude Code、Codex 或 Hermes 构建自己 Agent 应用、且想知道“这一轮工具调用和大模型调用到底发生了什么”的开发者：无论是想临时验证一次调用链路、还是准备把追踪能力常态化接入生产环境，都可以从这个技能开始第一次试跑。
4. 跨Agent兼容性
- Claude Code：原生支持。技能安装器提供官方
--agent claude-code目标；技能正文本身也把 Claude Code 列为可直接包装的命令行之一。 - Codex：原生支持。技能安装器提供官方
--agent codex目标；正文详细区分了 Codex CLI 与 Codex Desktop 两种场景的不同处理方式。 - Hermes Agent：技能正文将 Hermes 列为可直接包装的三个命令行之一（第三方评测证实要求 Hermes Agent ≥ 0.18.2），但官方技能安装器的
--agent目标列表未包含 Hermes，技能文件本身能否被 Hermes 原生加载未验证。 - OpenClaw：技能正文把 OpenClaw 列为可通过“已支持框架集成”路径接入的应用之一，但同样不在官方技能安装器目标列表内，需适配。
5. 推荐理由
多数可观测性技能默认你已经决定好要接入哪个后端、要改多少代码；这个技能反过来先解决“我该怎么迈出第一步”——按环境自动收窄到一条最简路径，改动前必须确认，首轮只做只读验证，对已知的上游坑（如 Codex Desktop 线程可见性问题）给出具体规避写法而不是留给用户自己踩。对已经在用 Claude Code / Codex / Hermes 写 Agent 应用、想知道“这轮调用链路里发生了什么”的开发者，这是风险最低的起步方式。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | NVIDIA 官方出品；所属 nvidia/skills 为合集仓库，2,877 星不代表本技能个体热度；独立产品仓库 NVIDIA/NeMo-Relay 有 119 星、54 Fork、19 个开放 Issue，并已被第三方技术媒体 Classmethod DevelopersIO 做过实测评测 |
| 可用性 | 8 | 单命令即可安装；SKILL.md 结构清晰并配 3 篇独立参考文档；技能所在目录最近一次内容改动在近日（约两周一次的常态化同步）；开源免费，无付费依赖；配置格式随 0.6 → 0.7 版本有过破坏性变更，接入时需先确认目标版本 |
| 安全性 | 8 | 有真实的 shell 与配置写操作（安装、持久化接入某 Agent 的全局配置），但每一步都要求先展示命令、取得用户确认后才执行；正文明确禁止打印 token/API key/凭据文件；追踪数据外发目标由用户自行配置且是功能本身用途，姊妹技能 nemo-relay-plugin-observability 明确要求生产导出前先做脱敏验证；License 清晰；作者为 NVIDIA 官方组织 |
安全检查清单：①Shell 操作限于安装与经确认后的配置写入，无未声明的破坏性操作；②联网外发是追踪数据发往用户自选的可观测性后端，属功能本身用途且目标透明；③技能正文明文禁止把凭据打印到对话或写入不安全位置；④通读全文未见可疑指令或混淆代码；⑤作者为 NVIDIA 官方组织，无造假迹象；⑥License（Apache-2.0）明确；⑦近两周内仍有内容同步，维护活跃。
7. 跟同类Skills相比的优势
| 工具 | 定位 | 与本技能的差异 |
|---|---|---|
arize-instrumentation（Arize AI 官方技能） |
面向 Python LLM 应用的链路追踪自动埋点 | 需注册 Arize 账号与 API Key 才能拿到完整能力；本技能对应的 NeMo Relay 支持 Python/Node.js/Rust/Go 多语言，且本地运行即可产出证据，不强制依赖某个 SaaS 后端 |
| 通用 OpenTelemetry 手工埋点类技能 | 直接指导在应用里手写 span/trace 代码 | 需要自己设计埋点边界、维护采集代码；本技能提供命令行一键包装 Claude Code / Codex / Hermes 进程的路径，无需先改代码就能看到第一条证据 |
| 各类 Agent 平台自带的运行日志/控制台 | 平台内置、开箱即用，但仅覆盖该平台自身 | 只能看到该平台内发生的事，跨框架、跨语言的应用换个环境就失效；本技能的追踪层与具体框架解耦，同一套接线可以搬到不同应用 |
8. 用户评价
日本技术媒体 Classmethod DevelopersIO 的工程师森茂洋于 2026 年 8 月发布过一篇 NeMo Relay 实测文章，评价其“能按轮次生成追踪、以层级形式看到工具调用与大模型调用的父子关系”，认为本地运行、数据无需发往外部 SaaS 对内部使用场景有帮助；同时也指出局限：OpenTelemetry 输出路径下 token 计数不作为独立字段给出、缓存写入相关的成本也未被完整记录，配置格式随版本演进较快。
9. 其他补充
该技能同属 NVIDIA 官方 “skills” 仓库，内容由 NeMo Relay 团队每日自动从产品仓库同步，配套还有安装、埋点、上下文隔离、类型化封装、迁移、插件开发、可观测性配置、自适应调优、运行时调试等姊妹技能，形成从“试用”到“生产接入”的完整链路。
10. 安装使用方式
推荐方式（需 Node.js/npm）：
npx skills add nvidia/skills --skill nemo-relay-get-started --agent claude-code将 --agent claude-code 替换为 --agent codex 等即可装到其他官方支持的 Agent；可重复传入 --agent 一次装多个。装完在 Claude Code 里运行 /reload-skills 生效。
手动方式（无 Node.js 环境时）： 复制仓库 skills/nemo-relay-get-started/ 整个目录（含 SKILL.md 与 references/），放入对应 Agent 的技能目录，如 Claude Code 的 ~/.claude/skills/。
安装后向 Agent 提出“帮我试用 NeMo Relay”或类似需求即可触发；首次运行前需要本机已安装或可安装 nemo-relay 命令行。
11. 注意事项
- Hermes Agent、OpenClaw 均不在官方技能安装器的
--agent目标列表内，技能文件能否被这两者原生加载未经验证；但 NeMo Relay 产品本身支持包装 Hermes 命令行、或通过框架集成方式接入 OpenClaw 应用。 - NeMo Relay 0.6 与 0.7 两个版本的可观测性配置格式不兼容，接入前需先确认目标应用实际安装的版本。
- 持久化把 Relay 接入 Codex Desktop 存在已知的上游线程可见性问题（历史会话可能看似消失，但数据未被删除），技能正文已给出规避写法。
- 默认导出路径可能包含完整提示词与工具定义内容，正式环境使用前应先配置脱敏，不建议未经确认直接对接生产可观测性后端。