pr-reply 用于为 PR 评审评论起草回复。它基于项目的权威依据(specs、ADRs、CHANGELOG、代码、过往 PR)生成仅文本的回复草稿,用户需自行发布到 GitHub,该技能不会直接发布。
主要能力包括:支持引用评论加文件引用、GitHub 评论永久链接(可用 gh api /repos/.../pulls/comments/<id> 获取 body、path、line、diff_hunk、user、in_reply_to_id 等字段)、PR 编号(可用 gh api 批量拉取评审评论)以及内联粘贴的代码块。它会按顺序查找权威依据:docs/specs/.md、docs/adrs/.md、CHANGELOG.md、git log -- <file>、gh pr list --search 以及代码本身。随后将评论分类为已决定、范围内有效、范围外有效、误解、表扬或小问题,并据此选择回复结构。
语气要求:仅英文输出;像真人一样,不使用破折号;友好但不谄媚;通常 1 至 3 句,最多一段;具体引用文件、决策或 PR 编号;默认不加表情。
规则与限制:绝不编造决策、规范章节或 PR 编号,只引用已核实内容;绝不发布到 GitHub;引用行号或 PR 编号前必须先核实存在;指向规范时使用真实文件名;多条评论需分别起草回复。
错误处理:未提供 PR 评论时,要求提供引用文本和文件/行号;所引规范或决策不存在时,说明并重新分类;若评审者的问题揭示真实缺陷,则提醒用户并建议在范围内修复。另见 code-review(审查 PR)与 create-pull-request(创建被评论的 PR)。