tpmjs-tool-creator

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）模式，保證單次呼叫即可產生單一結構化輸出，以在代理程式的推理迴圈中達到最高可靠性。