Agent 工具契約設計
設計或稽核 Agent 工具的名稱、觸發描述、schema、回傳格式與可恢復錯誤。
逐篇公開審查紀錄
桌面審查結論
tool-design 已通過四項桌面門檻。實用性評為 high：內容包含可操作流程與具體範例，能降低查找規則、重建步驟或漏掉檢查項的成本。
通過完整來源審查、三類合成任務測試與八項通用性品質門檻，依本次委託重審列入固定 30 席。
- 它完成什麼工作
- 設計或稽核 Agent 工具的名稱、觸發描述、schema、回傳格式與可恢復錯誤。
- 實質幫助
- 高 — 內容包含可操作流程與具體範例，能降低查找規則、重建步驟或漏掉檢查項的成本。
- 應該啟用
- 任務明確需要：This skill should be used for the tool-interface layer of an agent system specifically: writing tool descriptions agents can route on, designing tool schemas and response formats, naming conventions, actionable error recovery messages, MCP server design, tool-set consolidation, and deciding when to add or remove an individual tool. Use this when the unit of work is a single tool or a set of tools. Route project-shape, pipeline architecture, and task-model-fit decisions to project-develop…
- 不該啟用
- 需求不屬於「tool-design」的工作範圍，或只是名稱相近但交付物不同。
- 無法提供必要輸入、適用技術棧或可隔離的測試環境。
- 輸入
- 設計需求、使用情境、內容、品牌或技術限制與參考素材
- 輸出
- 設計決策、可實作規格、程式碼或媒體產出
來源、授權與依賴
來源：原始來源：https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/tool-design；於 2026-08-08T15:34:07.434Z 取得 297 行，SHA-256 14f5a12b69113bc6450da69c5b4d408fe91601832ab1055ae25311339c84a06b。
授權：上游授權檔檢出 MIT；本館 catalog 欄位依 README 正式授權章節維持 MIT。
依賴：原文未明示需另行安裝的套件；仍須依實際執行環境確認工具可用性。
快照：開啟審查來源 · 297 行 · SHA-256 14f5a12b6911… · 2026-08-08T15:34:07.434Z
安全測試邊界
使用合成、非敏感的設計需求、使用情境、內容、品牌或技術限制與參考素材，只評估設計決策、可實作規格、程式碼或媒體產出；不連線到正式環境，不提交或發布結果。
- 不得使用真實憑證、敏感資料或正式環境
- 不得發布、交易、寄送訊息或執行不可逆變更
這是可安全執行的測試方案；只有固定 30 席推薦 Skill 另有三類實測通過證據。
價值證據
- 297 行內容、12 個主要小節
- 4 個程式碼區塊、50 個編號步驟、0 個檢查項
- 2 個明示附檔
限制
桌面審查未發現額外限制；仍不等同推薦或正式環境保證。
必要附檔：2／2 可取得
references/architectural_reduction.md— 可取得references/best_practices.md— 可取得
公開策展紀錄
為什麼推薦
- 明確工作
- 設計或稽核 Agent 工具的名稱、觸發描述、schema、回傳格式與可恢復錯誤。
- 應該啟用
- 工作單位是單一 Agent tool 或一組容易選錯的 tools。
- 不該啟用
- 要設計一般人類開發者 API、整體 Agent 架構或是否使用多 Agent。
- 輸入
- Agent 要完成的工作
- 輸入限制
- 成功與錯誤結果
- 輸出
- 工具名稱與描述
- JSON schema
- 回傳契約
- 路由與錯誤恢復測試
- 和現有 Skill 的差異
- 優化非決定性 Agent 是否能選對並呼叫成功；不是一般公開 API 設計。
- 來源、授權與依賴
-
- 來源：已確認。原始來源：https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/main/skills/tool-design；於 2026-08-08T15:34:07.434Z 取得 297 行，SHA-256 14f5a12b69113bc6450da69c5b4d408fe91601832ab1055ae25311339c84a06b。
- 授權：已確認。上游授權檔檢出 MIT；本館 catalog 欄位依 README 正式授權章節維持 MIT。
- 依賴：已確認。無額外依賴
- 完成條件
- 名稱與觸發不歧義，schema 能拒絕無效輸入，成功與錯誤回傳都可讓 Agent 繼續行動。
- 最小必要脈絡
- Agent 任務
- 輸入限制
- 成功與失敗情境
- 可組合的工作
- 新鮮度與下次複審
- 變動風險：中；最晚於 2027-02-09 前複審。
- 證據層級
- 合成任務測試。已通過隔離式合成任務 evaluator；目前未蒐集採用率或真實使用成功率，不把測試通過冒充社群採用證據。 合成測試通過只代表在隔離案例中符合預期，不等於真實採用率、使用成功率或社群背書。
三類測試證據
提示：設計一個讓 Agent 搜尋訂單的唯讀工具與錯誤契約。
預期：應啟用：設計或稽核 Agent 工具的名稱、描述、schema、回傳與錯誤恢復。
結論：提示要求設計 Agent 使用的唯讀訂單搜尋工具及錯誤契約，直接符合 Skill 所宣告的單一工具描述、schema、回傳格式與可恢復錯誤設計範圍。
Codex isolated evaluator；read-only sandbox；合成、非敏感輸入；無外部副作用 · 2026-08-09
提示：設計給第三方人類開發者使用的 REST pagination。
預期：不應啟用；邊界：只是一般公開 REST API，沒有 Agent 選擇工具的需求。
結論：提示是供第三方人類開發者使用的 REST 分頁設計，屬一般公開 API 契約，而非非決定性 Agent 的工具介面；不應啟用此 Skill，應改用人類開發者 API 設計流程。
Codex isolated evaluator；read-only sandbox；合成、非敏感輸入；無外部副作用 · 2026-08-09
提示：為依 email 查詢單一客戶的唯讀 tool 設計名稱、描述、JSON schema、not-found 與多筆衝突回傳。
預期：契約能讓 Agent 判斷何時呼叫，輸入受限、回傳可解析且錯誤可恢復。
結論：依 Skill 的描述工程、受限 schema、機器可解析回傳及可恢復錯誤原則，能產出完整且可測試的唯讀客戶查詢契約。
Codex isolated evaluator；read-only sandbox；合成、非敏感輸入；無外部副作用 · 2026-08-09
啟用時機
當你需要建置 tools that agents can use effectively, including architectural reduction 模式時使用。
適合使用情境
- 需要建置 tools that agents can use effectively, including architectural reduction 模式。
- 想使用 muratcankoylan/tool-design 這類已整理好的 Agent Skill，而不是從零撰寫 prompt。
- 需要從 awesome-agent-skills 索引快速找到 Context Engineering 相關 Skill。
Skill 檔案
awesome-agent-skills README catalog entry
工作流程
- 先開啟原始來源，確認該 Skill 的安裝方式、支援工具與限制。
- 把 Skill 放到對應 agent 或 IDE 的 skills 目錄。
- 用一個小型真實任務測試 Skill 是否會在正確時機啟用。
- 確認輸出符合原始 Skill 的工作契約，再匯入日常工作流。
使用注意事項
- 這筆是 awesome-agent-skills 的索引項，本 workspace 未包含完整 SKILL.md。
- 實際安裝前請回到原始來源確認最新內容、授權與目錄結構。
來源
來源頁標題：TOOL Design Skill
來源識別名稱：muratcankoylan/tool-design
Build tools that agents can use effectively, including architectural reduction patterns
software-engineering-prompt-repos/awesome-agent-skills/README.md
開啟來源這個 Skill 在做什麼
建置 tools that agents can use effectively, including architectural reduction 模式。這筆資料來自 awesome-agent-skills 的索引清單，原始專案是 muratcankoylan/tool-design。
為什麼值得收錄
它屬於 Context Engineering 相關的 Agent Skill，可作為尋找、安裝或評估同類 Skill 的入口。因為來源 repo 本身沒有把完整 Skill 檔案放在本地，所以此頁保留 catalog 資訊與原始連結，避免把索引項誤認為完整 SKILL.md。
來源 Skill
這筆資料來自 awesome-agent-skills 的上游索引清單；本 workspace 沒有下載完整 SKILL.md。請開啟來源連結檢視或安裝原始 Skill。
開啟原始 Skill