SuperAPI AI 工具集

git-workflow

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

用途:根据项目自身配置自动化 Git 工作流,包括提交、推送与 PR、发布、分支创建和分支清理。配置来自仓库根目录下的 .claude/git-workflow.local.md,使用 YAML frontmatter 描述分支策略、提交规范和发布流程;若无该文件,技能会先引导交互式设置,再继续执行原本请求的工作流(分支清理除外,其不依赖配置)。

主要能力:可通过“commit”“PR”“release”“new branch”“clean up branches”“setup”等意图触发对应流程。提交流程会分析暂存、未暂存与未跟踪变更,扫描 .env、含 credential/secret/token/password 等常见敏感文件并默认排除,列出文件供选择,参考最近 5 条提交信息生成提交消息并等待确认,再用显式路径 git add 和 HEREDOC 执行 git commit,若 pre-commit hook 失败则展示输出并建议修复,不使用 --no-verify。推送与 PR 流程会做预检、确认后推送、按配置选择基础分支,用 git log 与 git diff 收集范围,生成不超过 70 字符的标题和含 Summary、Test plan 的正文,经用户确认后以 gh pr create 创建并显示 URL;若分支名匹配 feature/<number>-* 或 fix/<number>-* 会追加 Closes #<number>。发布流程会校验当前分支与工作区状态、拉取最新代码、合并集成分支到发布分支(冲突则中止并列出冲突文件)、依据版本格式和最新 tag 计算版本、更新 manifest 版本字段、创建附注 tag,确认后推送分支与 tag 并切回集成分支。分支创建会从配置的集成分支拉取最新代码后新建分支。分支清理会执行 git fetch --prune,找出上游标记为 [gone] 的本地分支,排除当前分支和受保护分支,确认后用 git branch -d 安全删除,失败时说明原因并询问是否用 -D 强删或跳过。

使用方式:在仓库内以自然语言表达意图即可,首次使用需完成交互式配置;分支清理只需 git 命令。

限制与安全规则:绝不未经用户明确要求强制推送;不提交可能含机密的文件;破坏性操作前必须确认;不修改 git config;不使用 git add -A 或 git add .。配置文件完整字段与默认值见 references/config-schema.md。资料未提供更多平台、收费或安装方式。