# Agent 协作说明（Codex / Cloud / Cursor / Claude / 其它 AI 工具通用）

本文件供所有在仓库内工作的 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
```

## 仓库边界

- `memind_adm` 可以独立开发，但共享用户、权限、策略、技能、计费体系必须继续复用 `Memind` 主实现。
- 发版须 Git commit，禁止本机直 `rsync` 到 `103/105`。
- 共享用户、计费、空间额度、策略同步相关改动必须保留业务验收记录。