SuperAPI AI 工具集

skill-finish-branch

编程与开发

查看项目

更新于 10-16 02:34

技能介绍

用途:在开发分支实现完成后执行收尾流程,覆盖测试、审查、版本与变更日志、提交推送、创建 PR 或合并/丢弃。

主要能力:按项目类型自动检测并运行测试(package.json 用 npm test,pytest.ini/pyproject.toml 用 pytest,Cargo.toml 用 cargo test,go.mod 用 go test ./...,Makefile 含 test 目标用 make test);测试失败即停止。随后对相对主分支的 diff 做多提供方快速审查,发现严重问题会询问修复还是继续。可检测基础分支与 VERSION/version.txt/package.json,询问是否做补丁/次要/主要版本升级并生成变更日志条目。最后给出四个选项:创建 PR、本地合并、保持原样、丢弃。

使用方式:作为 Codex CLI 适配技能调用,交叉引用使用已安装技能名而非 /octo:* 斜杠命令。创建 PR 时先推送分支,再用 safe-gh-comment.sh 创建 PR,失败时用 gh pr list 检查是否已存在 PR。丢弃分支需输入 discard 确认,之后删除本地及远程分支。若使用 worktree,选项 1、2、4 会清理 worktree,选项 3 保留。

适用场景:Claude Octopus 工作流中 tangle(开发)或 ink(交付)阶段完成后,用户表示“完成,创建 PR”时。

限制:执行契约要求不得跳过或模拟工作流命令,不得在未检查实际文件或命令输出的情况下声称提供方输出或验证产物存在;所需提供方、命令或宿主能力不可用时须报告并采用受支持的回退。不得在测试失败时继续,不得未经确认丢弃分支,不得静默删除远程分支或强制推送。具体提供方、模型与宿主子代理能力以当前会话实际暴露为准。