SuperAPI AI 工具集

dev-explore

办公与效率

查看项目

更新于 10-15 21:37

技能介绍

用途:dev-explore 用于代码库探索,回答“代码在哪里、如何运作”。触发场景包括用户要求探索代码库、映射架构、查找相似功能,或处于 /dev 工作流的第二阶段。前置条件是 .planning/SPEC.md 已存在且含草稿需求。

主要能力:并行启动 3-5 个后台 Explore 子代理,分别聚焦相似功能、架构分层、测试基础设施等;使用 ast-grep(sg)做语义搜索、ripgrep-all(rga)搜索非代码文件;追踪执行路径、识别模式与约定、映射模块依赖;汇总去重后形成 10-15 个关键文件清单,主对话必须逐一阅读这些文件。

使用方式:在一条消息中并行发起多个 Task,设置 run_in_background=true;用 /tasks 查看状态,用 TaskOutput 收集结果。探索完成后将发现写入 .planning/SPEC.md 或 .planning/EXPLORATION.md,随后立即调用 dev-clarify,不等待用户确认。

测试与代码路径门禁:必须发现测试框架、测试命令和至少一个现有测试文件,否则视为阻塞,需询问用户是否将测试基础设施作为 Task 0;必须记录协议/传输、用户入口、数据流和 UI 组件,否则会写出假测试。上下文低于 35% 时需先调用 dev-handoff。

限制:该技能只做探索,不提问、不设计、不写实现任务、不做架构决策;不返回关键文件清单或跳过阅读关键文件均不可接受。资料未提供具体收费、平台支持范围或效果数据。