SuperAPI AI 工具集

git-workflow

办公与效率

查看项目

更新于 10-15 20:35

技能介绍

用途:规范 Git 提交流程,覆盖提交、推送、分支命名与提交信息格式,适合多 Agent 共用同一 worktree 时按任务范围提交。

主要能力与用法:先运行 git status -sb 确认状态并确定本次任务负责的路径;用 (cd <skill_dir> && ./scripts/codex_git_commit.py) 获取 Assisted-by 信息,脚本须直接作为可执行命令运行,不要用 uv run python 或 python。创建范围受控提交使用 git commit --only -m "type(scope): concise summary" -m "Optional body explaining the change." --trailer "Co-authored-by: Name name@example.com" --trailer "Assisted-by: <agent-name>:<model-name>" -- <paths-owned-by-current-task>,无需提前 git add。提交后用 git show --name-status --oneline --no-renames HEAD 核对范围;推送前用 git status -sb 确认,再执行 git push <remote> <branch>。

提交信息:使用简洁精确英文,推荐 Conventional Commits 格式 type(scope): short summary,常见 type 有 feat、fix、refactor、docs、test、chore;breaking change 需标题加 ! 并在 footer 写 BREAKING CHANGE: 说明影响与迁移,关键字不可写错。标题正文用 -m,结构化 trailer 用 --trailer,多个 trailer 重复使用 --trailer,不要用多个 -m 拼 trailer block;可用 git show -s --format=%B HEAD | git interpret-trailers --parse 验证。shell 中提交标题或正文不要放未转义反引号。

路径范围:<paths-owned-by-current-task> 只含当前任务负责的文件或目录,大量生成文件优先传目录如 gen/;目录混有无关改动时改用更精确路径;同一文件混有他人改动时先停止说明,不要强行提交,也不要为提交而清理、reset、restore 或 stash 无关改动。

分支与推送:遵循仓库或用户的额外限制(受保护分支、发布流程、禁止自动推送);切换分支优先 git switch,恢复工作区或暂存区优先 git restore,尽量避免 git checkout;创建分支尽量遵循 Conventional Branch;Git 写操作默认串行,不并行执行多个 commit、push;遇到 .git/index.lock 先判断是否有其他活跃 Git 进程。更新 MR/PR 分支时默认优先 merge target branch 到 source branch,仅当用户明确要求 rebase 或仓库/平台要求线性历史时才用 rebase。

限制:资料未提供脚本内部实现、支持平台与错误处理细节。