AgentSkillsDir 首页
提交
graphify 项目配图
Claude 技能

面向编程智能体的 Graphify Skill · Graphify Labs

Graphify 来自 Graphify Labs（Graphify-Labs/graphify，Apache-2.0），是一个智能体技能加本地命令行工具，把代码、文档、PDF 和图片所在的文件夹转成可查询的知识图谱。在编程智能体中输入 /graphify（Codex 为 $graphify）即可使用。它不是通用的画图或白板应用。

本页是附来源链接的目录条目，不是 Graphify Labs 官方网站，也不是托管的知识图谱服务。AgentSkillsDir 不会替你生成图谱，也不销售 Graphify Cloud。

两条命令完成安装

uv tool install graphifyy
graphify install
  • graphifyy — 官方 PyPI 包，双 y
  • pip install graphify — 另一个无关的包
Codex、Cursor 或 Gemini？

然后在 Claude Code 中输入 /graphify .。以上为上游 README 命令，AgentSkillsDir 尚未亲自运行。

它是什么，不是什么

Graphify 读取项目文件夹，写出其中概念及其关联的图谱：覆盖约 40 种语言的调用、导入和继承关系，并关联到文档、PDF 和媒体文件。之后智能体查询这张图谱，而不必重读文件。它是在本地运行的开发者工具，不是图表编辑器、笔记应用，也不是托管的分析产品。

包名：graphifyy，不是 graphify

上游 README 将此标为重要提示：官方 PyPI 包是 graphifyy，结尾有两个 y。PyPI 上其他 graphify* 包与其无关。只有包名不同，安装后运行的命令仍是 graphify。

错误： pip install graphify · 正确： pip install graphifyy

安装命令行工具

以下命令依据提交 a0946f962af3 的上游 README（2026 年 10 月 31 日抓取）。AgentSkillsDir 尚未亲自运行：每个平台的命令都是上游文档内容，待我们实测。

需要 Python 3.10 或更新版本，以及 uv（推荐）或 pipx。任选一种安装方式：

uv tool install graphifyy   # recommended
pipx install graphifyy      # alternative
pip install graphifyy       # may need PATH setup

如果 uv tool install 之后找不到 graphify，README 建议运行 uv tool update-shell。Windows 上请先用 winget install astral-sh.uv 安装 uv。

在助手中注册技能

graphify install 单独运行时默认面向 Claude Code。其他助手请使用对应命令。以下摘自 README 的平台表：

  • Claude Code (macOS / Linux)

    之后输入 /graphify .
    graphify install

  • Claude Code (Windows)

    之后输入 /graphify .
    graphify install --platform windows

    直接运行 graphify install 会自动识别 Windows；加参数则强制指定。请先用 winget install astral-sh.uv 安装 uv。

  • Codex

    之后输入 $graphify .
    graphify install --platform codex

    Codex 使用 $graphify 而不是 /graphify。README 要求在 ~/.codex/config.toml 的 [features] 下设置 multi_agent = true，以启用并行提取。

  • Cursor

    之后输入 /graphify .
    graphify cursor install

  • Gemini CLI

    之后输入 /graphify .
    graphify install --platform gemini

  • Agent Skills (.agents/skills)

    之后输入 /graphify .
    graphify install --platform agents

    适用于读取 ~/.agents/skills 的框架。README 还列出 20 多个其他平台（Copilot CLI、OpenCode、Aider、Kiro 等）。

仅用于单个仓库

加上 --project，可把技能写入当前仓库（例如 .claude/skills/graphify/SKILL.md 或 .agents/skills/graphify/SKILL.md），而不是用户目录：

graphify install --project
graphify install --project --platform codex

最小流程

