用途:在把仓库改动描述为“完成”之前,先做验证与代码审查。它不预设包管理器、框架或命令形式,而是从项目清单、脚本、文档、CI 配置和对话上下文中发现项目自己的检查方式。
主要能力:解析目标基线(用户或下游流程上下文、已有 PR 基线、明确的父集成分支,或仓库默认分支);用 merge-base 语义(如 <base>...HEAD)检查完整已提交分支差异,并额外检查暂存、未暂存和未跟踪的本地改动;查看提交列表与差异统计以发现范围异常或遗漏;发现并运行 lint、类型检查、测试、构建、格式化、生成代码检查、迁移等命令;按严重程度输出带文件与行号的审查发现,并给出验证结果与状态。
使用方式:先读取 AGENTS.md、README 及相关文档建立上下文;从 package.json、锁文件、工作区文件、Makefile、任务运行器、语言配置、CI 工作流等发现命令;JavaScript/TypeScript 项目先根据锁文件与脚本推断包管理器;默认运行全项目检查,用户要求或改动较窄时可用限定范围检查并说明范围;不臆造命令,缺失的检查类别报告为不可用或未运行。
适用场景:提交前自检、PR 审查、下游工作流作为验证门禁(仅当验证状态为 pass 才继续)。
限制:无法解析目标基线或完整分支差异时标记为 blocked;命令失败、被环境阻塞或未获批准时报告为验证缺口而非通过;必需验证失败时默认停止并报告失败命令、可能根因与最短修复路径,除非用户明确要求继续审查。