用途：维护一个有来源依据的 OKF v0.2 wiki 与记忆，用于召回、持久化发现、来源摄取、编译已捕获笔记或 wiki 维护。代理负责综合，仅依赖标准库的 Python 3.10+ CLI 负责文件、历史与索引操作；Markdown 为权威内容，index.db 是可重建的 FTS5 索引。
范围：显式用户范围优先。项目知识写入项目已初始化的 knowledge/；个人与跨项目知识写入 SECOND_BRAIN_DIR 或 ~/second-brain/。若请求的项目 bundle 缺失，应提议 init，绝不静默写入全局。从项目根目录运行，项目命令在子命令前加 --vault knowledge。
召回：优先搜索项目知识，无相关结果再搜索全局；索引或匹配不可用时用 rg。读取最佳 1–3 条匹配并追踪其证据。命令示例：uv run <skill-dir>/scripts/sb.py --vault knowledge search "<terms>" -n 5 与 uv run <skill-dir>/scripts/sb.py search "<terms>" -n 5。需尊重 draft、deprecated 与过期 stale_after；source captures 无生命周期状态；verified 是独立信任元数据，不改变状态。
捕获与编译：捕获不等于整合。正常持久化以将受支持的可复用成果整合进维护页面结束，或明确说明原因与目标后推迟。add 与 idea 始终写入 notes/；page 选择维护文件夹。已有项目文件（含 data/ 下文件）保持原位，从 sources/ 引用而非复制到 _raw/。新笔记与来源捕获使用 notes/YYYY-MM-DD/slug.md 与 sources/YYYY-MM-DD/slug.md。页面修订需提交完整正文与完整来源/关联集，并附当前 --expect-sha256 与 --reason；用 --supersedes 更正原子声明。
完成契约：正常持久化要求每个受支持的可复用成果反映在合适的维护页面中，或明确推迟；成功的 add、capture、index 或 lint 不代表已整合。保留来源与分歧，绝不存储机密、静默改写事实历史，或因已编译就提升不确定声明。分别报告捕获、已编译页面与推迟/未决问题。
限制：资料未提供具体收费、平台支持范围或性能数据；初始化不授权重组已有文件；只读维护不授权写入或综合。