← ClaudeAtlas

soia-pkm-bootstrap-vault-obsidianlisted

配置 Obsidian 作为本地 Markdown 知识库的消费端:安装 Obsidian、启用 Bases、检查 .obsidian 配置和 CSS snippets,并衔接通用 vault base。Triggers:「配置 Obsidian」「装 Obsidian 插件」「Obsidian 特化配置」「启用 Bases」
soia-team/soia-open-skills · ★ 2 · AI & Automation · score 72
Install: claude install-skill soia-team/soia-open-skills
# soia-pkm-bootstrap-vault-obsidian 在 `soia-pkm-bootstrap-vault-base` 创建的本地 Markdown 知识库上配置 Obsidian 消费端。Obsidian 只提供编辑、浏览和数据库视图;Markdown、YAML frontmatter 和 Git(若启用)仍是内容真源。 ## 客户可读说明 ### 这个技能可以做什么 - 安装或检查 Obsidian 1.9+。 - 启用核心插件 **Bases**,用于书库、文章库等数据库视图。 - 检查 `.obsidian/` 与 `snippets/wide-page.css` 是否已由 base 脚本生成,并说明手动启用步骤。 - 提供 Tars、Terminal、Obsidian Git 等可选配置边界。 本 skill 不创建 PARA 骨架、不替代 base,也不把 Obsidian 数据反向写回其他云端知识库。 ### 客户如何使用 1. 先安装并运行 `soia-pkm-bootstrap-vault-base`,通用初始化使用 `--no-obsidian`;如果要让脚本同时生成 CSS snippet,则按下方命令不带该参数运行。 2. 提供已有 vault 路径��确认 Obsidian 是否已安装及版本。 3. 按本 skill 完成核心插件和可选插件配置。 4. 在 Obsidian 中打开目标 vault,确认规则、模板和文章能正常显示。 ### 依赖与安装 安装本 skill(hard dependency 会同时要求 base): ```bash npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-bootstrap-vault-obsidian -y ``` 配置约定: ```text ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-bootstrap-vault-obsidian/config.yml SOIA_PKM_BOOTSTRAP_VAULT_OBSIDIAN_CONFIG_FILE=<custom-config-path> ``` 外部安装入口: - Obsidian 下载:https://obsidian.md/download - 版本建议:1.9+,以当前官方版本和本机系统支持为准。 ### 日志与完成回执 回执至少说明:Obsidian 版本检查结果、vault 打开/检查结果、Bases 是否启用、`.obsidian`/CSS 是否存在、可选插件是否跳过,以及仍需用户在客户端手动完成的事项。不要把账号、token 或本机私有路径写入日志。 ## 配置流程 ### 1. 安装 Obsidian 从 [Obsidian 官方下载页](https://obsidian.md/download) 安装桌面客户端,并登录(若用户需要同步或社区插件等账号能力)。不需要为了打开本地 Markdown vault 而把账号凭据写入 vault 或 skill 配置。 ### 2. 运行通用初始化 通用层命令: ```bash python3 <path-to-base-skill>/scripts/init_vault.py <vault-path> --no-obsidian ``` 若希望沿用 base 默