用途:约束 AI 智能体执行 git 操作,避免因破坏性命令丢失未提交的工作。规则源自真实事故:一次 git checkout -- . 抹掉了两天的工作。
主要能力与规则: 一、任何 git 命令前先运行 git status 并阅读结果。若有已修改或未跟踪文件,先说明现状,再就可能触及这些文件的操作征求同意;用户需要干净工作树且想保留工作时,建议 git stash push -m "<why>"。 二、以下命令必须获得明确批准,代理不得自行运行:git reset --hard(丢弃所有未提交改动)、git checkout -- <file> 或 git restore <file>(丢弃该文件改动)、git checkout -- . 或 git restore .(丢弃所有文件改动)、git clean -fd(删除所有未跟踪文件和文件夹)、git stash drop 或 git stash clear(删除暂存工作)、git push --force 或 --force-with-lease(覆盖远端历史)、git branch -D(删除分支及其独有提交)、在共享分支上 git rebase(改写他人已有的提交 ID)。明确批准指用户看到该条命令并同意,早前的笼统“继续”不算。 三、用户说 revert/undo/go back 时:先确认是哪处改动、是否已提交、是全部还是部分;用 git diff <file> 查看将丢失的内容;阅读当前文件;手工编辑删除错误行并保留其余内容;展示结果。不要使用 git checkout / git restore,它们会删除整个文件中的所有改动。对已提交改动,git revert <sha> 是安全的(生成新提交),但要先展示 sha 和提交信息。 四、丢弃任何改动前都先让用户看到对应 git diff;diff 过长时先给 git diff --stat 并提供完整 diff。 五、除非用户在当前消息中要求,否则不要 commit、push、tag、publish 或 deploy;工作完成后打印建议的提交信息并停止。 六、可无需询问直接运行:git status、git log、git diff、git show、git blame;用户要求干净工作树时的 git stash push -m "<message>";用户要求提交时的 git add <specific files>;在干净工作树上 git checkout -b <new-branch>;展示提交后的 git revert <sha>。
检查清单:git 命令前确认已运行并阅读 git status、影响范围内无未提交工作或已获批准、已展示将被丢弃内容的 git diff、命令不在批准表内或用户已对这条确切命令说 yes;被要求 revert/undo 时确认改动对象与提交状态、手工编辑而非 checkout、保留用户未提及的一切。
适用场景:AI 编码代理或自动化工作流中执行 git 操作时。限制:本资料未提供安装命令、价格、平台与版本等信息。