SuperAPI AI 工具集

pr

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:在撰写或更新 PR 正文时使用。按固定顺序套用模板:Summary、Changes、Evidence、Merge Danger、Related Issues。

主要能力:Summary 用最小可视化加一两句说明改动形态;Changes 按意图分组列出分支上每个提交的大致条目;Evidence 以 before/after 给出实际运行的证据;Merge Danger 记录 Door(可逆性)、Blast Radius(影响范围)、Release;Related Issues 每个标识一条。存在 GLOSSARY.md 时使用其领域术语。正文描述分支上全部提交,而非仅最新提交。

输入:先读分支,运行 git log --no-merges origin/<base>..HEAD 与 git diff origin/<base>...HEAD。<base> 为调用方传入值,否则对已有 PR 用 gh pr view --json baseRefName -q .baseRefName,否则为 main。调用方(如 send-it)可提供 Base、Release note、Related issues、Evidence,提供时按原样使用;独立使用时自行推导:Release 依分支上最高变更级别的 Conventional Commit 类型(feat→minor,fix/perf/revert→patch,! 或 BREAKING CHANGE:→major,其它→no release (<type>-only));相关 issue 取分支名和提交信息中的跟踪器标识。

保留区:<!-- pr:keep --> 与 <!-- /pr:keep --> 之间的内容属人工所有,每次重新生成正文时原样带过。更新时先用 gh pr view <number> --json body -q .body 读取当前正文,逐字节复制保留区,写入新正文时按原顺序放回空区域位置,保存到文件并用 --body-file 发布,避免 shell 转义。只有开头标记时保留至正文末尾并补上结束标记;无标记则不携带,新正文放空区域;创建时输出空区域。

证据要求:只写本次会话实际运行或调用方报告的(本地测试、lint 预检、手动检查)。CI 通常在写正文时尚未运行,只有看到结果才写。未运行任何内容时写 Not run locally. 并说明什么能证明。

限制:模板与流程为规定性内容;缺失事实(如具体价格、平台支持、效果数据)暂未提供。