nexus-skills

为代码仓库建立持久知识图谱,并提供精准结构查询的AI技能。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:nexus-skills。
它的用途是:为代码仓库建立持久知识图谱,并提供精准结构查询的AI技能。
完整的 Skill 内容见:https://321skill.com/skills/nexus-skills/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请使用 nexus-mapper 分析当前项目,并生成知识库。” 它会运行脚本,深度扫描代码,输出包含架构图、依赖关系和概念模型的 `.nexus-map` 文件夹。之后,你可以问:“使用 nexus-query 查一下,如果修改 `src/core/vision.py` 文件,会影响哪些其他模块?” 它会基于知识库,快速列出所有上游依赖和下游调用方。

介绍

nexus-skills 旨在解决AI智能体在每次会话中都需要重新理解陌生代码库的低效问题。它通过两个核心技能,帮助开发者快速掌握项目架构并精准定位代码元素。

nexus-mapper 技能会深度分析整个代码仓库,生成一个名为 .nexus-map/ 的持久化知识库文件夹。这个知识库包含了架构概览、系统依赖、概念模型等结构化信息,为后续的AI会话提供了坚实、可复用的起点,避免了每次都从零开始。

nexus-query 技能则允许开发者在日常工作中,基于知识库或实时生成的AST数据,快速查询文件结构、反向依赖、变更影响范围等具体问题,无需通读所有代码,极大提升了开发效率。

该技能非常适合需要快速上手新项目、进行大规模重构或维护复杂遗留系统的开发者。建议在项目启动或架构调整前先运行 nexus-mapper 建立知识库,并在日常开发中使用 nexus-query 进行精准导航。

核心特点

与普通的代码总结工具不同,它通过一个严谨的“探测-挑战”工作流来构建知识库,减少AI的“第一印象偏见”;同时,它将“建立持久知识库”与“即时结构查询”分离,既保证了知识的可复用性,又提供了开发时的即时响应能力。

注意事项

不适合用于分析非代码项目(如图片库、纯文档项目)或对代码结构没有查询需求的简单任务。

常见问题

nexus-mapper 和 nexus-query 必须一起用吗?

不是必须的。nexus-mapper 生成的知识库可以被 nexus-query 复用,但 nexus-query 也可以独立运行,即时分析代码库并回答查询。

它能处理多大的代码库?

它支持通过 `--exclude-dirs` 和 `--use-gitignore` 参数过滤无关目录(如第三方库、构建产物),因此能有效处理中大型项目,聚焦核心代码。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/nexus-skills/raw/index.md 读取 nexus-skills 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。