Graphicle Skill 技能

技能简介

Graphicle 是面向 AI 编程代理（Claude Code、Codex、Cursor、VS Code、Claude Desktop）的一款 MCP（Model Context Protocol）服务器。它用单一 Rust 程序把代码仓库转换成代码图谱 + 项目记忆 + 文档历史，让代理能用"引用证据 + 行号"的形式回答项目内部问题。Graphicle 由 Graphicle-AI（产品站点 karlex.ai）于 2026 年 10 月发布，对外开源 Apache-2.0 协议，本地优先、不传遥测、无需 API Key，是 2026 年 10 月 MCP 生态最实用的"项目记忆层"工具之一。

核心能力

1. 一键构建代码图谱：graphicle setup 自动索引仓库、构建图谱、连接已安装的 agent 客户端，并在 AGENTS.md 追加两行指引（如果代理不止 Claude Code）。
2. 可验证的引用证据：graphicle ask "where is tax added to prices?" 输出每条引用对应的文件路径与行号（如 shop/pricing.py:1-7），避免模型猜答案。
3. 多 agent 全兼容：已对接 Claude Code、Cursor、Codex、VS Code、Claude Desktop 与所有标准 MCP 客户端，无需为每个平台写适配。
4. 本地优先：所有索引和图谱都跑在你自己的机器上，不上传代码、不上传遥测，也不要求账户与 API Key。
5. Git 钩子保持最新：自动安装 pre-commit / post-commit 钩子，确保每次提交都能让图谱保持新鲜。
6. Graphify 兼容：内置 Graphify 迁移文档，几条命令能把老用户平滑迁过来；基准测试显示 0.1.1 内存在 13 个代码仓上比 Graphify 0.9.91 节省 0.29-0.97 倍峰值内存。
7. 可视化与影响分析：graphicle open 可在浏览器中浏览图谱、来源与项目记忆；graphicle graph affected 能看到某个改动会碰到哪些符号。

安装配置

# macOS / Linux 通过 Homebrew
brew install graphicle-ai/tap/graphicle
cd your-repo
graphicle setup

# 没有 Homebrew 时
curl -fsSL https://github.com/graphicle-ai/graphicle/releases/latest/download/install.sh | sh

# Windows（x86-64 预览版，未代码签名）
graphicle setup --yes

可选：在 agent 里贴一段 prompt 让它自动安装：

Install Graphicle with `brew install graphicle-ai/tap/graphicle` (or the curl command),
then run `graphicle setup --yes` and list every file changed.

使用步骤

1. 安装 Graphicle CLI 后在你的仓库运行 graphicle setup，它会自动索引仓库、安装 Git 钩子并检测已有 agent 客户端。
2. 让你的编程代理询问项目相关问题："用 graphicle 找出 retry 的位置"。
3. 也可以在终端直接问：graphicle ask "How are failed requests retried?"，看证据 + 行号。
4. 用 graphicle doctor 检查整体健康状态（18+ 一致性检查）。
5. 用 graphicle graph extract . --code-only + graphicle graph affected "retry()" 做改动影响面分析。
6. 想要撤回时，一条 graphicle disconnect 即可还原全部文件改动。

适用场景

• 大代码库的 AI 问答：让 Claude / Codex 能直接"读懂"几十万行老项目的内部逻辑。
• 跨服务架构梳理：把微服务集群转换成可检索的图谱，便于改一处、看一片。
• 代码审查与影响分析：在改一个函数之前先看它真正影响哪些调用方。
• 新人入职 onboarding：让 AI 协理先帮新人梳理代码库的关键模块，而不是甩给他一份 wiki。
• Graphify 老用户迁移：以零成本从 Graphify 切到 Graphicle（速度 + 内存优势）。

适用人群

• 使用 Claude Code / Cursor / Codex 进行严肃编程的工程师
• 大型单体仓库或多微服务团队的技术 Lead
• 想从 Graphify 迁出 / 对 Graphify 速度不满意的用户
• 任何希望代理"看见更多上下文"、并提供证据可追溯的高级用户

工作原理

Graphicle 把仓库解析成图谱 + 文档 / 决策 / 代理会话记忆三类片段，向代理返回时附带精确引用（文件 + 行号）。CLI 与 MCP 服务在同一 Rust binary 里，避免 Python/Node 多进程开销，也保护了用户隐私（不上传、不遥测）。

官方链接

• GitHub：https://github.com/Graphicle-AI/graphicle
• 产品站点（Karlex）：https://www.karlex.ai
• 文档：docs/quickstart.md
• 讨论：https://github.com/graphicle-ai/graphicle/discussions
• Discord：https://discord.com/invite/rWuU7cWU4E