SuperAPI AI 工具集

recon

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

recon 是一个代码库拓扑与架构测绘引擎(Codebase Topology & Architecture Cartography Engine),用于为指定子系统或代码范围生成结构化的架构地图。

用途 recon 的核心用途是回答“这段代码是怎么组织的、执行从哪里进入、关键路径如何流转、哪些约束不能被破坏”。它聚焦于架构转换与模块接缝,而不是罗列琐碎的叶子工具、临时测试夹具或目录清单。

主要能力

  1. 拓扑与模块接缝:识别入口点(命令、公共 API、事件消费者)、核心契约与数据模式(关键接口、数据类型、状态模式、治理规范),以及关键目录与包各自的架构职责边界。
  2. 关键执行流程:以顺序调用链追踪运行时调度,从入口一直到终态持久化,并附上精确的代码位置指针(file:///path/to/file#L<N> 形式)。若存在不同的执行路径,会补充第二条流程。
  3. 系统不变量与注意事项:记录事务边界、状态生命周期、隐藏副作用或规格漂移,并区分“必须保持”的不变量与“需要警惕”的陷阱;若没有发现问题,会明确标注为未观察到。

使用方式 该技能遵循分阶段的执行协议:

  • 第一阶段:宏锚点定位。读取目标子系统或代码库范围,使用文件与符号工具侦察高层架构锚点,如入口点、关键模式和路由边界;在深入检查前先确定锚点坐标。
  • 第二阶段:规模自适应测绘。对于 10 个文件以内或单一内聚模块的较小范围,直接在当轮追踪调用流,以减少子代理延迟与 token 开销;对于较广的代码库或跨层范围,则启动并行的 research 子代理,按分层或调用方声明的预算动态扩展(角色为 Cartography Scout (<Layer>)),每个子代理获得目标边界、已发现锚点与规范输出契约,并将大量追踪记录卸载到 .agents/scratch/recon-<layer>-dossier.md。
  • 第三阶段:综合与停止。将发现整合为规范输出契约(Codebase Cartography: <子系统/目标范围>),并附上已卸载档案的指针,然后把完成的地图呈现到对话中并立即停止。

输出形式固定为三段:拓扑与架构接缝、关键执行流程、不变量与注意事项。

路由 完成测绘后,如果调用方的变更方向已确定、执行路径与变更边界清晰,可通过 /changeset 继续;如果发现架构张力、权衡取舍或存在多条可行实现路径,则通过 /clarify 处理。

适用场景 适合在修改代码前理解子系统结构、梳理跨层调用链、评估变更影响范围,或为后续变更规划与澄清提供依据。

限制 资料未说明支持的具体编程语言、仓库规模上限、运行环境或收费方式。该技能以文档化架构地图为产出,本身不执行代码变更,变更与澄清分别交由 /changeset 与 /clarify 处理。