SuperAPI AI 工具集

agent-review

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:审查 AI 智能体(agent)实现是否符合架构最佳实践,目标为项目或代码库路径($ARGUMENTS)。适用场景包括审计已有智能体实现、设计新智能体架构、审查代码的生产就绪度、评估多智能体系统设计,以及评估可靠性与可观测性。

审查流程:发现(探索目标路径的目录结构)→ 分析(对照架构模式检查)→ 评估(逐类评分)→ 报告(输出发现与建议)。

主要能力与检查维度:

  1. 目录结构:要求智能体定义、工具、记忆/状态、提示词、编排、数据模型、工具函数、配置、测试、脚本分离,提示词建议外置,测试必备,关注职责清晰分隔。
  2. 设计模式:工具需有明确输入输出模式、结构化错误返回、无状态、配置超时并校验输入;智能体循环需有清晰 think→act→observe 周期、最大迭代限制、优雅终止、状态保留与中断能力;记忆管理含会话历史长度限制、长对话摘要、明确生命周期、长期持久化与向量检索(如 RAG);错误处理要求结构化错误类型、指数退避重试、优雅降级、保留调试上下文;状态管理要求不可变更新、模式校验、序列化、清晰状态转换与版本化;多智能体协作需明确角色、消息协议、冲突解决与编排模式(主管、流水线、辩论、群体、层级);提示词管理要求外置、版本化、模板变量与测试;可观测性要求结构化 JSON 日志、请求追踪、token 用量、延迟与错误率指标。
  3. 配置最佳实践:需包含模型、最大迭代、总超时、工具超时、最大 token、温度、重试次数;层级为环境变量 → 配置文件 → 代码默认值。
  4. 测试模式:单元、集成、快照、评估测试,必测工具输入校验与错误处理、终止条件、状态转换、提示词渲染与配置加载。

输出格式:生成摘要、各维度 1-5 分评分表、严重问题清单、按优先级排列的建议与优点。同时标记常见反模式:上帝智能体、无限循环、静默失败、硬编码提示词、无可观测性、可变状态、无超时、缺少校验。

限制:资料未提供安装方式、收费模式、平台支持与具体版本要求,暂未提供;该技能以审查指南形式给出,未说明可执行的命令与自动化集成方式。