mcpField
R
recon

recon

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

关于 recon

recon 是用于探索代码库的技能，可梳理架构、模块边界和关键执行流程。它会根据范围调整调查方式，并报告系统不变量及代码位置，而非罗列琐碎工具函数。

主要功能

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

适用场景

  1. 01了解陌生子系统的架构
  2. 02追踪请求从入口到持久化的流程
  3. 03规划变更前定位模块边界
  4. 04调查状态生命周期和副作用

安装

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

$npx skills add https://github.com/venhdev/zenforge --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 扇出（大型代码库或跨层范围）：动态启动并发的 research 子 Agent，按分层或调用方声明的预算划分任务（角色：制图勘察员（<Layer>））。向每个子 Agent 提供目标边界、已发现的锚点和标准输出规范（将详尽的追踪结果转存至 .agents/scratch/recon-<layer>-dossier.md）。
阶段 3：综合与轮次终止关卡（汇总）
  1. 将发现结果与标准输出规范整合，并附上任何转存档案的指针。
  2. 将完成的架构制图呈现在对话流中，并立即结束本轮。

评论

支持 Markdown