用途：为 git 仓库建立并维护一个以智能体为先的活知识库，存放在 repo-wiki/ 目录。核心原则是只持久化代码无法再生的知识（原因、坑点、心智模型、约束、产品背景），可从代码推导的内容按需生成；同时把对话中产生的隐性知识挖掘出来，避免随会话结束而丢失。
主要能力：提供 kb 命令行工具，包括 kb init / kb plumbing 安装钩子与 gitignore，kb scaffold 在用户同意后创建目录与 INDEX 文件，kb bootstrap 生成只读信号报告并进入两道人审门（先确认 MECE 结构，再确认挖掘范围），kb status 基于 git 检测页面漂移，kb catchup 挖掘历史会话，kb verify 标记页面为最新，kb search 提供基于 SQLite FTS5/BM25 的全文检索，kb serve 启动本地只读网页查看器，以及评论、staleness 与 catch-up 机制。页面采用“Compiled Truth + Timeline”模型，头部含 covers、verified_against、status 等字段。
使用方式：先运行 python3 scripts/kb.py init 或 plumbing 安装钩子；再运行 kb bootstrap 做只读扫描，按 references/bootstrap.md 走 scan → propose → agree → scaffold 流程，Gate 1 同意后用 kb scaffold --recommended 或 --only/--add 创建结构，Gate 2 同意后并行挖掘。日常用 kb status、kb catchup、kb search、kb serve 等命令。
适用场景：新仓库或已有仓库的冷启动、会话中沉淀决策与约束、检查页面新鲜度、补挖遗漏会话、把臃肿的 CLAUDE.md/AGENTS.md 精简为薄壳。
限制：结构绝不自动创建，必须先与用户达成一致；staleness 只是审查队列而非提交门禁；网页查看器为本地只读，浏览器内编辑为后续计划；搜索索引按仓库隔离、不跨仓库；在缺少 FTS5 的解释器上回退到 ripgrep。具体收费、平台与效果资料暂未提供。