技能 tool-design
🛠️

tool-design

安全

為 AI 代理設計有效的工具 API

也可從以下取得: Asmayaseen,ChakshuGautam,muratcankoylan

糟糕的工具設計會產生任何提示工程都無法修復的失敗模式。本技能提供為 AI 代理推理和消費優化的工具介面建構原則。

支援: Claude Codex Code(CC)
📊 70 充足
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「tool-design」。 Review this tool: def search(query): "Search the database."

預期結果:

  • 發現的問題:(1) 名稱模糊 - 搜尋什麼?(2) 遺失參數文件 - 什麼格式?(3) 無回傳描述 (4) 無錯誤處理 (5) 無使用情境
  • 建議:重新命名為 search_customers(query, fields)、記錄查詢語法、指定回傳格式、新增 INVALID_QUERY 和 RATE_LIMITED 錯誤案例

正在使用「tool-design」。 How do I reduce 50 specialized tools to a simpler set?

預期結果:

  • 應用整合:依工作流程而非資料實體分組相關工具
  • 考慮架構簡化:檔案系統存取 + 標準工具能否取代自訂工具?
  • 以 10-20 個具命名空間的工具為目標:database.query、database.schema、web.search、web.fetch

安全審計

安全
v1 • 2/25/2026

Static analysis flagged 73 potential issues but all are false positives. The SKILL.md file is documentation-only containing conceptual explanations and Python code examples in markdown blocks. No executable code, network calls, or system commands exist. External command patterns (8) are markdown code snippets, network patterns (3) are documentation URLs, cryptographic warnings (62) are text matches in prose, and reconnaissance flags (6) reference conceptual discussions.

1
已掃描檔案
319
分析行數
0
發現項
1
審計總數
未發現安全問題
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
24
社群
100
安全
91
規範符合性

你能建構什麼

建構代理工具集

為 Claude 或 Codex 設計完整的工具 API,使其能有效與您的系統互動

除錯工具誤用

診斷代理為何無法正確使用工具並改善描述

降低工具複雜度

應用架構簡化來簡化過度設計的工具架構

試試這些提示

初學者:評估工具設計
檢視此工具規格並識別設計問題:[貼上工具程式碼]。檢查模糊描述、遺失的參數文件、不明的回傳格式和錯誤處理缺口。
中級:重新設計不佳的工具
此工具描述不明且導致代理失敗:[貼上工具]。遵循工具設計原則重新設計:明確說明功能/使用時機/回傳內容、整合功能、提供可操作的錯誤訊息。
進階:應用架構簡化
分析我目前的工具集:[列出工具]。識別整合和簡化的機會。推薦可取代專用工具的最小通用工具集。
專家:設計工具集策略
我正在為 [domain] 建構代理。協助我使用整合和命名空間原則設計工具集。考量:獨特工作流程、工具數量限制 (10-20)、回應格式選項和復原導向的錯誤訊息。

最佳實務

  • 撰寫工具描述,說明其功能、使用時機和回傳內容
  • 優先選擇單一完整工具而非多個狹隘工具,以減少歧義
  • 設計錯誤訊息,告知代理如何復原,而非僅說明失敗原因

避免

  • 使用模糊描述如 'helps with' 或 'can be used for'
  • 使用 cryptic 參數命名工具如 x、val 或 data
  • 建構限縮模型可處理之推理的防護工具

常見問題

我應該提供多少工具給代理?
研究建議大多數應用程式使用 10-20 個工具。更多工具會增加混淆和令牌消耗。使用命名空間組織相關工具。
什麼是架構簡化?
移除專用工具,改用原始、通用功能。例如:檔案系統存取 + Unix 工具而非自訂資料探索工具。
我應該何時整合工具?
當人類無法明確指出使用哪個工具時進行整合。當工具具有根本不同的行為或安全需求時避免整合。
我如何撰寫有效的工具描述?
回答四個問題:它做什麼(具體而非模糊)、何時使用(觸發條件和情境)、接受什麼輸入(類型和限制)、回傳什麼(格式和結構)。
什麼是整合原則?
如果人類工程師無法指出使用哪個工具,就不能期望代理做得更好。這導致優先選擇完整工具而非多個狹隘工具。
我如何測試工具設計?
使用代理在多樣化任務中測試工具、收集失敗模式、分析摩擦點並迭代描述。代理反饋可實現任務完成時間減少 40%。

開發者詳情

檔案結構

📄 SKILL.md