Community编程与开发github.com

代码库地图

解释仓库中行为的分布位置,创建或刷新基于证据的架构地图,或在 Mermaid 或 draw.io 中绘制真实的组件关系图。适用于仓库导航和架构图。

代码库地图 是什么?

此技能(Codebase Map)帮助开发者快速定位用户任务所需的代码,并记录有助于仓库导航的有用信息。它区分了源代码证据、声明的配置和观察到的运行时行为,提供三种主要产出:快速定位、持久化地图和架构可视化。该技能支持通过 `orient` 和 `diagram` 参考文档创建或刷新地图和图表,并提倡并行发现策略,将大型仓库分解为独立的有限区域进行只读扫描,由父进程负责索引和跨区域连接。最终交付物必须包含严格的证据验证,仅报告实际检查的内容,并明确标识不确定性,确保所有链接和图表语法都经过验证。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/codebase-map

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

代码库地图 是做什么的?

定位用户任务所需的代码,并在需要时保留有用的导航信息。区分源代码证据、声明的配置和观察到的运行时行为。

根据要求的交付物进行路由

  • X 在哪里 / 快速导航: 读取相关的现有地图,并根据检出版本验证其路径。用简短流程和入口点链接回答;无需编写文档。
  • 创建 / 刷新持久化地图: 使用 orient。保留现有文档布局和本地说明。
  • 架构可视化: 使用 diagram。无需先生成文档套件,即可通过聚焦的源代码遍历来绘制图表。

并行发现

对于大型仓库,将独立的有限区域委派出去(例如 API/认证、工作进程/数据、UI/导航)。每个侦察任务都是只读的,并返回真实的路径/符号、入口点、依赖关系(附证据)、不确定性以及检出的确切版本。不要要求每个侦察任务扫描整个树。

父进程拥有索引、共享文档和跨区域连接。在写入之前,验证边界声明、去重并协调不一致的名称。如果代理不可用或范围较小,则顺序执行相同的聚焦发现。委派只有在能节省工作量时才有用;切勿为每个文件创建一个代理。

证据与完成

包的存在并不证明它在生产环境中运行;导入并不证明存在网络部署。记录已检查的内容和仍然未知的内容。使用可用工具验证所有交付的本地链接和图表源语法。报告实际验证结果和最佳起始文件,而不是整个仓库列表。

回答的语气

直击重点。没有阶段性的开场白,没有“不是 X 而是 Y”,没有聊天残留,没有重要性填充。短句与长句交替出现。事实和限定词应与证据保持同等强度。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能