技能 tool-interface-analysis

📦

tool-interface-analysis

Name: tool-interface-analysis
Author: Dowwie

内容修订 r1 安全 ⚡ 包含脚本⚙️ 外部命令🔑 环境变量

分析智能体工具接口

智能体框架通常会隐藏工具如何被注册、验证和重试。此技能指导对工具抽象、schema、内置工具和错误反馈进行结构化审查。

支持: Claude Codex Code(CC)

🥉 77 青铜

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 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、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/dowwie-tool-interface-analysis.md 已签名 manifest GET /api/skills/dowwie-tool-interface-analysis/manifest 已签名 lockfile GET /api/skills/dowwie-tool-interface-analysis/lockfile

测试它

正在使用“tool-interface-analysis”。分析一个使用 Pydantic 模型作为工具参数并使用中央注册表的框架。

预期结果:

一份 Markdown 报告，描述核心工具抽象、schema 生成路径、注册表流程、验证行为，以及对新设计的影响。

正在使用“tool-interface-analysis”。比较两个具有不同错误反馈机制的框架。

预期结果:

对反馈质量和重试支持的并排摘要。
关于验证错误在哪里传递给模型的具体说明。
针对更清晰的纠错提示和结构化错误对象的建议。

正在使用“tool-interface-analysis”。审查智能体框架仓库中的内置工具。

预期结果:

一份工具类别、工具位置、schema 方法、沙箱说明和重要实现权衡的清单。

安全审计

安全

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.

已扫描文件

786

分析行数

复核项

已忽略误报

风险因素

⚡ 包含脚本 (1)

SKILL.md:293

⚙️ 外部命令 (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

🔑 环境变量 (7)

SKILL.md:331 SKILL.md:342 SKILL.md:343 SKILL.md:347 SKILL.md:348 SKILL.md:349 SKILL.md:353

最新一次完成的静态与语义审计未检测到已确认的安全发现。这并不能证明该 Skill 没有副作用。

审计者: codex 查看审计历史 →

分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告

复制报告链接

https://skillstore.io/skills/dowwie-tool-interface-analysis/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/dowwie-tool-interface-analysis/security.svg)](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/8

BibTeX 引用

@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 评分

评分依据证据置信度: 高

架构

可维护性

内容

社区

规范符合性

你能构建什么

审查新的智能体框架

识别框架如何定义工具、验证参数，并将工具暴露给模型。

比较工具调用设计

在为新实现选择模式之前，跨框架构建一致的笔记。

改进重试和错误反馈

追踪失败如何返回给模型，以及哪些地方可以加强自我纠错。

试试这些提示

梳理工具基础

使用 tool-interface-analysis 分析此框架。从工具建模、schema 生成、注册、执行和错误反馈开始。

比较 schema 方法

使用 tool-interface-analysis 比较此框架如何生成工具 schema。结合文件引用记录内省、Pydantic、装饰器和手动模式。

审计重试行为

使用 tool-interface-analysis 追踪此代码库中的验证失败、执行错误、重试规则和 LLM 自我纠错反馈。

创建架构建议

使用 tool-interface-analysis 分析这些框架，并为新的智能体工具层生成建议，包括权衡和反模式。

最佳实践

从定义基础工具、schema、注册表、执行器和验证的框架文件开始。
在输出文档中为每项主张记录文件和行号引用。
将接口设计发现与提供商协议发现分开。

避免

不要在未检查实现代码的情况下，从示例推断 schema 行为。
不要将工具接口分析与无关的提供商消息格式分析混在一起。
在追踪执行路径之前，不要将缺失的重试行为视为已确认。

常见问题

此技能分析什么？

它分析智能体框架中的工具建模、schema 生成、注册、执行、验证、错误反馈和重试模式。

它会运行工具或修改目标框架吗？

不会。它指导代码审查和文档编写，不会自行执行框架工具。

哪些 AI 工具可以使用它？

报告列出了对 Claude、Codex 和 Claude Code 的支持。

我应该期待什么输出？

可以预期得到一份结构化 Markdown 文档，其中包含建模、schema、清单、注册、执行和建议等部分。

它对比较框架有用吗？

是的。它定义了一致的类别，使框架比较更容易且更可重复。

它能替代安全审查吗？

不能。它可以呈现沙箱和验证说明，但并不是完整的安全审计。

开发者详情

作者

Dowwie

许可证

MIT

Skillstore 修订

版本提示

作者未声明版本。

仓库

https://github.com/Dowwie/agent_framework_study/tree/main/.claude/skills/tool-interface-analysis

引用

72d5025b022c77f7a51bdf5c1637c689c80e89d1

维护新鲜度

2026/7/21

使用量

5 次下载 · 328 次浏览

文件结构

使用 TRACE 工作流调试错误

由 AutumnsGrove

当团队追逐症状而不是原因时，错误会浪费大量时间。此技能会引导 Claude、Codex 和 Claude Code 进行结构化的 TRACE 调试。

编码与开发查看

tool-interface-analysis

使用我的智能体安装

Agent 可读资源

测试它

安全审计

风险因素

复制报告链接

Markdown 徽章

HTML 徽章

嵌入卡片

APA 引用

BibTeX 引用

CITATION.cff

Skillstore 评分

你能构建什么

审查新的智能体框架

比较工具调用设计

改进重试和错误反馈

试试这些提示

最佳实践

避免

常见问题

开发者详情

Dowwie 的更多技能

resilience-analysis

control-loop-extraction

multi-agent-analysis

memory-orchestration

execution-engine-analysis

component-model-analysis

相关技能

analyzing-patterns

error-handler-advisor

global-error-handling

error-handling-fundamentals

react-ui-patterns

error-detective