| name | init-vault |
| description | ThirdSpace 知识库初始化子 Skill。 仅在用户明确触发时加载（"初始化"、"setup"、"install"、"配置知识库"）。 日常知识库操作不加载本 Skill，避免无谓 token 消耗。 |
| triggers | ["初始化知识库","初始化","setup","install","配置知识库","帮我配置","第一次使用"] |
| parent | thirdspace-vault |
ThirdSpace 知识库初始化
Agent 合约
本 Skill 负责在新机器上完成知识库的自举配置。
不决策用户环境：Agent 自行感知运行环境（OS、Shell、可用工具链、当前使用的 Agent 平台），
选择合适的安装方式。本 Skill 只描述需要做什么和脚本在哪里，不写死命令。
需要完成的事项（What，不是 How）
1. 确认结构完整
vault 根必须存在以下文件，缺失则从 .thirdspace/schema/ 下的模板补全：
.thirdspace/workspace-index.yaml ← vault 根锚点
.thirdspace/schema/frontmatter.yaml
.thirdspace/schema/taxonomy.yaml
.thirdspace/schema/subsystems.yaml
.thirdspace/schema/event-capture.yaml
.thirdspace/schema/workspace-tools.yaml
2. Agent Stop Hook（可选，推荐）
作用：每次 Agent session 结束时，检测重大产出并提示记录工作日志。
脚本位置：./00-系统/运行时/hooks/claude-stop-hook.sh
需要做的事：将脚本注册为 Agent 平台的 session stop / post-conversation hook。
不同平台注册方式不同，由 Agent 根据当前平台自行判断：
- Claude Code：
~/.claude/hooks/session-stop.sh
- 其他平台：参考各平台 hook 文档
用户可以跳过此步，不影响知识库核心功能。
3. Git Hook（可选，推荐）
作用：每次 git commit 后自动记录提交事实到工作日志。
脚本位置：./00-系统/运行时/hooks/global-post-commit.sh（全局）或 repo-post-commit.sh（单 repo）
需要做的事：注册为 git post-commit hook，方式因环境而异。
用户可以跳过此步。
4. 定时任务（可选）
作用：每日定时触发工作日志归档等任务。
配置模板位置：./00-系统/运行时/crontab/
需要做的事：按用户环境注册定时任务（crontab / systemd timer / Task Scheduler 等）。
用户可以跳过此步。
5. Skill 全局注册（按需）
作用：让 Agent 从 vault 目录之外也能加载 thirdspace-vault Skill。
需要做的事：将 ./00-系统/Skills/thirdspace-vault 链接或复制到 Agent 平台的全局 skills 目录。
不同 Agent 平台位置不同，由 Agent 自行判断。
6. Obsidian 插件启用（需用户手动）
插件已随 vault 分发，位于：.obsidian/plugins/thirdspace-dashboard/
用户需要在 Obsidian 中手动启用（无法自动化）：
设置 → 第三方插件 → 允许社区插件 → 启用 ThirdSpace Dashboard
验收检查
完成初始化后，运行以下检查确认基础结构就绪：
find . -maxdepth 2 -name WORKSPACE.md | sort
find .thirdspace/schema -type f | sort
grep -r "/Users/\|/home/\|C:\\\\" .thirdspace/ CLAUDE.md AGENTS.md 2>/dev/null | grep -v ".git" | wc -l
给用户的说明
初始化结束后，Agent 用自然语言告知用户：
- 已完成的步骤（结构验证、已安装的 hooks）
- 跳过的可选步骤及原因
- 需要用户手动操作的步骤（Obsidian 插件启用）
- 如何开始使用（在 vault 目录打开 Claude Code，直接说"帮我记一条笔记"）
