用途:这是一个统一的 Git 工作流技能,用于在提交、分支、拆分改动、管理分支栈、创建 worktree 或清理分支时指导智能体。它会检测环境中是否存在 Graphite(gt)或原生 Git,并在可用时优先使用 Graphite。
主要能力:提供 status、commit、split、stack、worktree、clean 等命令。status 检测 gt/git、报告分支、脏文件与栈状态;commit 按约定格式引导提交(gt create 或 git commit);split 分析 diff、建议拆分点并引导分解;stack 展示栈状态并创建/重排/同步分支;worktree 创建隔离工作区并安装依赖、建立测试基线;clean 移除已合并或已消失的分支及关联 worktree。
使用方式:任何 Git 操作的第一步都是运行 scripts/git-workflow status 检测环境。提交用 git-workflow commit --message "feat: ...";拆分大改动先读 references/splitting-changes.md 再运行 git-workflow split;创建隔离工作区用 git-workflow worktree --branch feat/name。参考文件包括 references/graphite-guide.md、references/git-best-practices.md、references/splitting-changes.md。
适用场景:功能开发(status → work → commit → stack)、大改动分解、并行智能体隔离工作、合并后清理、提交推送后配合 github-pr 技能创建 PR。
限制与安全护栏:禁止对 main/master 执行 git push --force;禁止 git add . 或 git add -A,需暂存具体文件;禁止用 --no-verify 跳过钩子;未经用户明确指示不得 git reset --hard;提交前始终核对已暂存文件。具体安装方式与更多细节暂未提供。