SuperAPI AI 工具集

pull-request

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

该技能面向 PR 的创建与维护,目的是让每个 PR 易于理解、审阅、验证和合并,同时保留问题可追溯性、当前证据、提交历史和贡献者归属。仓库自身的贡献指南、PR 模板、必需检查和合并策略优先于默认约定。

用途与主要能力:撰写和更新 PR 描述与标题;用 Closes、Advances、Related、Issue 等关系关联问题;处理堆叠 PR;判断何时拆分变更;识别数据库、gRPC/protobuf、REST、SDK、UI、CLI 等持久边界变化;维护提交历史与作者归属;每次推送后同步描述并关注 CI 与反馈;判断 PR 何时可标记为就绪及合并。

使用方式:默认描述结构包含问题链接、In plain terms、Summary 和 Tests;堆叠 PR 声明 Advances、Depends on、Followed by 等关系;合同先行工作区分 Contract、Structure、Implementation 模式。常用命令包括 gh pr view、git diff --stat <base>...HEAD、git diff <base>...HEAD、gh pr checks --watch、gh pr create --draft --title "..." --body-file <file>、gh pr edit <number> --body-file <file>。

适用场景:需要保持 PR 简短可读、证据可查、边界变化清晰、历史和署名完整的协作流程,尤其适合堆叠 PR、合同先行开发和多人协作仓库。

限制:仓库约定优先;推送、开草稿、标记就绪、合并、部署视为不同的授权操作,只执行已授权的阶段;不重写已发布历史,不默认压缩合并;描述不得声称分支中不存在的工作。该技能不负责模式选择、人类同意阶段、实现授权等生命周期决策,这些属于 agentic-development 技能。