用途:依据 C++ Core Guidelines 对 C++ 代码、模块或文件做并行代码审查,覆盖多个指南章节,并保持较高的违规判定置信度。
主要能力:先与用户确认审查范围(目标文件/目录、文件扩展名如 .cpp、.h、.hpp,以及排除项),范围明确后才继续。随后为 references/Content/ 中的每个指南章节各启动一个子代理,使用 agents/guideline-section-reviewer.md 模板,替换 SECTION_NAME、SECTION_FILE、TARGET_FILES_PATTERN、OUTPUT_DIR、DATE、FILES_COUNT、VIOLATION_COUNT 等参数,通过 Task 工具并行启动。每个子代理只依据其被分配章节的规则审查,将结果写入 <当前工作目录>/review/<SectionName>.md,报告文件路径、行号、代码片段和具体违规规则。全部完成后汇总生成 review/Summary.md,包含按章节、按文件的违规统计、高频违规规则、关键发现与建议。
使用方式:用户可指定具体文件、目录或仅使用部分章节(如仅 Resource Management 与 Error Handling)。等待子代理时用 TaskOutput,block=true,timeout=600000(10 分钟),并核对输出文件存在、无源文件被修改。
限制:不得修改被审查文件,写操作仅限 review/ 目录;主会话只做协调,不亲自审查;每个违规必须对应具体规则,无法映射的不算;只报告高置信度违规,不确定的省略;只报告违规,不报告符合规范的代码;跨章节违规不由单个子代理报告。指南参考文件位于 references/ 目录,含 Introduction.md 与 Content/ 各章节。