SuperAPI AI 工具集

maintain-pr

部署与运维

查看项目

更新于 10-16 05:06

技能介绍

用途:对指定的、你拥有或负责更新的 Docker 文档 PR 执行一次维护流程,检查状态、修复可处理的问题、回复评审并汇报结果。因为用户要求维护 PR,该流程可能修改分支和 GitHub;若只是评审或评估他人提交的 PR,不应使用本流程。

使用方式:先收集 PR 状态,检查顶层评审与行内评论(空正文评审也可能含行级反馈),确认 PR 属于你或被授权更新后再检出或推送。使用命令: gh pr view <PR> --repo docker/docs --json state,title,url,headRefName,headRepositoryOwner,comments,reviews,reviewDecision gh pr checks <PR> --repo docker/docs --json name,state,detailsUrl gh api repos/docker/docs/pulls/<PR>/comments --jq '[.[] | {id, author: .user.login, body, path, line, in_reply_to_id}]'

主要能力:处理终态(已合并则报告最终状态并指出未回复评论;未合并关闭则阅读关闭原因并报告);诊断 CI 失败,区分 PR 引起还是先前存在,只修复 PR 改动文件中的可处理失败,对预先存在或上游失败只报告不改无关文件;遵循仓库格式、定向 lint、显式暂存、提交与推送说明,保留无关工作区变更。

评审反馈:把每条评论视为待验证的主张,仅在证据支持时实施,有证据的分歧要说明。每次修复后格式化并验证改动文件,提交并推送聚焦改动;对每个已处理线程回复改了什么或为何不改,回复末尾加准确智能体披露脚注(如 Generated by Codex),回复后再解决线程,必要时重新请求评审。回复行内评论命令: gh api repos/docker/docs/pulls/<PR>/comments --method POST --field in_reply_to=<COMMENT_ID> --field body='<RESPONSE>' 用 GraphQL 获取未解决评审线程 ID,只解决已处理的线程,不可不回复就静默修复。

限制与报告:仅适用于你拥有的 PR;不适用于仅评审他人 PR 的场景。最终按 PR 编号、标题、状态、CI、评审、已采取措施等项目报告。