SuperAPI AI 工具集

explore

编程与开发

查看项目

更新于 10-16 00:23

技能介绍

Explore 是 /research 的本地对应技能:/explore 关注代码“是什么”,/research 关注“应该是什么”,两者配合使用。其目标是在任何改动前获得最大化的本地知识,避免错误假设、漏掉既有模式、违反约定和返工。

主要能力分为六个探索维度:代码库阅读(读取目标文件、相邻代码、既有模式、项目 CLAUDE.md 约定,必要时把参考实现当作规范);git 历史(用 git log --oneline -20 <path>、git log --oneline --all --since="2 weeks ago"、git diff HEAD~5 -- <path>、git blame <file> 等查看变更频率与上下文);项目结构(目录布局、导入依赖图、解决方案/工作区成员、分层边界与规划方向);测试发现(定位测试工程、同置测试、跨领域测试、命名与断言模式、覆盖缺口);配置与构建状态(构建/包配置、.editorconfig 与 lint 配置、包版本、CI/CD 工作流);环境与机器状态(已安装版本、MCP 服务器状态、worktree 状态、项目本地配置是否存在)。

使用方式:默认从主对话派发 discovery:explorer 子代理,由它加载路径范围内的规则、执行六个维度、写入产物并返回简短摘要与文件指针,父级负责先解析调度信封(范围、memory 切片路径、预算、能力标志),调度后再把 open_questions 呈现给用户、派发同级校验并写回结论。以下情况改为内联运行:紧密的逐轮迭代(约 5 个已知文件且结果会立即用于同会话编辑)、成本考虑(派发会完整跑六维)、调用上下文本身已是子代理。另有内置 Explore 子代理,适合“X 在哪 / Y 如何工作”的原始搜索,但跳过项目记忆、不运行六维流程、不写 EXPLORE.md。

范围通过 $ARGUMENTS 给出(如模块、deps、tests、git、config、文件路径),可组合多个参数。输出格式包括:摘要、当前状态、既有模式、测试覆盖、约束、与规划方向的一致性、开放问题(每个附一行推荐默认值与备选方案)。最终把结果写入 <memory_dir>/<slug>/EXPLORE.md,它是索引文件,正文内容放在同目录的 EXPLORE-<section>.md 副文件中,并带 YAML 头。

限制:派发运行不读取 $ARGUMENTS,范围必须由调度提示给出,缺失属于父级信封失败;派发运行无法进入计划模式的只读保护;非 fork 子代理看不到对话上下文;发现被 git 引用的缺失文件时不应擅自做 git 考古,需作为 open_questions 返回;产物中的路径须为相对路径,不能回显机器绝对路径;若该切片已有无关 EXPLORE.md,不得覆盖或改名,而应写入 <memory_dir>/<slug>/<scope-slug>/ 并报告路径。关于收费与价格信息,资料中暂未提供。