用途:将代码评审发现对照 Pull Request diff 校验,并以 GitHub 行内评审评论形式发布。适用于用户提出“review and comment”等要求时。
主要能力:解析主机、owner、repo、PR 编号与仓库指令;用分页接口采集完整 PR 元数据、diff 与已有评审线程;获取候选发现;逐条校验其可证伪的代码主张、前置条件与具体失败场景,分类为 valid、partial、invalid 或 needs-context,并去重、跳过已提出的问题;把有效发现解析到精确 diff 位置后起草评论。
使用方式:通过 gh api 采集数据,例如 gh api --paginate "repos/{owner}/{repo}/pulls/{number}/files?per_page=100";发现需带 path、side、line、start_side、start_line、body、expected_head_sha 的封闭结构。发布前先冻结目标 head_sha 作为 expected_head_sha,展示包含事件类型(COMMENT、REQUEST_CHANGES、APPROVE)与全部行内评论的审批包,用户明确批准后才发布;发布命令为 gh api "repos/{owner}/{repo}/pulls/{number}/reviews" --method POST --input "${PAYLOAD_FILE}",随后回读校验 commit_id、事件与评论数。回复线程是独立的变更操作,需另行预览与批准。
限制:采集与起草为只读,发布、回复、请求变更、批准或驳回均属外部变更,须用户对具体载荷明确授权。head SHA 不一致时必须停止并重新校验;不猜测行号,无有效目标且影响重大的发现放入评审正文。不要直接发布外部评审输出;提交的评审与评论公开可见且难以可靠删除。参考资料 references/comment-format.md 与 references/voice-and-tone.md 需在起草前阅读。其余未提供。