工程开发
tpmjs-tool-creator avatar

tpmjs-tool-creator

使用 blocks CLI、AI SDK v6 与 npm 注册表模式创建及发布 TPMJS 工具的开发指南。

简介

TPMJS 工具创建器为开发者提供了一套标准化且高效的工作流程,用于构建符合 TPMJS 注册表规范的生产级工具。此技能专为代理程序架构(agentic architectures)设计,引导您完成 AI SDK v6 工具的完整生命周期,从在 blocks.yml 中进行初步定义,到通过 npm 完成最终部署。它确保每个工具都是可发现的、具备类型安全,并可供由大型语言模型(LLM)驱动的代理程序直接使用。

  • 提供简化的工作流程,用于在 packages/tools/official/blocks.yml 中定义工具并结构化元数据。

  • 严格遵守 AI SDK v6 模式,包括 jsonSchema 验证、特定的导出签名以及 try-catch 错误处理。

  • 使用 blocks CLI 的整合式验证套件,让开发者能针对 LLM 验证来测试工具执行、架构相容性与领域规则。

  • 原生支援构建与发布 npm 套件,并包含 tpmjs 关键字,以在 tpmjs.com 上自动进行索引编制。

  • 提供多工具封装、专案目录结构(tsup, tsconfig, package.json)以及强健的输入/输出接口的最佳实践。

  • 确保所有工具都提供清晰、适合 LLM 的描述,并使用 additionalProperties 为 false 的有效 jsonSchema。

  • 使用有效的 OpenAI API 金钥通过 blocks CLI 执行工具,以在发布前验证其是否符合系统的运作标准。

  • 务必依照 @tpmjs/official-toolname 的命名惯例将工具实作为 npm 套件。

  • 使用提供的 package.json、tsup.config.ts 与 index.ts 专案模板,以确保与 TPMJS 执行器(executor)的相容性。

  • 创建多工具套件时,请遵循指定的根层级 block.ts 与 index.ts 模式,以干净地导出多项功能。

  • 确保您的工具实作采用单发(single-shot)模式,保证单次呼叫即可产生单一结构化输出,以在代理程序的推理循环中达到最高可靠性。

仓库统计

Star 数
24
Fork 数
6
Open Issue 数
3
主要语言
TypeScript
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 16:27
在 GitHub 查看