用途:审计并修复 brave-core 最佳实践文档中的问题。需在 brave-core(src/brave)目录下运行,文档位于 ./docs/best-practices/,索引为 ./docs/best_practices.md。
主要能力:读取索引与全部文档后,检查跨文档重复规则(保留更合适分类中的版本并保留锚点 ID,不创建仅指向其他规则的引用桩);校验代码示例中的 brave/... 与 Chromium 文件路径是否存在,更新已重命名或移动的路径,文件被删除时改用真实存在的文件;校验 Chromium 与 Brave 的类名、方法名等符号是否仍存在并更新;检查失效的内部链接与锚点、明显错误的外部链接(不抓取);检查缺失或重复的 --- 分隔符、缺失锚点、标题层级不一致等格式问题;核对索引中列出的文档是否存在、是否重复、是否覆盖目录下全部文档。
使用方式:按步骤逐项检查,发现问题后直接用 Edit 修复并继续下一项;全部修复后运行 ID 校验命令:python3 ./script/manage-bp-ids.py --validate。
限制与注意:提交或 PR 中不得包含 Claude Code 署名;即使删除重复规则也不得移除锚点 ID,应将其移至保留版本;不得创建仅指向其他规则的引用桩;编辑时保持各文档原有风格;更新失效路径时选择上下文中合理的真实文件;对明显为占位符的路径(如 path/to/foo.h、brave/components/my_feature/my_header.h)应跳过。其他细节暂未提供。