---
description: 标准化分支、测试、发布闸门（始终应用）
alwaysApply: true
---

# 标准化开发测试发布闸门

开始任何开发、修复、发布前，先读：

- `ENGINEERING_WORKFLOW_RULES.md`
- `PRODUCTION_RELEASE_RULES.md`
- `AGENTS.md`

必须遵守：

- 新建分支必须基于最新 `origin/main`，推荐执行 `bash scripts/new-branch.sh feature/xxx`
- 分支代码必须先合并进 `main`，确认 `main` 正常后，才允许发布
- 发布只能从完整 `main` 打整包，禁止从功能分支、单个 commit、单个修复或局部差异单包发布
- 发布前必须确认 CI 已通过，且没有未合并的关键变更
- 发布前必须重新检查当前分支是否落后 `origin/main`
- 发布来源必须是干净、可追溯的 Git commit
- 禁止从脏工作区、detached HEAD、落后主线的分支发布
- 禁止直接 `rsync` 到 `103/105` 或 SSH 到生产手改源码

发布前必须执行：

```bash
bash scripts/check-release-ready.sh
```

如需临时绕过，只能在用户明确批准后使用项目文档中记录的显式环境变量。