@qmxme/pi-git-guard

在Pi环境中阻止破坏性Git操作的安全卫士

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@qmxme/pi-git-guard。
它的用途是:在Pi环境中阻止破坏性Git操作的安全卫士
完整的 Skill 内容见:https://321skill.com/skills/qmxme-pi-git-guard/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我将当前所有更改强制推送到main分支。” 它会拒绝执行`git push --force`并提示该操作已被阻止,建议你检查更改或使用常规推送。或者,当你让AI删除一个本地标签时,它也会拦截`git tag -d`命令,提醒你确认是否真的要删除。

介绍

在Pi环境中进行Git操作时,一个不留神就可能执行git pushgit tag -dgit reset --hard等具有破坏性的命令,导致代码丢失或远程仓库被污染。这个Skill就像一个安全门卫,专门拦截这些高风险操作,防止因误操作引发的事故。

使用时,你只需在Pi环境中正常进行Git工作流。当你尝试执行上述被保护的命令时,Skill会自动介入并阻止操作,同时给出明确的警告提示,让你有机会确认或取消。它无缝集成到你的开发流程中,无需额外的触发步骤。

这个Skill非常适合所有在Pi环境中使用Git的开发者,尤其是团队协作场景下的成员、刚接触Git的新手,或者任何希望为关键代码仓库增加一道安全防线的个人开发者。它能有效避免因手滑或命令记错造成的不可逆损失。

建议在个人开发环境和团队共享的Pi实例中都安装此Skill,将其作为一项基础安全配置。需要注意的是,它主要提供的是“防误触”保护,对于有意识的、经过审核的破坏性操作,你可能需要临时禁用或使用原生Git命令绕过。同时,请确保你理解被拦截命令的具体含义,以便在真正需要时知道如何安全地执行它们。

核心特点

与通用的Git钩子或客户端配置不同,此Skill专门针对Pi Agent环境设计,能直接拦截Agent发出的特定Git命令,从源头防止AI助手执行破坏性操作;它聚焦于`push`、`tag -d`、`reset --hard`这三个最高频且破坏性最强的操作,防护目标非常明确。

注意事项

不适合需要频繁执行受保护Git命令进行强制推送或硬重置的高级Git工作流场景。

常见问题

这个Skill会阻止所有git push吗?

是的,它会阻止在Pi中执行的所有`git push`命令,防止意外覆盖远程代码。

如何临时绕过保护执行命令?

需要在Pi环境外使用终端直接执行Git命令,或暂时卸载该Skill。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/qmxme-pi-git-guard/raw/index.md 读取 @qmxme/pi-git-guard 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。