SuperAPI AI 工具集

pr

办公与效率

查看项目

更新于 10-16 08:05

技能介绍

用途:从当前分支状态创建草稿 PR(draft PR),把工作目录中的改动整理成干净、文档完整的提交与描述。

主要能力:暂存并提交未提交改动(使用语义化提交信息);从分支名或近期提交中读取关联 issue;撰写解释决策而非罗列 diff 的 PR 正文;执行视觉 QA 与 dogfood QA 步骤;创建草稿 PR 并可追加复盘条目。

PR 正文要求(强制):必须包含六个章节——Summary(改了什么、为何重要并链接 issue)、Changes(改动清单并引用关键文件/函数)、Acceptance Criteria(从 issue 复制或推导,用复选框)、Manual QA(逐步验证说明,含设置、命令、预期输出、URL)、What Changed(按变更类型选择 Mermaid 图,如新增功能用 graph TD、修复用 stateDiagram-v2、重构用 Before/After 两张图、数据模型用 erDiagram、API 用 sequenceDiagram;若一句话可解释则省略)、Before/After(展示前后状态,面向用户改动需截图)、Test Coverage(指向具体测试文件与函数,说明未覆盖部分)。

工作流:Clean(提交未提交改动)→ Context(读 issue、对比 main、识别测试)→ Visual QA(若涉及前端文件则运行 /visual-qa,修复 P0/P1)→ Dogfood QA(运行 /dogfood http://localhost:3000,修复 P0/P1 后再开 PR)→ Describe(标题来自 issue,正文符合上述要求)→ Before/After → Open(gh pr create --draft --assignee phrazzld)→ Comment(可选补充上下文)→ Retro(若关闭 issue 则追加反馈)。

Retro 命令:/retro append --issue $ISSUE --predicted {effort_label} --actual {actual_effort} --scope "{what_changed_from_spec}" --blocker "{blockers}" --pattern "{insight}",用于 /groom 校准后续估算。

输出:PR URL,以及(若关联 issue)追加到 .groom/retro.md 的复盘条目。

限制:资料未提供该技能的收费、价格、平台兼容性与具体安装步骤;依赖 gh 命令行、jq 等工具的可用性亦未说明。使用前需确认本地环境具备相应命令。