用途：将项目的 Claude Code 配置（agents、skills）连接到 Obsidian 库，方便浏览、搜索与交叉引用。方向性上，全局 agents/skills 以 Obsidian 为准，符号链接到 ~/.claude/；项目级 agents/skills 以项目仓库为准，符号链接到 Obsidian。
模式（根据输入分派）：/obsidian-link 或 /obsidian-link link 为链接模式（默认）；/obsidian-link status 为状态模式；/obsidian-link unlink <project> 为取消链接模式；/obsidian-link init 为初始化模式，配置 plan frontmatter。
配置：库路径按顺序查找 OBSIDIAN_VAULT 环境变量、~/.obsidian-vault 文件（单行绝对路径），找到后与用户确认，可将路径保存到 ~/.obsidian-vault。目录结构为 <vault>/ClaudeCode/ 下的 README.md、Agents/（global 与各项目）、Skills/（global 与各项目）、Plans/（~/.claude/plans 链接到此）。每个模式前会做轻量预检，检查库路径、库目录、Plans 符号链接、plan frontmatter、项目是否已链接等状态并给出摘要，库路径缺失时需先询问用户。
链接模式步骤包括：解析库路径并创建目录（如 mkdir -p "<vault>/ClaudeCode/{Agents/global,Skills/global,Plans}"）、处理 ~/.claude/plans 符号链接（缺失则 ln -sf "<vault>/ClaudeCode/Plans" "$HOME/.claude/plans"，指向别处则警告并跳过）、用 git rev-parse --show-toplevel 检测项目、幂等地链接项目 agents 与 skills、同步全局 skills 到 ~/.claude、同步全局 agents、检测损坏符号链接（find 查找 -type l ! -exec test -e {} ;）、重新生成索引笔记 README.md 并报告。
状态模式扫描库的 ClaudeCode/ 目录，报告各项目符号链接与损坏数量、全局同步、Plans 链接并重新生成索引。取消链接模式删除项目在库中的符号链接目录，不删除仓库文件，需用户明确确认。初始化模式交互式配置 ~/.claude/CLAUDE.md 的 ## Plan Files 段落，选择 frontmatter 字段（如 type、title、status、created、tags 及可选项 id、projects、priority 等）和文件名约定，预览确认后写入，可重复运行。
限制与注意：不自动删除损坏符号链接，只报告；不覆盖非 Obsidian 配置（如 ~/.claude/agents 为真实目录时警告并跳过）；链接模式幂等，重复运行结果一致；索引笔记每次运行完全重新生成，可手动删除。