用途:当某项变更影响 NeMo Relay 的公开运行时接口,并需要在 Rust 核心、FFI 以及一个或多个语言绑定之间保持行为一致时,使用本技能。不适用于仅内部核心重构、新增中间件契约、不改变共享行为的绑定本地修复,以及仅文档或示例更新。
实现顺序:先在 crates/core/src/api/ 及相关核心模块(如 crates/core/src/api/runtime/、crates/core/src/codec/、crates/core/src/json.rs)实现行为;当能力通过 C ABI 或 Go 绑定时,更新 crates/ffi 及其生成头文件;再更新暴露该能力的各语言绑定,未涉及的绑定保持不变;如新行为属于 Python 包装模块、Go 简写包、类型化辅助或 adaptive/plugin 辅助,则一并更新;公开接口或预期用法变化时更新参考文档、语言绑定文档与示例;最后按仓库验证策略对公开或可观察行为变化的接口进行验证。
命名约定:Rust 用 snake_case(如 nemo_relay_tool_call);C FFI 用 nemo_relay_ 前缀;Python 用 snake_case(如 nemo_relay.tools.call);Go 用 PascalCase(如 nemo_relay.ToolCall);Node.js 用 camelCase(如 toolCall)。
一致性清单:核心函数需带文档注释;按需在相关核心模块添加运行时回调/状态、codec、JSON 或 event/tool/LLM/scope 类型;C ABI 变化时更新 FFI 包装与生成头文件;Python 暴露时更新原生绑定、包装、docstring 与 stubs;Go 实验性接口暴露时更新包装与简写包;Node.js 暴露时更新原生绑定与包装;适用时更新类型化包装或 adaptive/plugin 辅助;在每个受影响语言面添加有意义的测试;新文件加 SPDX 许可证头;更新 docs/reference/ 下相关页面;行为因语言而异时更新 README.md、docs/getting-started/ 或绑定级 README;用法变化时更新相关入门、README 或示例文档。
决策点:实现前需确定哪些绑定真正暴露新接口;变更属于纯 JSON API、类型化包装、adaptive/plugin 辅助还是可观测性辅助;新 API 是否需要手动生命周期与托管执行两种变体;是否改变事件字段、元数据或 scope 预期;若涉及工具执行,各回调、续接、托管返回与手动结束接口是否都使用规范 ToolExecutionResult 契约并保留其不透明注解;预期用法变化时是否需要文档与示例。
关键参考:架构 docs/about-nemo-relay/architecture.mdx;参考索引 docs/reference/api/index.mdx;入门与绑定状态 README.md、docs/getting-started/quick-start/index.mdx、docs/reference/support-matrix.mdx;类型化包装与 codec 见 docs/integrate-into-frameworks/using-codecs.mdx、docs/integrate-into-frameworks/provider-codecs.mdx;adaptive 配置与插件见 docs/configure-plugins/about.mdx、docs/build-plugins/about.mdx、docs/configure-plugins/adaptive/configuration.mdx。建议参照已在核心、FFI、Python、Go 与 Node.js 中实现过的接口模式,而非另创新形态。