用途:面向 Git 日常操作的安全与治理助手,覆盖本地隔离开发、提交与推送、PR 流程、分支与工作树生命周期、CI 额度治理、敏感历史撤回和仓库瘦身等场景。每个操作前按场景路由读取对应参考合同,不一次性加载全部文档。
主要能力:本地 worktree 隔离开发与交付;Skill/套件稀疏检出(创建用 scoped-worktree.py,完整登记只读审计用 sparse-worktree-audit.py);提交身份与 Co-authored-by 污染检查、隐私预检;经 safe-push.sh 发表普通提交、经 safe-pr.py 创建或合并 PR;主目录固定 main 的分支保护(命令前门禁用 main-git-gate.py / test-main-git-gate.py);事故恢复(误 amend、stash、删分支、reset);分支与工作树只读盘点(branch-audit.sh / worktree-audit.sh)及清理;CI 额度治理与历史撤回、膨胀审计。
使用方式:将 git_workflow_dir 设为技能安装目录的绝对路径,在目标仓库运行;脚本名均相对技能目录。依赖 Git、Bash、Python 3.10+(macOS: brew install python,Linux: apt install python3)和 GitHub CLI(macOS: brew install gh),Python 入口仅用标准库,无需 pip 安装。
适用场景:单任务隔离开发到交付、共享主树被占用、PR 创建审查合并、主目录防误切换、历史敏感材料撤回、仓库体积膨胀治理。
限制:副作用操作前需固定目标、依赖、基准与磁盘预算;force push、reset --hard、丢弃修改、clean -f、强删分支、跳过 hooks/签名及改写历史须具体明确授权;身份与隐私须核验完整 PR range 并绑定不可变 OID,不用 HEAD~1 缩窄范围;合并需授权、可读 diff、独立 review 和最终 checks。主目录默认只读,命令门禁默认拒绝主目录 add/commit,仅具名 owner 与匹配 expected HEAD 可进入采用路径。缺工具不自动安装、不降级绕门禁。文档所述方法不替代用户对外部写入或破坏性操作的授权。具体收费、价格与效果资料暂未提供。