Nexus Mapper

This generates a persistent knowledge base in `.nexus-map/` that lets any AI session cold-start on an unfamiliar codebase without fumbling around. It runs a five-stage PROBE protocol using Tree-sitter AST extraction and git forensics to produce `INDEX.md`, system boundaries, dependency graphs, test coverage maps, and change hotspots. Supports 30+ languages out of the box with hooks for custom extensions. The real value is in the discipline: it forces explicit evidence tracking, blocks you from writing "maybe" without stating what evidence is missing, and ensures `implemented` nodes actually point to real code paths. Requires Python 3.10+ and shell access. If you just need ad-hoc file queries mid-session, use nexus-query instead.

skills.sh installs: 365
GitHub stars: 167
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add haaaiawd/nexus-skills --skill nexus-mapper --agent claude-code

Installs into .claude/skills of the current project.

Files

nexus-mapper — AI 项目探测协议

本 Skill 指导 AI Agent 使用 PROBE 五阶段协议，对任意本地 Git 仓库执行系统性探测，产出 .nexus-map/ 分层知识库。

何时调用 / 何时不调用

场景	调用
用户提供本地 repo 路径，希望 AI 理解其架构	是
需要生成 `.nexus-map/INDEX.md` 供后续 AI 会话冷启动	是
用户说「帮我分析项目」「建立项目知识库」「让 AI 了解这个仓库」	是
运行环境无 shell 执行能力（纯 API 调用模式，无 `run_command` 工具）	否
宿主机无本地 Python 3.10+	否
目标仓库无任何已知语言源文件（`.py/.ts/.java/.go/.rs/.cpp` 等均无）	否
用户只想查询某个特定文件/函数 → 直接用 `view_file` / `grep_search`	否

前提检查

缺失项要显式告知用户；需要降级等时及时提醒用户，经过同意才能继续。

前提	检查方式
目标路径存在	`$repo_path` 可访问
Python 3.10+	`python --version` >= 3.10
脚本依赖已安装	`python -c "import tree_sitter"` 无报错
有 shell 执行能力	Agent 环境支持 `run_command` 工具调用