用途：brain-expert 是面向 brain CLI 的个人知识管理专家技能，帮助用户捕捉笔记、检索知识库并管理“第二大脑”。brain CLI 使用分层 Markdown 文件、SQLite 存储和语义搜索。
主要能力：初始化目录（brain init [path]）；添加带时间戳的笔记（brain add "text"，可用 -f 指定文件、--ref 引用外部文件）；创建条目（brain new "path/name"）；列出与查看（brain list、brain list --tree、brain show <path>）；编辑与删除（brain edit、brain delete、brain rm，支持 --force、--db-only）；同步（brain sync、brain sync --force）；搜索（brain search "query" 为语义搜索，brain search --exact "term" 为 FTS5 全文搜索）；待办管理（brain todo add/list/done/cancel/edit/rm，支持 -p 项目、-d 日期）；自动同步（brain cron install/status/remove，默认 5 分钟，可用 --interval 调整）。
文件结构：按 ~/Documents/brain/ 分层组织，如 2026/01/22.md 为每日日志，projects/、notes/ 存放命名条目，.brain.db 为 SQLite 数据库。每日文件使用 [YYYY-MM-DD-HHMMSS] 时间戳块，命名文件使用 Markdown 标题。
配置与环境：配置存于 ~/.brain.json，含 path、editor、embeddingModel（如 text-embedding-3-small），用 brain config show/set 管理。语义搜索需要 OPENAI_API_KEY；EDITOR 作为编辑器回退。
限制与排错：搜索前需先 brain sync；嵌入报错检查 OPENAI_API_KEY；命令未找到可在 brain 目录运行 bun link；路径错误用 brain config show 检查。资料未提供价格、平台支持范围与效果保证等信息。