gbrain-guide
AI操作GBrain知识库的规范指南
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：gbrain-guide。 它的用途是：AI操作GBrain知识库的规范指南 完整的 Skill 内容见：https://321skill.com/skills/gbrain-guide/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我将这份技术文档存入GBrain，分类为开发文档，并关联到现有项目节点。' 它会先检查文档格式，按规范添加路径前缀（如/dev/），然后执行入库操作，并自动创建标签和链接。
介绍
GBrain 是一款本地知识库工具，通过 MCP 协议接入 WorkBuddy 后，AI 可以对其执行分类、入库、检索、标签关联等操作。本指南系统性地覆盖了 GBrain 的安装形态、分类规范（路径前缀→类型映射）、资料入库流程、链接/标签关联方法、schema pack 切换、健康度治理、大库分批处理以及与 Obsidian 的联动要点。旨在帮助 AI 在接收“把资料存进 GBrain”、“用 GBrain 检索”、“整理知识库”等指令时，能按照统一规范完成任务，避免因操作不一致导致知识库混乱。
使用时，AI 需要先理解 GBrain 的概念和安装环境，然后按照分类规范为资料打上正确的路径前缀，再执行入库操作。对于已有知识库，可通过链接和标签建立关联，利用 schema pack 切换数据结构，并定期进行健康度检查与治理。遇到大库时，按批次处理可避免性能问题；与 Obsidian 联动则能双向同步笔记。
适合需要频繁管理本地知识库的开发者和团队，尤其是那些通过 AI 代理（如 Claude、Cursor）自动处理知识入库、检索、整理的场景。智能体开发者、文档工程师、项目经理均可从中获得标准化操作流程。
使用前建议先阅读 GBrain 官方文档，确保 MCP 接入配置正确。本指南侧重操作规范，不涉及 GBrain 的底层原理；若需要自定义分类规则或 schema，需具备一定的 JSON 配置能力。
核心特点
与通用知识库管理工具不同，本指南专门针对 GBrain + MCP 接入 WorkBuddy 的架构，提供了从分类前缀到健康度治理的完整操作规范，并包含 Obsidian 联动等特色场景。
注意事项
不适用于非 GBrain 的知识库系统，也不涉及 GBrain 的安装部署细节（需参考官方文档）。
常见问题
如何将资料正确存入 GBrain？
按照分类规范，先确定资料类型（如技术文档、项目笔记），然后添加对应的路径前缀，再执行入库操作。
GBrain 知识库健康度低怎么办？
运行健康度检查脚本，定位冗余链接、未关联标签或 schema 不匹配的节点，按治理建议分批修复。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/gbrain-guide/raw/index.md 读取 gbrain-guide 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/gbrain-guide/raw/index.md（查看排版版本）