generate-sdk-types

generate-sdk-types 技能为使用模型上下文协议 (MCP) 结合 Rust 后端与 TypeScript 客户端的项目，提供一套稳健的自动化流程以维护类型一致性。它连接了 Rust ToolDefinition 结构体与 TypeScript 接口，有效消除手动同步的负担并防止开发周期中的类型偏移。此技能专为维护跨语言 SDK 的开发者设计，特别是当后端工具架构频繁变动时。通过从运行中的 Rust 服务自动获取 JSON 架构并转换为强类型的 TypeScript 定义，确保客户端的工具执行与后端实现完美对齐。常见的使用案例包括在修改 MCP 工具、更新参数架构或进行协议变更后刷新 SDK 定义。此工具依赖 Pierre 服务器环境与 Bun 运行时来促进架构解析与文件生成。它确保服务器公开的每个工具皆已注册于 SDK 的类型登录档中，使开发者能编写类型安全的客户端代码。主要功能包括自动类型同步、内置类型一致性验证、完整的工具注册生命周期支持，以及与 CI/CD git diff 分析的无缝集成。实际使用流程包含在修改 Rust 工具登录档后执行生成指令码、验证输出是否符合既有架构，并将生成的类型提交至存储库。过程需启动后端服务、透过 Node.js 或 Bun 执行生成逻辑、格式化生成的源代码，并执行类型检查测试以确保编译成功。限制条件包含对 Pierre 生态系统的强制依赖、生成期间需有运行中的服务器实例，以及必须严格遵守 SDK 的来源目录结构。输出结果为一组 TypeScript 接口与一个集中式的工具注册常量，通过为所有可用工具提供自动完成与静态类型验证，简化了客户端开发流程。