SuperAPI AI 工具集

understand

编程与开发

查看项目

更新于 10-18 04:32

技能介绍

用途 understand 用于帮助用户系统性地理解代码库中某个功能、函数、组件或系统区域是如何工作的。适用触发场景包括用户输入“/understand”、“how does X work”等。

主要能力 该技能采用多智能体协作分析:先分析目标范围,并行启动 4-7 个专职子代理,并根据目标类型跳过不相关的角色。专职角色包括:代码结构分析师(定义、文件位置、依赖、导入、模块关系,始终启用)、数据流分析师(输入输出、转换、状态管理、副作用,始终启用)、使用模式分析师(使用位置、调用方式、集成点、配置,始终启用)、UX/UI 分析师(组件、模板、样式、交互、无障碍,适用于 UI 组件、页面、前端功能)、数据库分析师(模式、查询、约束、索引、关系,适用于数据模型、持久化、迁移)、API 分析师(端点、请求/响应模式、GraphQL、外部服务,适用于 API 路由、服务集成)、测试覆盖分析师(测试文件、覆盖率、场景、边界情况、测试策略,始终启用),以及在 Codex 可用时加入 Codex Fresh Eyes(高层目的、设计决策、架构选择)。

在收集各专职报告后进行第二阶段的交叉传播与整合:连接跨角色的发现、识别交互模式、跨领域验证结论、找出未被覆盖的空白区域、解决矛盾。Codex 可用时还会运行 Codex 整合综合。

第三阶段输出结构化理解报告,包含:范围与专职列表、各专职分析(附 file:line 引用)、Codex Fresh Eyes 独立视角、交叉验证;随后是综合理解部分,涵盖概述、位置与结构、工作原理(入口、关键逻辑、输出与副作用)、依赖(内部/外部)、使用示例、UI/UX 集成、数据库集成、API 集成、测试、注意事项(性能、安全、限制)。

使用方式 调用形式为 /understand [要分析的功能/函数/组件]。参数可以是功能名、函数、组件、模块或系统区域,例如“authentication system”、“User model”、“PDF generation”。

运行时兼容:在 Claude Code 中使用 Task/Agent 启动子代理,Codex Fresh Eyes 在可用时通过 mcp__codex__codex;在 OpenCode 中使用 Task 工具启动子代理,Codex Fresh Eyes 在可用时通过 codex_codex;在 Codex 中可用时生成自定义代理,否则直接运行提示词,Fresh Eyes 可用时使用独立 Codex 会话。

搜索策略上,各专职使用 Grep 查找定义与用法、Glob 按模式定位文件、Read 读取关键实现文件,并在可用时使用运行时相关 MCP 工具(如 Elixir/Ecto 的 Tidewave、数据库的 psql)。

适用场景 适合需要全面理解某个功能或系统区域、需要跨结构/数据/使用/测试多角度梳理、或希望获得独立“新手视角”解释的开发者。

限制与规则 每条发现必须包含 file:line 引用;聚焦理解而非评价,描述存在什么、如何工作;跳过与目标无关的专职;运行时支持时并行启动;Codex Fresh Eyes 仅在 Codex 可用时包含;不修改任何文件,为只读分析。