用途:在推送或合并前对当前分支相对默认分支(main/master/trunk)的改动做多智能体缺陷审查,也可用于准备提交前的本地改动检查。
主要能力:并行派发多个专家代理查找缺陷,由验证器过滤误报,按严重程度排序,并生成持久化报告。发现分为三类:in-scope(本分支引入或加重)、out-of-scope bug(既有缺陷,进入项目级 backlog)、out-of-scope addition(本分支新增但规格未承诺的代码,由 Spec Compliance 专家标记,供逐 PR 决定保留/拆分/回退)。安全类发现只写入 paad/security/ 下,写入前需确保 paad/security/.gitignore 仅含一行 * 且 git 未跟踪该目录,否则不写安全发现并询问用户。backlog 仅支持显式删除,不会自动解决条目。
使用方式:调用时先声明 “Running paad:agentic-review v2.0.0”,随后按阶段执行,不得跳过验证。支持可选参数:无参数时审查当前分支相对默认分支的全部改动;一个参数可指定基线分支或路径过滤器;两个参数按“基线分支 + 路径”处理。若存在 paad/config/paad.md 或 paad/config/agentic-review.md,会读取并遵循其配置,最终答案首行标注 Config: <path>。
限制:对话已有历史时建议新开会话;处于默认分支、无改动、无法确定默认分支、参数含 git 可识别为标志的字符、参数同时是 ref 和路径、基线 ref 无法解析、路径过滤器不存在等情况会停止。存在未提交改动时会先询问是仅审查已提交状态还是等待提交。配置不能改变子代理类型或授予写工具。具体收费、平台与效果资料暂未提供。