chore: enforce standard branch release workflow

AGENTS.md

@@ -1,10 +1,22 @@
-# Agent 协作说明（Codex / Cloud / Cursor / 其它 AI 工具通用）
+# Agent 协作说明（Codex / Cloud / Cursor / Claude / 其它 AI 工具通用）
 
-本文件供**所有**在仓库内工作的 AI 编码助手阅读，不限于 Cursor。
+本文件供所有在仓库内工作的 AI 编码助手阅读。仓库级开发、测试、发布规范以 [ENGINEERING_WORKFLOW_RULES.md](ENGINEERING_WORKFLOW_RULES.md) 为准；生产发布规范以 [PRODUCTION_RELEASE_RULES.md](PRODUCTION_RELEASE_RULES.md) 为准。
+
+## 必读：分支与发布闸门
+
+1. 新建分支前必须先同步远端主线，推荐执行 `bash scripts/new-branch.sh feature/xxx`。
+2. 发布前必须重新检查当前分支是否落后 `origin/main`。
+3. 发布来源必须是干净、可追溯的 Git commit。
+4. 禁止从脏工作区、detached HEAD、落后主线的分支发布。
+5. 发布前必须执行：
+
+```bash
+bash scripts/check-release-ready.sh
+```
 
 ## 必读：已验证回归守卫（勿轻易覆盖）
 
-下列行为经过长时间调试验证。**删改相关代码前必须先读文档并跑 verify**：
+下列行为经过长时间调试验证。删改相关代码前必须先读文档并跑 verify：
 
 | 主题 | 文档 |
 |------|------|
@@ -15,42 +27,35 @@
 ### 改相关文件前必跑
 
 ```bash
-# 单测 + 源码静态守卫
 npm run verify:mindspace-publish-guards
-
-# 发 Portal runtime 后（含 bundle 检查）
 npm run verify:mindspace-publish-guards:full
 ```
 
-发版脚本（`scripts/release-prod.sh`、`scripts/release-portal-runtime-prod.sh`）在未 `--skip-tests` 时也会执行上述 verify。
+发版脚本（`scripts/release-portal-runtime-prod.sh`）在未 `--skip-tests` 时也会执行相关 verify。
 
 ### 受保护的关键路径
 
-- `mindspace-public-finish-sync.mjs` — `edit_file` 必须 materialize 到 `public/*.html`
-- `chat-finish-sync.mjs` — Finish / UpdateConversation **merge**，禁止盲覆盖
-- `conversation-display.mjs` + `src/utils/message.ts` — 用户消息不得展示 routing/skill 内部前缀
-- `src/hooks/useTKMindChat.ts` — `syncSessionMessages` merge + 重试
-- `server.mjs` — session snapshot 需 `hint_mc` **且** `hint_ua` 才走缓存
+- `mindspace-public-finish-sync.mjs` - `edit_file` 必须 materialize 到 `public/*.html`
+- `chat-finish-sync.mjs` - Finish / UpdateConversation 必须 merge，禁止盲覆盖
+- `conversation-display.mjs` + `src/utils/message.ts` - 用户消息不得展示 routing/skill 内部前缀
+- `src/hooks/useTKMindChat.ts` - `syncSessionMessages` merge + 重试
+- `server.mjs` - session snapshot 需 `hint_mc` 且 `hint_ua` 才走缓存
 
 代码内搜索 `REGRESSION GUARD` 可定位所有内联说明。
 
-### 相关单测（已接入 `npm test`）
+### 相关单测
 
 - `mindspace-public-finish-sync.test.mjs`
 - `chat-finish-sync.test.mjs`
 - `conversation-display.test.mjs`
 
----
-
 ## Cursor 专用规则（其它工具请读上文文档）
 
 Cursor 额外加载：`.cursor/rules/mindspace-publish-chat-finish-guards.mdc`  
 内容与 `docs/regression-guards/mindspace-publish-and-chat-finish.md` 一致，仅为 Cursor 在编辑相关文件时自动提示。
 
----
-
 ## 仓库惯例
 
 - 本地开发：`pnpm dev`（见 [README.md](README.md)）
 - 生产隔离：[docs/service-isolation-runbook.md](docs/service-isolation-runbook.md)
-- 发版须 Git commit，禁止本机直 rsync 到 103/105（见 README）
+- 发版须 Git commit，禁止本机直 `rsync` 到 `103/105`