用途：为已存在的 secondbrain 项目配置 qmd 语义搜索，属于项目初始化类技能。
前置条件：当前目录需存在 .claude/data/config.yaml，且已安装 qmd（用 which qmd 检查）。缺少 secondbrain 项目时需先运行 /secondbrain-init；缺少 qmd 时可用 bun install -g qmd 或 npm install -g qmd 安装，首次运行会下载约 1.5GB 嵌入模型。
主要步骤：先校验环境与是否已初始化搜索（检查 .claude/search/）；创建 .claude/search 目录并在项目根生成 qmd.config.json，其中包含 name、paths（默认 docs）、ignore、indexDir、chunk 的 size 与 overlap、metadata 等字段；把 .claude/search/ 与 qmd.config.json 加入 .gitignore；执行 qmd index 建立初始索引；可选在 .claude/settings.local.json 注册 PostToolUse 钩子（匹配 Write|Edit，调用 .claude/hooks/search-index-update.py），实现文件变更时增量更新索引。
常用用法：/secondbrain-search "查询"、带过滤的 --entity=adrs 或 --recent=30d；索引管理用 qmd index --rebuild、qmd status、qmd history；技能选项含 --rebuild 强制重建与 --no-hook 跳过钩子。
适用场景：为已有知识库/docs 加入语义检索，并可按需自动保持索引最新。
限制与排障：索引不提交到版本库；模型下载卡住可清空 ~/.cache/qmd/models/ 后重试；索引异常可删除 .claude/search/ 重建；大文档集（>500 篇）初始索引可能耗时数分钟，可用 --batch-size=50 观察进度。具体项目名称、文档数量等以实际运行输出为准，其他细节资料未提供。