AgentsGitFlowController

AI 编码代理越来越深入地参与仓库操作，但 GitFlow 对它们而言不过是一段写在项目指令里的软性提示。模型会跳过合并流程、直接推送受保护分支、甚至把本应由人工确认的归档合并当成普通操作完成。插件 AgentsGitFlowController 把「请遵守流程」的口头约定变成一道硬门禁：每条 git 命令在执行前都会被分类、对照分支角色配置，违规操作直接拒绝并附带原因与下一步建议。

核心机制是纯本地、配置驱动的分支角色守卫。你用一份 JSON 文件定义 integration、preview、production、archive 各角色对应哪些分支以及允许什么更新方式，插件在工具调用管道中拦截，不依赖任何远端服务。所有拒绝记录写入用户级审计日志，跨 worktree 共享，不会污染仓库。它兼容 Claude Code、Codex、Cursor、DeepSeek Harness 等九种客户端，无需为每个代理单独编写规则。

适合场景：有明确分支流的个人开发者或小团队，代理已经「抄过近路」（直推 develop、跳过 PR 合入），希望从结构上杜绝同类问题；也有多环境流水线的企业，在配置中追加角色即可扩展。若采用 trunk-based 单分支流或尚未定义任何分支角色，此插件并不适用。