project-understanding
为AI编码智能体提供代码库全局架构分析与导航的专用工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：project-understanding。 它的用途是：为AI编码智能体提供代码库全局架构分析与导航的专用工具 完整的 Skill 内容见：https://321skill.com/skills/project-understanding/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我理解这个仓库的总体架构’，它会调用该技能生成一份代码库地图，展示主要模块、文件和依赖关系。接着说：‘详细分析src/utils/logger.js这个文件’，它会聚焦到该文件，提供其功能摘要、关键函数和外部调用关系。
介绍
Project Understanding Skill 旨在解决AI智能体在理解和导航大型、陌生代码库时面临的效率与Token消耗问题。传统方式需要智能体逐一读取文件，既耗时又浪费Token。该技能通过构建增量索引和依赖关系图，为智能体提供按需、预算可控的代码库视图，使其能快速把握整体结构，并深入分析具体组件。
使用时，智能体可通过简单的命令激活该技能，例如请求生成代码库地图、聚焦分析特定文件或符号、评估代码变更的影响范围等。它利用Tree-sitter进行高效解析，自动管理索引，并提供多种视角的代码摘要。
该技能非常适合需要快速介入现有项目、进行代码审查、重构或添加新功能的AI编码助手。无论是处理开源项目还是企业内部代码，都能显著提升智能体的代码理解速度和决策准确性。
建议在项目根目录初始化索引以获得最佳效果。对于首次使用或大型代码库，索引构建可能需要一些时间，但后续的查询和分析将非常迅速。注意确保Python环境版本符合要求。
核心特点
与同类代码分析工具相比，它专为LLM智能体设计，提供Token预算控制的按需视图，并集成了增量索引和依赖影响分析，使智能体无需通读全部代码即可进行精准的架构理解和变更评估。
注意事项
不适合用于分析非代码文件（如图片、二进制文件）或语法不受支持的编程语言项目。
常见问题
如何为我的代码库建立索引？
在项目根目录运行 `project-understanding index` 命令即可。
这个技能支持哪些编程语言？
支持主流语言如Python、JavaScript、Java等，具体依赖Tree-sitter的语法解析器。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/project-understanding/raw/index.md 读取 project-understanding 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/project-understanding/raw/index.md（查看排版版本）