soia-pkm-bootstrap-vault-baselisted
Install: claude install-skill soia-team/soia-open-skills
# soia-pkm-bootstrap-vault-base
用一套知识库中立的 Markdown 骨架初始化 AI-native 知识库:PARA 目录、AGENTS 路由、模板、多 AI 入口和 PKM 闭环技能。Obsidian、腾讯 ima 等平台只消费本地 Markdown;平台特化配置由对应 skill 负责。
## 客户可读说明
### 这个技能可以做什么
| 客户想要 | 技能会做 | 客户能看到 |
|---|---|---|
| 从零开始建本地 Markdown 知识库 | 按配置创建 PARA 骨架、各区规则、模板和使用手册 | 目录、规则文件、模板及终端摘要 |
| 让多个 AI 共用一套规则 | 创建多 AI adapter,并让 `AGENTS.md` 保持唯一真源 | 各入口文件和规则路由 |
| 接入 PKM 闭环 | 安装或检查 SOIA 的 clip、organize、distill、compose、publish 等技能 | 安装结果、缺失依赖和后续命令 |
本 skill 不负责安装或配置 Obsidian,也不负责把内容上传到 ima。需要这些能力时,继续使用 `soia-pkm-bootstrap-vault-obsidian` 或 `soia-pkm-bootstrap-vault-ima`。
### 客户如何使用
1. 提供目标 vault 路径,并说明是否使用默认 JSON 配置或自己的 JSON/YAML 配置。
2. 对通用 Markdown 知识库运行初始化脚本时使用 `--no-obsidian`,跳过默认配置中的 `.obsidian/**` 产物。
3. 检查生成的目录、规则和模板,再接入需要的 AI 与 PKM 技能。
4. 需要 Obsidian 时,让 `soia-pkm-bootstrap-vault-obsidian` 在 base 完成后处理平台配置;需要 ima 时,让 `soia-pkm-bootstrap-vault-ima` 处理云端消费端接入。
5. 执行后核对真实文件和闭环示例,不以命令退出码单独宣称完成。
### 依赖与安装
安装本技能:
```bash
npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-bootstrap-vault-base -y
```
配置约定:
```text
~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-bootstrap-vault-base/config.yml
SOIA_PKM_BOOTSTRAP_VAULT_BASE_CONFIG_FILE=<custom-config-path>
```
- 本 skill 没有 SOIA-managed hard dependency;两个平台特化 skill 将它声明为 hard dependency。
- `weread-skills` 与 `huashu-weread-advisor` 只在用户需要读书同步或增强时安装,不是通用初始化的阻断依赖。
- 私有路径、API key、cookie、session 和登录态只能放在用户自己的配置或 provider 登录态中。
### 日志与完成回执
每次执行都要报告:使用的 vault/config(不打印秘密)、创建或跳过的目录和文件类别、技能安装结果、验证命令