SuperAPI AI 工具集

pre-push

通用与其它

查看项目

更新于 10-16 02:39

技能介绍

用途:pre-push 负责发布前的集成与就绪检查,让授权分支达到可发布状态。它本身不授予推送、PR 或合并权限;工作区隔离、目标基线、门禁命令、警告严重级别以及是否需要规格链接或琐碎例外,均由 AGENTS.md 与仓库工作流定义。

主要能力:编辑前先检查分支、工作树与工作区状态;确定实际远端与目标基线(可能不是 main);通过配置的远端刷新基线并记录其 SHA;按仓库的集成路线执行,门禁自带合并预览时满足其干净树前提并直接运行该门禁;否则在任务工作树中合并目标基线;本地解决冲突,梳理未解决路径、协调各方改动意图、暂存结果并先跑相关门禁;保留双方 changelog/registry 条目;用所属工具重新生成 lockfile 与生成资产,不手工编辑;共享文档按章节意图协调;只在保留合并前成果的前提下中止失败合并。

使用方式:运行仓库强制性门禁及基于 diff 的检查;区分建议性警告与阻断性警告;工具缺失、origin 访问或环境未就绪属于受阻而非通过;不压制失败、不弱化断言、不绕过钩子。需要 SDD 时确认规格存在且阻塞决策已解决,缺失时用 issue-spec;允许琐碎例外时按仓库定义说明理由。发布授权后通过 Git 传输或连接的 GitHub API 发布已验证分支,传输失败时用可用的等效认证方式;API 发布树时保留模式、删除与父系并校验树一致性;不强制更新受保护/长期分支。PR 创建与更新交给 pr-lifecycle。

适用场景:分支合并前的集成准备、冲突解决、门禁运行与授权发布。

限制:获取被阻断时应报告基线/合并门禁无法验证,不得声称离线集成成功;缺失可选工具不阻断独立工作或可评审的 PR 准备,但需说明验证局限;未解决的决策应通过 harness-operations 的结构化提问能力提出并等待;无此门禁的仓库不会因此技能获得门禁;文档类改动可能减少检查,但仍需基线新鲜度与声明的贡献门禁。