用途:为当前分支相对其基分支生成一套本地 PR/分支审查产物,把“预期”显式化,让审查有据可依。它只写审查文档,不修改实现代码,并以技术负责人(tech-lead)作为编排视角,内部流转到架构师(系统设计评审)与首席工程师(代码评审)两种视角。
主要能力:每次运行固定产出三份并排文档——system-design-review.md(架构师视角)、code-review.md(首席工程师视角)、walkthrough.md(技术负责人视角)。当分支上没有仓库内权威规格文件时,另写一份推断出的 review spec.md;若已存在则不重复,改为引用。
使用方式:先确定审查范围——默认审查当前分支,基分支在有 GitHub PR 时取 PR 的 base,否则取仓库默认分支;用户显式指定基分支时须严格遵守。抓取证据包括 git log --oneline origin/<base>..HEAD、git diff --name-only origin/<base>...HEAD、git diff origin/<base>...HEAD,并用 gh pr view --json number,url,title,body,baseRefName,headRefName 发现 PR。产物目录:仓库内有权威规格时放在其同目录的 reviews/ 下;否则放在 wip/ 下(仅本地、不得提交)。
适用场景:需要在本地对分支/PR 做结构化、可复核的多视角审查,并希望审查结论脱离上下文也能独立复读。
限制:不修改实现代码;规格是必需的预期基准,缺失时只能推断并标注来源与不确定性;不覆盖格式化、个人偏好类问题;未提供的具体价格、平台支持等信息暂未提供。