graph-search
FTS5全文搜索代码知识图谱中的函数、类或类型
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：graph-search。 它的用途是：FTS5全文搜索代码知识图谱中的函数、类或类型 完整的 Skill 内容见：https://321skill.com/skills/graph-search/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'搜索UserService类，并显示前5个结果'，它会自动运行graph_query.py脚本，返回匹配的类名、文件路径和行号。你也可以说：'查找get_users函数，只显示函数类型的结果'，它会添加--kind Function参数过滤。
介绍
这个Skill解决了在大型代码库中快速定位函数、类或类型定义的问题。当代码规模膨胀到数千个文件时，传统grep或IDE搜索往往返回大量无关结果，而基于知识图谱的搜索能精准匹配实体名称和限定路径。它利用FTS5全文索引，让开发者无需手动浏览目录结构即可找到目标代码。
使用方式很简单，你只需要确保已通过graph-build技能构建好.gauntlet/graph.db知识图谱。之后就可以通过自然语言指令来搜索，例如“查找UserService类”或“搜索get_users函数”。Skill会自动检测查询模式：PascalCase会优先匹配类和类型，snake_case优先匹配函数，带点号的路径则优先匹配限定名。结果会展示限定名、文件路径、行号和相关性分数，并支持按种类过滤（Function/Class）。
它非常适合需要频繁在大型代码库中导航的团队或个人，尤其是那些已经使用Claude Code并建立了代码知识图谱的开发者。对于微服务架构、多模块项目或遗留系统，这个Skill能显著减少“找代码”的时间，让开发者更专注于理解逻辑而非搜索文件。
建议在每次代码变更后重新构建知识图谱以保持索引新鲜。需要注意的是，它主要依赖FTS5全文搜索，搜索范围仅限于已索引的代码实体，对于未纳入图谱的临时文件或外部依赖无法检索。首次使用前务必运行graph-build技能创建数据库。
常见问题
搜索时没有返回结果怎么办？
请先运行graph-build技能构建知识图谱，确保.gauntlet/graph.db文件存在。如果图谱已存在，检查搜索词是否拼写正确，或尝试使用更宽泛的关键词。
能否搜索接口或枚举类型？
目前支持搜索Function、Class和Type三类实体。对于接口或枚举，如果它们在知识图谱中被归类为Type，则可以被搜索到。具体支持范围取决于graph-build的索引规则。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graph-search/raw/index.md 读取 graph-search 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graph-search/raw/index.md（查看排版版本）