SuperAPI AI 工具集

obsidian-brain

办公与效率

查看项目

更新于 10-15 23:32

技能介绍

用途:把 Claude Code 接入 Obsidian 仓库,作为思考伙伴,用于加载项目上下文、捕捉想法、晨间规划、查询关联笔记等。

主要能力与用法:仓库默认路径为 ~/second-brain,可用 VAULT_ROOT 环境变量覆盖;若仓库不存在,先运行 scripts/init-vault.sh ~/second-brain 初始化。核心是双区架构:人类区(notes/、projects/、tasks/、resources/、contexts/、daily/、people/)对 AI 只读,除非通过 scripts/human-write.sh 写入用户口述内容(需路径在 tasks/ 或 notes/ 且内容含 source: human);AI 区(ops/ 及子目录)可读写,所有 AI 写入必须经 scripts/safe-write.sh 校验路径,禁止直接写文件。

命令:/capture 捕捉草稿,仅写入 ops/drafts/;创建任务用 scripts/create-task.sh $VAULT_ROOT "Task title" --due 2026-04-01 --tags "work,urgent",仅写入 tasks/;创建笔记用 scripts/create-note.sh $VAULT_ROOT "Note title" "Content text" --tags "ai" --links "concept-a,concept-b",仅写入 notes/;查询任务用 scripts/query-tasks.sh $VAULT_ROOT --undone --date today 或 --tag migration --project obsidian-brain,只读;完成任务用 scripts/complete-task.sh $VAULT_ROOT "task keyword",仅修改 tasks/ 的 done 字段。/context 加载项目上下文,/today 做晨间规划,均只读且不写文件。反思命令 /challenge、/drift、/emerge、/connect 通过 scripts/analyze.sh 运行,仅读人类区并只输出到终端。关联查询用 scripts/query-links.sh $VAULT_ROOT outgoing "notes/idea-a.md"、backlinks "idea-a",可加 --human-only。

适用场景:个人知识管理、任务与笔记整理、项目上下文加载、想法捕捉与关联分析。

限制:必须遵守双区边界,AI 不得直接写人类区;所有写入须经校验脚本;反思命令不落盘。仓库 schema 与命令细节见 references/vault-schema.md 和 references/command-guide.md。