Agent Tool Builder 用于帮助开发者按 fail-closed 设计模式定义智能体工具：将身份、参数 schema、安全属性与执行逻辑放在同一个类里，使新工具默认更安全。它强调三点：其一，is_read_only、is_destructive、is_concurrency_safe 默认均为 False，未声明属性的工具会被保守地视为可写；其二，执行分层为 validate_semantics、check_permissions、_call，避免校验、权限与业务逻辑互相混淆；其三，schema、描述、安全元数据与执行逻辑集中一处，无需额外中间件。
使用流程：先确认目标框架（如 hermes-agent、LangChain 或纯 Python）及注册方式，并检查项目 utils/tools 下是否存在 agent_tool_base.py，缺失时从技能目录 references/agent_tool_base.py 复制并告知位置。随后向用户收集工具名（建议 {service}{action}{resource} 格式）、面向 LLM 的精确描述、参数字段、三项安全属性、返回格式、是否列表工具与分页、语义校验、权限检查及核心执行逻辑等信息，可按上下文推断默认值。生成 .py 工具文件时按导入、Pydantic 输入 schema、工具类的顺序组织。最后输出一行安全属性摘要。
输出设计上建议一工具一职责；需要程序化处理用 JSON，展示给用户用 Markdown，不确定时可同时支持；超过约 50 条记录的列表工具应支持分页；错误信息应可操作，给出具体修复建议。资料未提供具体免费或收费、价格与平台兼容性信息。