用途:审查从某个固定点到 HEAD 的代码改动。固定点由用户指定,可以是 commit SHA、分支名、tag、main、HEAD~5 等;未指定时需向用户询问。
主要能力:双轴并行审查。标准轴检查 diff 是否违反仓库文档化的编码标准(如 CODING_STANDARDS.md、CONTRIBUTING.md),区分硬性违规与主观判断,跳过工具已强制执行的项。规格轴检查是否忠实实现原始 issue/PRD/spec,报告缺失或部分实现的需求、未要求的行为(范围蔓延)以及实现有误的需求,每条发现引用规格原文。两轴作为并行子代理运行,避免上下文互相污染,最后汇总。
使用方式:先用 git diff <fixed-point>...HEAD(三点,与 merge-base 比较)捕获 diff,并用 git log <fixed-point>..HEAD --oneline 记录提交列表;确认固定点可解析(git rev-parse <fixed-point>)且 diff 非空。规格来源按顺序查找:提交信息中的 issue 引用(如 #123、Closes #45、GitLab !67)经 docs/agents/issue-tracker.md 的工作流获取;用户传入的路径;docs/、specs/、.scratch/ 下与分支名或功能匹配的 PRD/spec 文件。若缺少 docs/agents/issue-tracker.md,需先运行 /setup-utarn-skills。未找到规格时询问用户,若确认没有则规格子代理跳过并报告“no spec available”。随后以两条 Agent 工具调用并行生成两个通用子代理,汇总时按 ## Standards 与 ## Spec 分别呈现,不合并、不重排,最后给出一行摘要:各轴发现总数与各轴最严重问题,不跨轴选唯一赢家。
适用场景:需要同时评估代码质量合规性与需求实现正确性的变更审查。
限制:固定点必须有效且 diff 非空,否则应在此阶段失败而非进入子代理;规格缺失时只能进行标准轴审查;每个子代理的报告限制在 400 词内。