技能 tool-interface-analysis
📦
tool-interface-analysis
內容修訂 r1 安全 ⚡ 包含腳本⚙️ 外部命令🔑 環境變數
分析 Agent 工具介面
Agent 框架通常會隱藏工具如何被註冊、驗證和重試。此技能會引導你對工具抽象、結構描述、內建工具和錯誤回饋進行結構化審查。
支援: Claude Codex Code(CC)
使用我的智慧代理安裝
將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。
智能體請求
Review the Skillstore skill "tool-interface-analysis" from https://skillstore.io/skills/dowwie-tool-interface-analysis.md and its manifest at https://skillstore.io/api/skills/dowwie-tool-interface-analysis/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。
Agent 可讀資源
當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。
測試它
正在使用「tool-interface-analysis」。 分析使用 Pydantic 模型作為工具引數並搭配中央登錄表的框架。
預期結果:
一份 Markdown 報告，描述核心工具抽象、結構描述生成路徑、登錄流程、驗證行為，以及對新設計的影響。
正在使用「tool-interface-analysis」。 比較兩個具有不同錯誤回饋機制的框架。
預期結果:
- 並列摘要回饋品質和重試支援。
- 關於驗證錯誤在哪裡到達模型的具體筆記。
- 針對更清楚的修正提示和結構化錯誤物件提出建議。
正在使用「tool-interface-analysis」。 審查 Agent 框架儲存庫中的內建工具。
預期結果:
工具類別、工具位置、結構描述方法、sandbox 筆記，以及值得注意的實作取捨清單。
安全審計
安全v8 • 2026/7/6 開啟版本化報告
All static findings reviewed were false positives caused by Markdown code fences, inline code formatting, placeholder api_key examples, and illustrative Python snippets. I found no prompt injection, credential exposure, command execution, or system reconnaissance intent in SKILL.md.
1
已掃描檔案
786
分析行數
0
複核項目
0
已忽略的誤報
風險因素
⚡ 包含腳本 (1)
⚙️ 外部命令 (97)
SKILL.md:34-53 SKILL.md:53-60 SKILL.md:60-71 SKILL.md:71-78 SKILL.md:78-95 SKILL.md:95-102 SKILL.md:102-118 SKILL.md:118-127 SKILL.md:127-167 SKILL.md:167-174 SKILL.md:174-192 SKILL.md:192-199 SKILL.md:199-210 SKILL.md:210-217 SKILL.md:217-237 SKILL.md:237-255 SKILL.md:255-259 SKILL.md:259-265 SKILL.md:265-280 SKILL.md:280-286 SKILL.md:286-302 SKILL.md:302-308 SKILL.md:308-332 SKILL.md:332-338 SKILL.md:338-354 SKILL.md:354-374 SKILL.md:374-380 SKILL.md:380-383 SKILL.md:383-389 SKILL.md:389-392 SKILL.md:392-421 SKILL.md:421-424 SKILL.md:424-438 SKILL.md:438-443 SKILL.md:443-453 SKILL.md:453-456 SKILL.md:456-465 SKILL.md:465-475 SKILL.md:475-478 SKILL.md:478-485 SKILL.md:485-506 SKILL.md:506-507 SKILL.md:507-508 SKILL.md:508-509 SKILL.md:509-516 SKILL.md:516-518 SKILL.md:518-524 SKILL.md:524-540 SKILL.md:540-542 SKILL.md:542-544 SKILL.md:544-555 SKILL.md:555-560 SKILL.md:560-565 SKILL.md:565-567 SKILL.md:567-570 SKILL.md:570-572 SKILL.md:572-580 SKILL.md:580-584 SKILL.md:584-586 SKILL.md:586-590 SKILL.md:590-599 SKILL.md:599-629 SKILL.md:629 SKILL.md:637-639 SKILL.md:639-651 SKILL.md:651-655 SKILL.md:655-660 SKILL.md:660-664 SKILL.md:664-666 SKILL.md:666-677 SKILL.md:677-679 SKILL.md:679-681 SKILL.md:681-699 SKILL.md:699-701 SKILL.md:701-713 SKILL.md:713-717 SKILL.md:717-719 SKILL.md:719-723 SKILL.md:723-724 SKILL.md:724-725 SKILL.md:725-726 SKILL.md:726-727 SKILL.md:727-747 SKILL.md:747-753 SKILL.md:753-754 SKILL.md:754-755 SKILL.md:755-756 SKILL.md:756-757 SKILL.md:757-778 SKILL.md:778 SKILL.md:779-780 SKILL.md:780 SKILL.md:781 SKILL.md:782 SKILL.md:783 SKILL.md:784-785 SKILL.md:785
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: codex 檢視審計紀錄 →
分享與引用此報告
分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。
複製報告連結
https://skillstore.io/skills/dowwie-tool-interface-analysis/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/dowwie-tool-interface-analysis?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/dowwie-tool-interface-analysis?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/dowwie-tool-interface-analysis/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/dowwie-tool-interface-analysis.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>學術引用 (APA · BibTeX · CFF)
APA 引用
Dowwie. (2026). tool-interface-analysis security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/dowwie-tool-interface-analysis/audits/8BibTeX 引用
@techreport{dowwie-dowwie-tool-interface-analysis-2026,
author = {Dowwie},
title = {tool-interface-analysis security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/dowwie-tool-interface-analysis/audits/8},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "tool-interface-analysis security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "Dowwie"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/dowwie-tool-interface-analysis/audits/8"
identifiers:
- type: other
value: "skillstore:dowwie-tool-interface-analysis:audit:8"
description: "Skillstore immutable audit report identifier"
Skillstore 評分
評分依據 證據置信度: 高 55
架構
85
可維護性
87
內容
72
社群
74
規範符合度
你可以打造什麼
審查新的 Agent 框架
識別框架如何定義工具、驗證引數，並將工具暴露給模型。
比較工具呼叫設計
在為新實作選擇模式之前，跨框架建立一致的筆記。
改善重試與錯誤回饋
追蹤失敗如何回傳給模型，以及可以在哪裡強化自我修正。
試試這些提示
映射工具基礎
使用 tool-interface-analysis 分析此框架。從工具建模、結構描述生成、註冊、執行和錯誤回饋開始。
比較結構描述方法
使用 tool-interface-analysis 比較此框架如何生成工具結構描述。記錄內省、Pydantic、裝飾器和手動模式，並附上檔案參照。
稽核重試行為
使用 tool-interface-analysis 追蹤此程式碼庫中的驗證失敗、執行錯誤、重試規則和 LLM 自我修正回饋。
建立架構建議
使用 tool-interface-analysis 分析這些框架，並為新的 Agent 工具層產生建議，包括取捨和反模式。
最佳實務
- 從定義基礎工具、結構描述、登錄表、執行器和驗證的框架檔案開始。
- 在輸出文件中為每項主張記錄檔案和行號參照。
- 將介面設計發現與供應商協定發現分開。
避免
- 不要在未檢查實作程式碼的情況下，從範例推斷結構描述行為。
- 不要將工具介面分析與不相關的供應商訊息格式分析混在一起。
- 在追蹤執行路徑之前，不要將缺少重試行為視為已確認。
常見問題
此技能會分析什麼？
它會分析 Agent 框架中的工具建模、結構描述生成、註冊、執行、驗證、錯誤回饋和重試模式。
它會執行工具或修改目標框架嗎？
不會。它會引導程式碼審查和文件撰寫。本身不會執行框架工具。
哪些 AI 工具可以使用它？
報告列出對 Claude、Codex 和 Claude Code 的支援。
我應該期待什麼輸出？
你可以期待一份結構化 Markdown 文件，其中包含建模、結構描述、清單、註冊、執行和建議等章節。
它對比較框架有用嗎？
是。它定義了一致的分類，讓框架比較更容易且更可重複。
它能取代安全審查嗎？
不會。它可以揭露 sandbox 和驗證筆記，但不是完整的安全稽核。
開發者詳細資訊
作者
Dowwie授權
MIT
Skillstore 修訂
r1
版本提示
作者未聲明版本。
儲存庫
https://github.com/Dowwie/agent_framework_study/tree/main/.claude/skills/tool-interface-analysis引用
72d5025b022c77f7a51bdf5c1637c689c80e89d1
維護新鮮度
2026/7/18
使用量
4 次下載 · 328 次瀏覽
檔案結構
📄 SKILL.md