SuperAPI AI 工具集

explain

智能体与模型

查看项目

更新于 10-16 01:35

技能介绍

用途:对代码、文件、目录或架构概念给出深入解释,自动路由到最相关的专家代理,并用现代 CLI 工具做分析。

主要能力:支持目标类型识别(文件、目录、函数/类符号、概念);并行收集上下文(查找用法、评估规模、查找测试/类型/文档、读取 AGENTS.md 与 CLAUDE.md 约定);按扩展名路由专家代理(.ts→typescript-expert、.tsx→react-expert、.py→python-expert、.vue→vue-expert、.sql/迁移→postgres-expert、agents/skills/commands→claude-architect,默认 general-purpose);生成结构化 Markdown 说明,含 Mermaid 流程图/时序图/类图、file:line 引用、设计决策与理由;可提议保存到 ARCHITECTURE.md。

用法:/explain <target> [--depth] [--focus]。深度模式:--shallow(概述段落与关键导出,无图)、--normal(默认,完整说明加一张图)、--deep(详尽内部、边界情况、多图)、--trace(跨系统数据流追踪)。聚焦模式:--focus arch(模块边界与依赖)、flow(数据与控制流)、deps(导入与外部依赖)、api(公共接口与契约)、perf(复杂度与瓶颈)。示例:/explain src/auth/oauth.ts、/explain validateToken、/explain src/services/、/explain src/core/engine.ts --deep --focus arch、/explain handleUserLogin --trace。

工具集成:tokei(代码统计,缺失则跳过)、ast-grep(结构化搜索,回退 rg)、bat(语法高亮,回退 Read)、rg(内容搜索,回退 Grep)、fd(查找文件,回退 Glob)。

限制:解释基于代码分析而非文档;复杂系统可能需要多次调用;Mermaid 图需支持渲染的查看器;专家代理提供框架特定见解。具体收费、价格与平台信息暂未提供。