用途：在仓库中配置 graphify，使提交到 git 的知识图谱具备自维护能力：随提交刷新、名称确定、仅覆盖代码、跨并行提交不冲突。
主要能力与机制：预提交钩子运行 graphify update . 并暂存 graphify-out/，使新图谱随提交进入版本库；钩子会跳过链接工作树（git-dir 不等于 git-common-dir），特性分支不会扰动图谱或在合并时争夺图谱。社区命名不依赖 LLM、命名器或 API 密钥，由主导节点确定，新社区会得到如 net.py 的真实名称而非数字占位。.graphifyignore 将 markdown（计划、ADR、技能、文档）排除在图谱之外。graphify 的 union 合并驱动自动合并 graph.json，避免冲突标记。不使用 post-commit 钩子、SessionStart 钩子，刷新路径中不含代理特定内容。
使用方式：一，安装或升级 graphify（需 >=0.9.15，运行 uv tool install graphifyy 或 uv tool upgrade graphifyy，备选 pipx install graphifyy、pip install --user graphifyy，并用 graphify --version 确认）。二，通过官方渠道安装代理集成，如 graphify install、graphify claude install、graphify codex install，另有 gemini、cursor、copilot、vscode、aider、opencode 等，多代理仓库需各跑相关安装器。三，接入预提交刷新，不要用 graphify hook install（其钩子是 post-commit，且 husky 下会静默失效），而应使用模板模板的块：husky 项目追加到 .husky/pre-commit，普通 git 追加到 .git/hooks/pre-commit（需 #!/bin/sh 与 chmod +x）。四，复制模板为 .graphifyignore 并按实际环境调整。五，配置 union 合并驱动：复制 graphify-out/graph.json merge=graphify 到 .gitattributes，并在每个克隆中设置 git config merge.graphify.name "graphify union merge" 与 git config merge.graphify.driver "graphify merge-driver %O %A %B"。六，向 .gitignore 加入 graphify-out/cache/、日期备份目录、graphify-out/.graphify_analysis.json，其余文件应提交。七、用 graphify extract . --code-only 与 graphify update . 首次生成图谱，然后提交 graphify-out/。八、报告 graphify 版本、所装代理集成及循环机制。
适用场景：需要把代码知识图谱纳入版本控制、由多代理共同读取、且希望图谱随提交自动保持最新的仓库。
限制：合并驱动的 git-config 部分不随仓库传播，每个克隆需单独设置或重跑本技能；主题式 LLM 命名（graphify label 或 --backend claude-cli）仅建议偶尔手动润色，因其会重新聚类、生成带日期的备份目录并漂移措辞；extract 的 --code-only 会被 update 忽略，排除文件应依赖 .graphifyignore；不要手工编辑 graphify-out/。资料未提供收费、价格、平台或性能等信息。