SuperAPI AI 工具集

make-pr

编程与开发

查看项目

更新于 10-16 03:11

技能介绍

用途:make-pr 是评审的提交方配套技能,把变更理由从 diff、提交信息和实现对话中提取出来,写入评审者会看的位置(PR 正文与行内评论)。若变更原因无法还原,会向用户询问,不自行编造。

主要能力:确定固定基点(用户提供的 ref,否则 main),采集 git diff <fixed-point>...HEAD 与 git log <fixed-point>..HEAD --oneline;按顺序从 diff、提交信息、当前对话收集理由,可选参考 .scratch/<feature>/decisions.md、docs/adr/ 中涉及 diff 路径的 ADR、关联 issue/PRD,但不强制要求,缺失时不输出占位符。按 TEMPLATE.md 组装 PR 正文,源为空的章节省略;若 diff 涉及前端文件,按 SCREENSHOTS.md 处理截图。行内评论针对评审者可能质疑的决策点(被否决的替代方案、非显而易见的约束、看似有误实则正确的点),格式为 { file, line, body },每条不超过 3 句,回答“为何这样做”而非“做了什么”,每个 PR 最多约 5 条,无合格项则不发布。

使用方式:先预览组装好的正文、行内评论列表与推送计划,等待明确批准后再执行:无上游时 git push -u origin <branch>,否则 git push;随后 gh pr create --title "<title>" --body-file <tmp>;再通过 gh api repos/{owner}/{repo}/pulls/{n}/comments 逐条发布行内评论;最后打印 PR URL。

适用场景:需要为已有实现生成可读、可评审的 PR 描述与行内说明时。

限制:不编造理由;可选资料缺失时不生成占位内容;行内评论数量与长度受限;具体模板与截图规范内容暂未提供。