mcpField
R
recon

recon

github.com/venhdev开发1131 次安装今天更新
代码仓库

关于 recon

recon 是用于绘制代码库架构图的技能，追踪子系统边界、执行流程和系统不变量。它会按范围调整探索方式，并生成带代码位置引用的结构化报告。

主要功能

  1. 01梳理入口与模块边界
  2. 02追踪关键执行流程
  3. 03识别不变量和副作用
  4. 04按代码库规模调整探索方式
  5. 05生成结构化架构报告

适用场景

  1. 01修改前了解子系统
  2. 02追踪跨模块的运行路径
  3. 03发现架构张力与设计备选方案

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/venhdev/skills --skill recon

安装后在 Claude Code 中输入/recon确认已加载。

详细介绍

recon — 代码库拓扑与架构制图引擎

领域评估标准

1. 制图维度
  • 拓扑与模块接缝：入口点、架构、数据模型，以及子系统之间的架构边界。
  • 关键执行流：追踪从接收请求到终态持久化的运行时分发顺序调用链，并标注精确的代码位置（file:///path/to/file#L<N>）。
  • 系统不变量与注意事项：事务边界、状态生命周期、隐藏的副作用或规范偏差。
2. 探索边界（忽略内容）
  • 严格聚焦于架构转换和模块接缝；禁止罗列琐碎的叶级实用工具、临时测试夹具，或直接倾倒原始目录列表。

规范输出契约

# Codebase Cartography: <Subsystem / Target Scope>

## 1. Topography & Architectural Seams
- **Entrypoints**: <Primary intake points, commands, public APIs, or event consumers with file pointers>
- **Core Contracts & Schemas**: <Key interfaces, data types, state schemas, or governing specifications>
- **Module Boundaries**: <Key directories/packages and their distinct architectural responsibilities>

## 2. Key Execution Flows
### Flow: <Primary Flow Name, e.g., Data Intake / Transformation / Render Pipeline>
1. `<Symbol>` ([<file>#L<N>](file:///path/to/file#L10)) ── <Trigger or input intake>
2. `<Symbol>` ([<file>#L<N>](file:///path/to/file#L50)) ── <Intermediate dispatch, orchestration, or validation>
3. `<Symbol>` ([<file>#L<N>](file:///path/to/file#L90)) ── <Core state transition, persistence, or terminal execution>
*(Add secondary flow if distinct execution path exists)*

## 3. Invariants & Gotchas
- **Invariants (Must Preserve)**: <Core rules, transaction boundaries, or state lifecycles that cannot be broken>
- **Gotchas (Watch Out)**: <Hidden side-effects, spec drift, or surprising couplings; state 'None observed' if clean>
路由
  • 调用方请求的变更方向已确定，且执行路径／变更边界明确 →（通过 /changeset）。
  • 发现架构上的矛盾、权衡或多种可行的实现路径 →（通过 /clarify）。

执行协议

阶段 1：宏观锚点定位
  1. 接收目标子系统或代码库范围。
  2. 使用文件和符号工具探查高层架构锚点（入口点、关键架构、路由器边界）。
  3. 在深入检查前，确定锚点坐标。
阶段 2：自适应规模制图
  1. 评估目标范围规模：
    • 单轮执行（少于 10 个文件或单一连贯模块）：在当前轮中直接依据已发现的锚点追踪调用流，以消除子 Agent 延迟和令牌开销。
    • 子 Agent 扇出（范围广泛的代码库或跨层范围）：启动 1–3 个 research 子 Agent（角色：Cartography Scout (<Layer>)）。为每个 Agent 提供目标边界、已发现的锚点和规范输出契约。
阶段 3：综合与轮次终止关卡（扇入）
  1. 将发现结果整合为规范输出契约。
  2. 将完整的制图结果呈现在对话流中，并立即结束当前轮次。

评论

支持 Markdown