用途:为个人小项目到多人长期仓库提供一致的 Git 工作流规范,帮助开发者与编码智能体不再各自即兴决定提交信息、分支名和发布方式。默认偏好干净、线性、可审查的历史。
主要能力:按层级划分工作流(单人直接提交 main、prod/dev 分离、团队 PR 流程),并提供提交信息规范(Conventional Commits,含 AI 来源尾注 AI-Assisted-By、Agent-Transcript、Agent-Plan)、分支命名约定、线性历史合并与同步配置、并行智能体使用 git worktree 隔离、语义化版本与发布打标签、分支清理等。配套脚本 scripts/branch-status.sh 可将本地分支分类为 active/merged/gone/stale;scripts/check-commit-msg.sh 用于校验提交信息。
使用方式:先按项目实际协作需求选择层级,再套用对应命令配方。提交前可用管道校验,例如:printf 'feat(auth): add token refresh\n' | bash skills/local/git-workflow/scripts/check-commit-msg.sh;安装提交模板:git config commit.template skills/local/git-workflow/assets/commit-template.txt;智能体提交校验:bash skills/local/git-workflow/scripts/check-commit-msg.sh --agentic --staged --file /path/to/commit-message.txt;线性历史配置:git config pull.rebase true 与 git config merge.ff only;打标签:git tag -a v1.4.0 -m "release: v1.4.0" && git push origin v1.4.0。
适用场景:需要提交信息统一、决定是否开分支或 PR、为并行智能体配置 worktree、打版本发布、清理混乱本地分支,或新建仓库并希望统一约定时。
限制:密钥泄露清理、转录文本处理交由 agent-history-hygiene 技能;GitHub 平台自动化由 github-workflow 组技能负责;一次简单 git add + commit 无需本技能。提交模板不影响 git commit -m。gh/glab 为可选,缺失时脚本退化为纯 git。加密签名为可选且由用户自行决定。其他细节暂未提供。