Agent Builder 的自动分支机制与 Main 保护

为什么自动 Branch 是关键设计

Agent Builder 每次执行改动都会自动创建一个新的 Branch，并以你的请求内容命名（比如 add-refund-flow、rewrite-billing-topics）。Main 分支永远不会被 Agent Builder 直接修改。

这个设计解决了 Agent Builder（以及任何 AI 辅助构建工具）的最大风险：AI 可能生成质量不稳定的配置。通过 Branch 隔离，即便 AI 生成的东西有问题，你也可以：

• 在 Sandbox 里测试发现问题
• 直接丢弃这个 Branch（删 Branch 即可，Main 不受影响）
• 或者 review 后手动修改 Branch 再合并

Agent Builder 的 Branch 生命周期

请求 → 自动创建 Branch → 写改动到 Branch → Agent Builder 完成
                                         ↓
                                    你 review → Sandbox 测试
                                         ↓
                                    确认 OK → 合并回 Main → 发布到 Live
                                         ↓
                                    有问题 → 丢 Branch（Main 不受影响）

Branch 命名规则

Agent Builder 创建 Branch 时会自动生成一个可读的名字，基于你的请求内容。比如：

• 请求："Add a refund Flow with a 30-day window" → Branch 名：add-refund-flow
• 请求："Rewrite the store hours topic" → Branch 名：rewrite-store-hours-topic

这个命名规则让多个 Agent Builder 会话（或者多个 Agent Builder 用户）生成的 Branch 不会互相冲突，也方便事后追溯"当时为什么建这个 Branch"。

Main 分支上的保护

Agent Builder 完成工作后，Branch 切换不会自动切回 Main——它会保持在新建的 Branch 上，直到你手动切回去。这是一个隐性的安全提示：你现在看到的所有配置都在 Branch 上，不是生产环境。

如果你不小心在 Branch 上又点了 Agent Builder，它会继续在这个 Branch 上叠加改动——不会又建一个新的 Branch。你可以随时在 Deployments 面板里切回 Main，此时 Agent Builder 会提示"你现在在 Main 上，新建一个 Branch 来工作"。

和手动 Branch 工作流的对比

两种方式可以共存——同一个项目里，你可以手动建 Branch 改一些东西，同时让 Agent Builder 在自己的 Branch 上改另一些东西，最后一起合并回 Main。