用途：kb-init 是面向 Obsidian 的“评审门控”知识库工作流中的初始化技能，负责一次性搭建、迁移或修复知识库的支撑层。它对应 Karpathy 的 LLM Wiki 模式：raw 源文件是不可变证据，LLM 编译并维护 wiki，用户通过提供文档和提问来策展。
主要能力：创建支撑层目录，包括 raw/human/{articles,papers,podcasts,repos,assets}、raw/human/data、raw/agents/{role}/、raw/_manifest.yaml、wiki/drafts/ 与 wiki/live/ 下的 summaries、topics、concepts、entities、procedures、overviews、comparisons、indices，以及 wiki/briefings/、wiki/index.md、wiki/log.md、outputs/reviews/、AGENTS.md、CLAUDE.md。生成起始文件，如 wiki/index.md、wiki/log.md、MEMORY.md、raw/_manifest.yaml、wiki/live/indices/ 下的 INDEX.md、CONCEPTS.md、SOURCES.md、TOPICS.md、RECENT.md、EDITORIAL-PRIORITIES.md，以及示例 briefing 或占位文件。可选治理脚手架包括 QUESTIONS.md、GAPS.md、ALIASES.md、ENTITIES.md、RELATIONSHIPS.md；可选下游输出目录包括 outputs/qa/、outputs/health/、outputs/reports/、outputs/slides/、outputs/charts/、outputs/content/**、outputs/episodes/、outputs/audit/operations.jsonl、outputs/health/graph-snapshot.json。
使用方式：先阅读共享参考文件，包括 skill-contract-registry.json、file-model.md、lifecycle-matrix.md 及各模板与契约文件，以 skill-contract-registry.json 作为角色、基线脚本、必需参考和写入面的权威来源。若存在 ../obsidian-notes-karpathy/scripts/detect_lifecycle.py，先运行以区分 setup、repair 与 needs-migration/legacy-layout migration。若存在 bootstrap_review_gated_vault.py，用于全新搭建和非破坏性修复脚手架；若存在 migrate_legacy_vault.py，用于旧版单层 vault 迁移；若存在 build_governance_indices.py 且用户需要可选治理脚手架，可在支撑层建立后生成 QUESTIONS.md、GAPS.md、ALIASES.md 起始内容。初始化或修复时需选择运行配置：governed-team（最严格默认治理）、standard（较轻维护噪音）、fast-personal（个人使用，briefing 可不在默认查询范围），并将所选配置持久化到脚手架起始文件中。
适用场景：全新 vault 的四步流程为 Init（kb-init 创建支撑层）、Ingest（kb-ingest 注册 raw 源到 raw/_manifest.yaml）、Compile（kb-compile 构建可评审草稿）、Review（kb-review 批准草稿进入 wiki/live/）；之后可用 kb-query 提问、kb-render 生成确定性对外产物、kb-review 维护模式审计漂移。旧版布局迁移时保留旧内容，说明 wiki/summaries/、wiki/concepts/ 页面需移入 wiki/live/，先搭建评审门控目录，并将迁移视为修复步骤而非普通编译或查询。
限制与契约：raw/ 保持不可变；kb-compile 只写入 wiki/drafts/；kb-review 负责晋升到 wiki/live/ 并刷新 briefing；kb-query 不得将草稿视为真相；AGENTS.md 与 CLAUDE.md 需在评审门控文件模型上保持一致；outputs/reviews/ 之外的下游输出为可选脚手架，不是最低支撑层要求。MEMORY.md 为推荐协作脚手架，存放偏好、编辑优先级和协调上下文，而非源依据主题知识。输出时报告创建或迁移了什么、是否检测到旧版布局/需迁移状态、保留了哪些现有内容，以及下一步推荐命令（通常为 kb-compile 或 kb-review）。