用途
自主式 AI 智能体工具路由（Autonomous AI Agent Tool Routing）用于为自主 AI 编码智能体所消费的外部工具，协调发现、运行时执行边界与容错重试策略。它为分布式的工程与去中心化应用系统提供一套标准化、可审计的框架与数据模型。
主要能力
该技能围绕「工具路由注册表」提供字段级定义与产物导出能力，核心字段包括：
- 工具定义 ID（id，SERIAL PRIMARY KEY / integer / Text，示例 TOOL-001）
- 工具规范名称（text，VARCHAR(64)，示例 stellar_ledger_query）
- 目标协议 / 服务器（text，VARCHAR(64)，示例 Stellar Horizon RPC）
- 调用模式（select，同步 | 异步后台 | 定时 Cron）
- 幂等性强制（select，是 | 否）
- 参数强制转换策略（select，严格 Pydantic V2 | JSON Schema Draft 7 | 宽松回退）
- 每分钟速率限制请求数（number，INTEGER，示例 120）
- 重试退避策略（select，带抖动的指数退避 | 线性步进 | 立即回退）
- 超时阈值毫秒（number，INTEGER，示例 5000）
- 路由注册状态（select，草稿 | 活跃已验证 | 已弃用 | 已阻止）
- 最后验证日期（date，示例 2026-10-01）
此外还定义了关系字段：审计参考（链接到正式评审文档或测试仓库）、目标架构（链接到已部署合约或自主智能体运行时组件）。
使用方式
官方描述的工作流为：定义标准 → 运行自动化验证 → 记录基线 → 监控不变量。
具体步骤：
- 定义目标操作注册表所需的参数、阈值与身份绑定。
- 从经验证的枚举选择集中选取合适的边界强制值。
- 导出标准化产物（CSV 表格、SQL DDL、JSON Schema），以集成到验证 CI 流水线中。
推荐下一步：生成统一字段 schema、SQL DDL 迁移与 JSON 验证 schema，并注册到系统目录中。
适用场景
- 需要为工具路由形式化架构契约、安全不变量或运行限制时。
- 需要在协议开发者、智能合约审计人员与 AI 工程智能体之间进行跨职能评审时。
- 需要生成可复现的 CSV、SQL DDL、JSON Schema 与 Notion 属性注册表以跟踪合规性时。
最佳实践
- 对数值边界与货币金额强制严格类型；避免在关键状态中使用非结构化自由文本字段。
- 在每一次改变状态的提交或参数变更时，重新运行验证测试套件。
- 保持示例数据为合成数据，并与生产加密密钥或私有端点隔离。
限制
- 提供架构规范、数据模型与验证 schema；未经授权的外部工具，不执行直接交易签名。
- 查询链上状态时需要网络连接与有效的 RPC 凭据。
安全与安全说明
- 所有参数声明风险等级为：安全。不执行未经授权的状态修改或特权凭据访问。
- 在测试套件与本地验证脚本中使用合成虚拟密钥与模拟地址。
常见陷阱
- 问题：合约运行时与数据库注册表之间的小数精度不匹配。解决：始终使用本参考中的显式字段映射验证小数。
- 问题：状态更新前缺少授权检查。解决：部署前对照安全审计注册表进行交叉验证。
相关技能
- @ai-prompt-regression-testing：覆盖提示回归基线与漂移。
- @web3-rate-limiting-circuit-breaker：提供运行护栏与阈值断路器。
- @cross-chain-relayer-audit：覆盖消息哈希、nonce 与法定人数证明。