用途：在知识包中为软件仓库建立或刷新持久的技术模型，记录职责、行为、边界与维护路径，仓库文件仍是唯一事实来源并保持原位。
主要能力：在指定仓库内除密钥、被忽略的私有材料、依赖、构建输出、缓存和目标知识包本身之外，可读取任意内容；只在选定的知识包内写入，绝不复制、移动、删除或修改仓库源码、既有项目文档、配置、测试或代理指令文件；不安装依赖，也不执行仓库代码、构建、测试、脚本或钩子；除非用户另行要求，不创建提交、分支、推送或 PR。外部来源仅在用户纳入范围时经 kb-ingest 处理。
使用方式：先定位仓库根与知识包（默认 knowledge/），无包时按 kb-init 与代码库文档模式建立；有包时先读根 index.md 和 spec/types.md、spec/conventions.md。随后确定证据窗口，优先受版本控制的文件，必要时仅做只读 Git 检查（如 git status --short、git ls-files、git log、git show、git diff）。再按稳定职责而非文件规划概念图，写入带 sources 与仓库证据段落的概念，刷新时引用 spec/repository_state.md 中的 documented_revision 比对变更。最后恢复导航、记录修订并运行 kb-lint 验证。
适用场景：为仓库生成或更新架构与维护文档、刷新既有知识包、追踪自上次文档修订以来的变更。
限制：不确定的行为需标注证据缺口而非推测；不用 Git 时须说明未检查变更历史；若变更不影响知识包声明则不做任何修改；不创建提交。具体收费、价格、平台等信息暂未提供。