用途:审计 ByteRover 知识库的健康状况,发现过时条目、覆盖缺口,并输出可执行的修复命令。适用于重大重构或依赖升级后、按周期(每月或每个迭代)维护知识质量、怀疑知识漂移(文档模式与代码不符)时,以及在有既有文档的区域开发新功能前。
前置条件:先运行 brv status;若出现错误,需让用户在 brv 终端中解决,详见 byterover 技能的 TROUBLESHOOTING.md。
流程分五个阶段。阶段一盘点现有知识,用 brv query 查询技术栈与依赖、架构与项目结构、约定与编码模式、测试方法与框架、集成与外部服务、关注点与技术债等主要领域,记录是否有实质内容、具体程度与时效线索;若多数领域无返回,应停止并建议先运行 byterover-explore。阶段二对照代码库交叉验证:读取 package.json、requirements.txt 等确认依赖与版本,核对目录结构、入口点与分层边界,读取 lint/格式化配置并抽样源文件核对命名模式,核对测试框架配置与测试文件模式,读取 .env.example 核对集成与新增 SDK。阶段三判定过时:引用文件不存在、函数或类被重命名删除、模式与当前 lint 规则冲突、依赖被替换、架构与目录不符;记录知识原文、代码实际状态与严重级别(critical/moderate/minor)。阶段四做缺口分析:扫描顶层目录、新文件目录、未记录的环境变量、API 端点、配置、错误处理模式与部署构建流程。阶段五输出覆盖报告(各领域状态与问题数)与修复命令:过时条目用 brv curate "OUTDATED: [旧知识]. NEW: [当前状态]. Clean up old context." -f [相关文件],缺口用 brv curate "[领域]: [需记录内容]" -f [相关文件]。完成后优先修过时项再补缺口,可代为执行并再次查询验证。
规则:绝不读取 .env、.key、credentials.json 等机密文件;错误知识比缺失知识更糟,优先修复过时项;每条发现须附具体 brv curate 命令并引用实际检查的文件路径;如实评估覆盖度,含糊即评为部分覆盖;每次 curate 最多 5 个文件;存储关键上下文后用 brv curate view <logId> 验证,brv curate view --help 查看全部选项。