依据上游 README；AgentSkillsDir 尚未在仓库上实际运行。

  1. 从官方包安装命令行工具：uv tool install graphifyy（或 pipx install graphifyy）。需要 Python 3.10 或更新版本。
  2. 为你的助手注册技能：graphify install，或上表中对应平台的命令。
  3. 在助手中，对你有权读取的仓库运行 /graphify .（Codex 为 $graphify .）。
  4. 打开 graphify-out/graph.html，阅读 GRAPH_REPORT.md，并保留 graph.json 供之后提问。

会得到什么

graphify-out/ 下的三个文件：

graph.html
可在任意浏览器中打开的交互式图谱：点击节点、筛选、搜索。
GRAPH_REPORT.md
文字要点：关键概念、意外关联和建议提问。
graph.json
完整保存的图谱，之后无需重读文件即可查询。

哪些留在本地

  • 代码：在本地用 tree-sitter 解析。上游说明这一步不调用 LLM，内容不会离开你的电脑。
  • 文档、PDF 和图片：交给助手所用的模型，或你配置的 API 后端，做语义提取。上游提供 --code-only 参数以跳过它们。
  • 上游声明没有遥测，但会把图谱查询记录到 ~/.cache/graphify-queries.log；设置 GRAPHIFY_QUERY_LOG_DISABLE=1 可关闭。

Graphify 还是 Obsidian？

两者用途不同。Obsidian 是你浏览和书写的个人笔记库；Graphify 构建由编程智能体通过 /graphify 查询的项目图谱，代码部分来自 AST。如果你已经在用笔记库，skill.md 提供可选的 --obsidian 参数，可把图谱另存为 Obsidian 笔记库。

安装前

  • 这是会在助手中注册钩子和指令的第三方代码。安装前请先阅读 skill.md 和源代码。
  • 收录不等于安全审查。AgentSkillsDir 没有审查过这些代码。
  • 上游另有付费的 Graphify Cloud，与开源技能是两回事，本页不涉及。

常见问题

Graphify skill 是什么？

Graphify Labs 的智能体技能与命令行工具（Graphify-Labs/graphify，Apache-2.0），通过 /graphify（Codex 为 $graphify）把项目文件夹映射为可查询的知识图谱。

Graphify 是画图工具吗？

不是。它构建的是供智能体查询的代码与文档知识图谱，不是通用的图表编辑器或白板。

应该安装哪个 PyPI 包？

graphifyy，结尾是两个 y。不要运行 pip install graphify；上游说明 PyPI 上其他 graphify* 包与其无关。命令行命令仍是 graphify。

如何为 Claude Code、Codex、Cursor 或 Gemini 安装？

依据上游 README：graphify install（Claude Code）、graphify install --platform codex、graphify cursor install、graphify install --platform gemini。2026 年 10 月 31 日抓取；AgentSkillsDir 尚未亲自运行。

代码分析会离开我的电脑吗？

上游说明代码在本地用 tree-sitter 解析，这一步不调用 LLM。文档、PDF 和图片会交给你的助手所用模型，或你配置的 API，做语义提取。

graph.html、GRAPH_REPORT.md 和 graph.json 分别是什么？

浏览器中的交互式图谱；附建议提问的文字要点；以及供之后查询的完整图谱文件。三者都在 graphify-out/ 下。

选 Graphify 还是 Obsidian？

用途不同。Obsidian 是个人笔记库；Graphify 构建可供智能体查询的项目图谱，并可用 --obsidian 选择性导出 Obsidian 笔记库。

AgentSkillsDir 会托管我的图谱或销售 Graphify Cloud 吗？

不会。这是附来源链接的目录条目，本页面不会安装或运行任何内容。

AgentSkillsDir 审查过代码吗？

没有。收录不等于安全审查。安装前请阅读源代码和 skill.md。

星标数和版本号是最新的吗？

它们是来自 GitHub 和 PyPI API 的带日期快照，请查看来源卡片上的最近核验时间。

更正与建议

发现内容过时，或想推荐一个技能？发送更正邮件。若要推荐资源，请提交供人工审核。