不是把笔记交给某个 AI 平台，而是把知识保留在你自己的 Markdown 文件中，让当前获得授权的智能体按同一套规则维护它。
English: One portable Agent Skill that turns an Obsidian vault into a local-first, AI-maintained knowledge system across Codex, Claude, OpenCode, Kimi Code CLI, Qwen Code, TRAE, CodeBuddy, Manus, and DeerFlow 2.0.
大多数 AI 对话结束后，上下文也随之消失。换一个模型或客户端，还要重新解释：
- 我是谁，正在做什么；
- 当前最重要的目标是什么；
- 这个项目进行到了哪里；
- AI 应该主动到什么程度；
- 哪些是事实，哪些只是推断；
- 哪些文件可以修改，哪些行为必须先确认。
XGQQ 把这些信息放回透明、可搜索、可回滚的本地文件系统：
- Obsidian 负责浏览、编辑和双向链接；
AGENTS.md保存唯一的智能体工作协议；- AI 智能体 在用户授权范围内搜索、读取、维护和推进项目；
- Claude 通过薄
CLAUDE.md → @AGENTS.md桥共享同一套规则； - 云端智能体 无法访问本机路径时生成便携 ZIP，而不是假装修改成功。
把这句话发给 Codex：
请使用 skill-installer，从 https://github.com/Bernie311/codex-obsidian-second-brain/tree/main/xgqq 安装这个 Skill。
或在 Windows PowerShell 中运行：
python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" `
--repo Bernie311/codex-obsidian-second-brain `
--path xgqqgit clone https://github.com/Bernie311/codex-obsidian-second-brain.git
cd codex-obsidian-second-brain
# 选择一个目标；安装器默认拒绝覆盖已有目录
.\installers\install.ps1 -Target claude可用目标：
-Target |
写入目录 | 适用客户端 |
|---|---|---|
codex |
~/.codex/skills/xgqq |
Codex |
common |
~/.agents/skills/xgqq |
OpenCode、Kimi Code CLI；TRAE 启用 .agents 后可用 |
claude |
~/.claude/skills/xgqq |
Claude Code |
qwen |
~/.qwen/skills/xgqq |
Qwen Code |
codebuddy |
~/.codebuddy/skills/xgqq |
CodeBuddy |
deerflow |
<DeerFlow>/skills/custom/xgqq |
DeerFlow 2.0 |
all-local |
上述 common、Codex、Claude、Qwen、CodeBuddy | 同一台 Windows 电脑上的多客户端 |
Manus：从 Releases 下载 xgqq-v0.2.0-rc.1.zip，在 Skills 页面选择上传 Skill。
安装完成后输入：
/XGQQ
或指定 Vault：
/XGQQ D:\Notes\MyVault
Codex 原生显式调用：
$xgqq
想持续获取客户端实测、安装排错、模板更新和第二大脑案例？
添加微信 D4Cexys7，备注 XGQQ。
完整安装步骤、迁移和卸载方法见 安装指南。
flowchart LR
U[用户发出 /XGQQ] --> A[当前 AI 智能体]
A --> S[xgqq / SKILL.md]
S --> M{选择运行模式}
M -->|本地路径可访问| P[预览将创建和保留的文件]
P --> C{需要确认?}
C -->|新空目录| W[只创建缺失文件]
C -->|已有非空 Vault| Q[获得用户确认]
Q --> W
W --> V[完整验证]
V --> O[(Obsidian Vault)]
O <--> B[Obsidian 浏览与编辑]
M -->|路径不可访问| E[导出便携 Vault ZIP]
E --> D[用户下载并解压]
D --> O
核心决策只有两条：
- 能访问并已获授权的路径：Direct 模式，先预览，再只创建缺失文件，最后验证。
- 云端、容器或远程沙箱看不到本机路径：Export 模式，生成 ZIP，并明确说明没有修改本机 Vault。
| 模式 | 使用时机 | 写入行为 |
|---|---|---|
| Initialize | 新建或空目录 | 创建 20 个基础模板文件 |
| Adapt | 已有 Vault | 只补齐缺失文件；已有文件全部保留 |
| Validate | 检查结构或排错 | 只读，不写入 |
| Export | 当前智能体无法访问目标路径 | 在授权输出位置生成便携 ZIP |
Vault/
├── AGENTS.md # 唯一智能体工作协议
├── CLAUDE.md # Claude 薄桥：@AGENTS.md
├── Home.md # 知识库入口
├── Inbox/README.md # 未整理输入
├── Profile/ # 已确认的个人上下文
│ ├── About.md
│ ├── Goals.md
│ ├── Working-Style.md
│ └── Projects.md
├── Knowledge/index.md # 可复用知识索引
├── Projects/
│ ├── README.md
│ └── _template/
│ ├── AGENTS.md # 项目级工作协议
│ ├── CLAUDE.md # 项目级 Claude 薄桥
│ ├── Project.md # 唯一主目标与下一步
│ ├── Inputs/README.md
│ ├── Process/README.md
│ ├── Outputs/README.md
│ └── Feedback/README.md
├── Logs/index.md # 决策、调整与复盘
├── Assets/README.md # 附件约定
└── .obsidian/app.json # 最小 Obsidian 设置
项目统一采用：
Inputs → Process → Outputs → Feedback
每个项目只保留一个当前主目标和一个最小下一步，避免“整理了很多，却没有开始行动”。
flowchart TB
CORE[同一个 xgqq/SKILL.md]
CORE --> C[Codex]
CORE --> CL[Claude Code]
CORE --> OC[OpenCode]
CORE --> K[Kimi Code CLI]
CORE --> Q[Qwen Code]
CORE --> T[TRAE]
CORE --> CB[CodeBuddy]
CORE -. ZIP 导入 .-> M[Manus]
CORE -. custom skills .-> D[DeerFlow 2.0]
没有九套提示词，也没有九个分叉版本。差异仅限于发现目录或导入方式。
详细证据、官方文档和未验证项见 兼容矩阵。请注意：/XGQQ 是明确的文本触发；各客户端是否把它显示为原生斜杠命令，取决于客户端实现。
初始化后，智能体会询问是否开始 onboarding：
- 每轮只问一个问题；
- 只写入用户明确确认的信息；
- 未知内容保留为待访谈，不自行猜测；
- 稳定个人上下文写入
Profile/，不写进通用 Skill； - 目标足够明确后才从
_template/创建第一个真实项目。
这让知识库从“空目录模板”逐步成为你的工作系统，同时保证公开 Skill 中不包含作者或用户的个人资料。
XGQQ 默认：
- 预览优先；
- 使用排他创建，绝不静默覆盖已有文件；
- 不把 Obsidian 安装目录当成 Vault；
- 不递归读取整个 Vault 来“补充上下文”；
- 不写入密码、API Key、令牌或恢复码；
- 不自动安装插件、MCP、REST API、同步服务或其他 AI 客户端；
- 不自动删除、对外发布、发送消息、连接账号或创建定时任务；
- 遇到遗留集成只报告，不擅自清理；
- 云端看不到本机路径时明确切换 Export，而不是伪造成功。
完整安全模型见 安全边界。
只预览：
python .\xgqq\scripts\init_vault.py "D:\path\to\vault"创建缺失文件：
python .\xgqq\scripts\init_vault.py "D:\path\to\vault" --apply适配已有 Vault：
python .\xgqq\scripts\init_vault.py "D:\path\to\vault" --mode adapt --apply完整验证：
python .\xgqq\scripts\validate_vault.py "D:\path\to\vault" --full导出便携 Vault：
python .\xgqq\scripts\export_vault.py ".\xgqq-obsidian-vault.zip"v0.2.0-rc.1 在 Windows 隔离环境使用自动生成的虚拟 Vault 完成：
- 10 项测试通过，0 项失败；
- 空 Vault 创建 20 文件，验证
0 errors / 0 warnings； - 重复运行所有已有文件哈希不变；
- 已有虚拟笔记不被覆盖；
- Obsidian 应用目录防护通过；
- ZIP 导出、解包和拒绝覆盖通过；
- 六类安装目录模拟逐文件哈希一致；
- 官方
quick_validate.py对源码和安装包均通过。
测试方法与已知限制见 测试说明。
v0.2 使用新的 Skill 名称 xgqq。建议先并行安装，不要直接覆盖旧目录：
- 安装
xgqq； - 新建会话验证
/XGQQ或客户端的 Skill 列表； - 在虚拟或空 Vault 先测试；
- 确认无误后，再由你手动决定是否删除旧的
bootstrap-codex-obsidian-vault。
v0.1.0 仍保留在 Git 历史和对应 Release 中。
本项目不是对 Karpathy LLM Wiki 的严格复刻，而是一个更偏执行、权限边界与跨客户端可移植性的本地 Markdown 工作流。
如果这个项目帮你减少了重复解释背景、整理目录和重新启动项目的时间，欢迎点一个 Star。这会帮助更多 Obsidian 和 AI Agent 用户发现它。
想持续获取：
- 各客户端真实安装测试；
- 新版本模板和兼容更新；
- Obsidian 第二大脑实战案例；
- 安装排错与使用交流。
添加微信 D4Cexys7，备注 XGQQ。
MIT © 2026 Bernie311