extract
从AST提取和AI增强构建代码知识库
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：extract。 它的用途是：从AST提取和AI增强构建代码知识库 完整的 Skill 内容见：https://321skill.com/skills/extract-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 extract 技能分析当前项目的 src 目录，生成知识库文件'，它会解析所有源文件的 AST，提取类、函数、接口等结构，并调用 AI 进行语义标注，最终输出一份 Markdown 文档，包含模块关系图、函数调用链和关键逻辑说明。
介绍
在大型代码库中，理解项目结构、快速定位关键逻辑和维护知识库往往耗费大量精力。extract 通过解析源代码的抽象语法树（AST），并结合 AI 进行语义理解，自动将代码中的类、函数、接口、依赖关系等结构信息转化为结构化的知识库，帮助团队降低认知负担，提升代码维护效率。
使用时，只需将项目路径或代码文件传递给 extract，它会自动遍历源文件，提取 AST 结构，然后调用 AI 模型对提取的节点进行语义标注、生成摘要和关联关系，最终输出一份可检索的知识库（如 Markdown 文档或 JSON 文件）。整个过程无需手动编写文档，也无需额外配置。
适合后端开发、全栈工程师、数据分析师以及需要频繁阅读和维护遗留代码的开发者。尤其适用于中大型项目或多人协作场景，新人上手、代码审查、重构评估等环节都能受益。
建议在项目初始化或里程碑节点运行一次，保持知识库与代码同步。注意，extract 依赖 AI 模型进行语义增强，需要确保网络连通且 API 密钥已配置；对于非代码类文档或纯配置文件，效果可能有限。
核心特点
相比纯 AI 分析（容易遗漏结构细节）或纯 AST 工具（缺乏语义），extract 将 AST 的精确结构解析与 AI 的语义理解相结合，生成的知识库既有代码实体关系图，又有自然语言描述，更适合团队协作场景。
注意事项
不适合非代码领域的知识库构建，且对极低代码或无结构化语法的文件（如纯配置文件）效果不佳。
常见问题
支持哪些编程语言？
目前主要支持 JavaScript/TypeScript、Python、Java、Go 等常见语言，具体支持列表请参考仓库 README。
需要配置 AI 模型 API 密钥吗？
是的，extract 依赖 AI 模型进行语义增强，需要提供有效的 API 密钥（如 OpenAI 或 Anthropic 的密钥），并在配置文件中设置。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/extract-x/raw/index.md 读取 extract 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/extract-x/raw/index.md（查看排版版本）