SuperAPI AI 工具集

git-expert

办公与效率

查看项目

更新于 10-15 21:39

技能介绍

Git Expert 是一个面向 Git 操作的技能,覆盖从功能隔离到 PR 提交的完整工作流,核心原则包括:使用 worktree 隔离工作以避免上下文污染、原子提交(每次提交对应一个逻辑变更)、提交或推送前始终验证、保持整洁历史。

该技能包含三个子技能:Worktrees(功能隔离与工作区搭建)、Commits(智能提交协议)、Finishing(分支收尾与 PR 提交)。

Worktrees 用于开始需要隔离的功能开发、执行实现计划前、同时处理多个分支,或需要不影响主工作区的干净基线。目录选择优先检查 .worktrees(隐藏)或 worktrees,其次查看 CLAUDE.md 偏好,否则询问用户。创建前必须用 git check-ignore -q .worktrees 验证目录已被忽略,未忽略则加入 .gitignore 并提交。创建步骤包括获取项目名、执行 git worktree add .worktrees/$BRANCH_NAME -b feature/$BRANCH_NAME、进入目录、按 package.json/Cargo.toml/requirements.txt/go.mod 自动安装依赖,并运行测试验证基线。

Commits 规定未经明确许可不得推送、强制推送、运行 git clean -fdx、修改 git config 或修改已推送提交。提交前需检查 git status、运行 lint/typecheck 与测试、审查 git diff --cached。提交信息格式为 {type}: {summary},类型含 feat、fix、refactor、docs、style、test、build、chore,多行信息使用 HEREDOC。

Finishing 在实现完成且测试通过后使用:先验证测试,确定基础分支,然后提供本地合并、推送并创建 PR、保留分支、丢弃工作四个选项。创建 PR 使用 git push -u origin 分支名与 gh pr create。丢弃需输入 discard 确认。分支命名按 feature/、fix/、refactor/、dev/name/ 等模式,main/master 为受保护分支。

限制与注意事项:不得跳过验证、未经许可强制推送、在 worktree 未被忽略时创建、提交密钥文件或使用含糊提交信息。该技能按需加载,与 tdd、verification、subagent-driven-development 等技能配合使用。