forge-reflect-pr 用于在请求同行评审前对当前 PR 分支做自我审查。无需主参数,直接作用于当前分支,可选末尾附加 -- <额外上下文> 作为审查重点,未提供时使用默认清单。
主要能力与流程:
- 识别变更:通过 git symbolic-ref refs/remotes/origin/HEAD 取默认分支,再用 git diff --name-only $DEFAULT_BRANCH...HEAD 收集改动文件与完整 diff。
- 审查:在运行时支持时委派给具有全新上下文的子代理,以消除自审偏差;否则内联执行。审查会读取 AGENTS.md 了解项目约定,并按 review-rubric.md 仅标记 P0/P1/P2。检查项包括重复代码、函数过长、命名、分层位置、死代码、模式一致性、配置(新环境变量是否有文档、有无硬编码凭据)、测试覆盖、文档更新(含搜索过期引用)与清理(调试日志、注释代码、未用导入等)。可用 grep -rn "<changed-pattern>" <search-root>/ 等方式检查模式一致性。
- 质量门:运行项目的 lint、格式化、类型检查与测试命令,修复并提交。
- 报告:以固定格式汇总发现与质量门结果。
- 分诊:对每个延后项询问用户是现在修复还是作为后续 issue;需延后时用 gh issue create --title "<title>" --body "<context and proposed solution>" 创建。
适用场景:用户完成 PR 实现、准备请人评审前的自检。限制:不替代同行评审;仅标记 P0/P1/P2,不输出 P3;具体命令与行为依赖运行环境是否支持子代理。官方未提供收费、价格与平台信息。