用途:为当前仓库引导(bootstrap)一个项目知识库。它是支撑性技能,主工作流由 obsidian-project-memory 负责,仅在仓库需要初始绑定或重建时使用。
适用时机:用户表示要启动新研究项目;用户已有同时包含代码与 Markdown 的仓库,希望自动生成 Obsidian 知识库;obsidian-project-memory 检测到研究项目候选但尚无绑定。
所需输入:vault 路径,可从用户显式输入或环境变量 OBSIDIAN_VAULT_PATH 解析。
过程:先识别仓库根目录,运行预检检测: python3 "${CLAUDE_PLUGIN_ROOT}/skills/obsidian-project-memory/scripts/project_kb.py" detect --cwd "$PWD" 仅当仓库未绑定且应导入时,运行引导: python3 "${CLAUDE_PLUGIN_ROOT}/skills/obsidian-project-memory/scripts/project_kb.py" bootstrap --cwd "$PWD" --vault-path "$OBSIDIAN_VAULT_PATH" 随后验证至少生成:.claude/project-memory/registry.yaml、.claude/project-memory/<project_id>.md、Research/{project-slug}/00-Hub.md、01-Plan.md、Knowledge/Source-Inventory.md、Knowledge/Codebase-Overview.md。若导入项目仍缺少真实背景或实验上下文,改用 agent 优先流程:阅读最有信息量的仓库文档与代码入口,将长期笔记整理进 Knowledge/、Papers/、Experiments/、Results/ 或 Writing/,避免占位笔记。最后总结已创建知识库及建议下一步填写哪些规范笔记。
限制:引导只导入结构与摘要,不导入原始数据集、缓存、检查点或整棵代码树;忽略 .git、.venv、node_modules、缓存、检查点、二进制及其他重型产物。默认 vault 结构紧凑,含 00-Hub.md、01-Plan.md、Knowledge/、Papers/、Experiments/、Results/、Writing/、Daily/、Archive/。若当前 shell 无 python3,需使用能运行 project_kb.py 的系统 Python 解释器并明确说明。参考文件 references/BOOTSTRAP-RUNBOOK.md 包含预检决策、失败模式与引导后验证。