用途:该技能只运行 review-framework 循环中的状态获取阶段,即抓取 PR 的规范审查状态、校验,并通过脚本渲染全部派生产物。适用场景是用户只需要状态获取(fetch、render、summarize)这一阶段时。
输入:必填 PR URL(如 https://github.com/OWNER/REPO/pull/123);可选输出目录。省略输出目录时按 wip/reviews/<owner>_<repo>_pr-<number>/ 推导。
主要能力:校验并解析 PR URL,计算确定性路径 <output-dir>/review-state.json、review-state.md、summary.txt、review-targets.json;生成前强制产出物安全(须被 git 忽略);抓取规范 JSON 并校验后派生文件;渲染 Markdown、生成文本摘要;提取确定性分流目标,包含未解决的 review threads、带正文的 pull-request reviews、带正文的 issue comments。
用法(在技能目录下运行,脚本路径相对该目录): node ./scripts/guard-review-artifacts-ignored.mjs --dir <output-dir> node ./scripts/fetch-review-state.mjs --pr <PR_URL> --out-json <output-dir>/review-state.json node ./scripts/validate-review-state.mjs --in <output-dir>/review-state.json node ./scripts/render-review-state.mjs --in <output-dir>/review-state.json --out <output-dir>/review-state.md node ./scripts/summarize-review-state.mjs --in <output-dir>/review-state.json --format text --out <output-dir>/summary.txt node ./scripts/extract-review-targets.mjs --in <output-dir>/review-state.json --out <output-dir>/review-targets.json
限制与错误处理:review-state.json 为规范文件,必须为 schema 版本 2,不提供 v1 向后兼容;派生产物可从规范 JSON 重新生成;审查产物是生成文件,必须保持不被 git 跟踪。抓取失败视为操作性错误。若 gh api 在沙箱中出现 TLS/证书错误(x509 / OSStatus -26276),快速失败并指示在沙箱外重跑;绝不关闭 TLS 校验。
输出:返回四个产物路径,并建议下一步 /review-triage-phase <PR_URL> [output-dir]。