关于 repo-map
repo-map 是用于扫描代码仓库资产、查询关系图并检查覆盖范围与漂移的技能。它要求兼容的图运行时,并通过有范围限定且注明依据的结果生成导航视图。
主要功能
- 01有界仓库资产扫描
- 02关系图查询与覆盖检查
- 03检测冲突与快照漂移
- 04生成派生导航视图
适用场景
- 01查询组件身份、关系或消费者
- 02评估变更影响与权威来源
- 03检查图快照覆盖率和陈旧状态
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ idaibin/ skills --skill repo-map安装后在 Claude Code 中输入/repo-map确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/api-contract-map.mdchecklist.mdeval-cases.mdfrontend-inventory.mdgraph-operation-gates.mdjava-build-and-dependency-map.mdproject-grounding.mdproject-guidance.mdprompt-templates.mdreuse-index.mdusage.md详细介绍
仓库地图
入口门禁
负责有界的仓库资产扫描、图查询、覆盖率/漂移检查和派生导航视图渲染。要求使用兼容的图运行时、仓库根目录、安全范围和精确依据。运行时不可用时,绝不以手工编写的地图替代。
路由地图
| 请求条件 | 阅读 | 结果 |
|---|---|---|
| 构建/刷新明确无歧义的图快照 | 图操作门禁和用法 | 已验证的有界快照 |
| 查询标识、关系、使用者、影响、权威来源、覆盖率、冲突或漂移 | 图操作门禁和用法 | 附带依据的精简结果 |
| 根目录所有权或有界源解析存在歧义 | 歧义检查清单 | 已解析的有界根目录/源,或安全停止 |
| 需要语言/配置提取详情 | 前端清单、API 契约地图和/或 Java 构建地图 | 配置专属的图证据 |
| 跨项目/仓库信号适用 | 项目依据 | 附带限定条件的边界结果 |
| 渲染所需的导航视图 | 提示词模板 | 派生的临时视图 |
不变量
- 拒绝越界;隔离并从扫描中排除运行本地缓存。
- 图/查询未命中仅表示有界的
未找到,绝不代表不存在;过期快照仍为过期。 - 为原生权威来源编制索引,不复制或编写仓库指南、产品/设计契约、源代码、运行时事实或 Git 状态。
输出地图
返回能力/版本、依据、范围/排除项、快照/查询标识、覆盖率、未解决/冲突/过期状态,以及未验证边界;渲染结果需注明其输入。
参考地图
评论
支持 Markdown