SuperAPI AI 工具集

agent-architecture-analysis

智能体与模型

查看项目

更新于 10-16 09:54

技能介绍

用途:针对 LLM 驱动的智能体系统,按 12-Factor Agents 方法论做架构审计与合规评估,适用于评估新系统、复核智能体架构决策、审计生产级智能体应用、规划改进以及比较不同框架或实现。

主要能力:该技能以 13 个因子为框架逐一评分,涵盖自然语言到工具调用、自有提示词、自有上下文窗口、工具即结构化输出、统一执行状态、启动/暂停/恢复、以工具方式联系人类、自有控制流、把错误压缩进上下文、小而聚焦的智能体、随处触发、无状态归约器、预取上下文。每个因子的完整评分规则(原则、搜索模式、文件模式、Strong/Partial/Weak 合规标准与反模式)位于 references/factors.md。输出包括执行摘要表(按因子给出状态与关键发现,并统计 Strong/Partial/Weak 数量)和逐因子分析,逐因子给出当前实现(含 file:line 证据与代码片段)、合规等级及理由、差距与可执行改进建议(含代码示例)。

使用方式:需提供 codebase_path(必填,待分析代码库根路径),可选 docs_path(已有分析文档目录)。分析流程为:初始扫描(对全部因子跑搜索模式、定位关键文件、记录已有合规文档)→ 逐因子深读(阅读文件、按标准评估、记录证据路径)→ 差距分析(对照理想、识别反模式、按影响排序)→ 建议(可执行改进、前后代码对比、参考路线图)→ 总结(汇总表、强弱项与优先级)。

限制:存在硬性关卡——扫描关卡要求每个因子(1–13)至少有可检查的仓库相对路径或 glob 命中,或一行带理由的说明;证据关卡要求评 Strong/Partial/Weak 前“当前实现”须含至少一条 file:line 引用或明确“未找到证据”,否则默认该因子为 Weak(除非明确不适用并说明原因);综合关卡要求前两关满足后才能输出摘要表与逐因子分析,建议只能作为提案,不得当作已观察事实。评分含义:Strong 为完整实现(维持并微优化),Partial 为部分实现且有明显差距(规划改进),Weak 为极少或未实现(优先纳入路线图)。未提供具体安装命令或平台限制等信息。