docs(docs): 更新分支策略为 17 长期分支

This commit is contained in:
SpecialX
2026-07-10 14:07:02 +08:00
parent 9ba368477d
commit 5144ec7292

View File

@@ -366,11 +366,34 @@ coord 收到各 AI 的 contract.md 后,执行以下审查:
### 8.1 分支并行开发 ### 8.1 分支并行开发
采用**分支开发**模式,人类决策者维护分支 采用**长期分支**模式,共 17 个分支15 模块 + coord + 集成)
- 人类决策者为每个任务/模块创建分支并分配给 AI | 分支名 | 负责 AI | 用途 |
| -------------------------- | ------- | --------------------------- |
| `feat/api-gateway-ai01` | ai01 | api-gateway 开发 |
| `feat/push-gateway-ai02` | ai02 | push-gateway 开发 |
| `feat/teacher-bff-ai03` | ai03 | teacher-bff 开发 |
| `feat/student-bff-ai04` | ai04 | student-bff 开发 |
| `feat/parent-bff-ai05` | ai05 | parent-bff 开发 |
| `feat/iam-ai06` | ai06 | iam 开发 |
| `feat/core-edu-ai08` | ai08 | core-edu 开发(含 classes |
| `feat/content-ai09` | ai09 | content 开发 |
| `feat/msg-ai10` | ai10 | msg 开发 |
| `feat/data-ana-ai11` | ai11 | data-ana 开发 |
| `feat/ai-ai12` | ai12 | ai 开发 |
| `feat/teacher-portal-ai13` | ai13 | teacher-portal 开发 |
| `feat/student-portal-ai14` | ai14 | student-portal 开发 |
| `feat/parent-portal-ai15` | ai15 | parent-portal 开发 |
| `feat/admin-portal-ai16` | ai16 | admin-portal 开发 |
| `feat/coord-coord` | coord | 共享包 + 契约 + 仲裁 + 文档 |
| `release/integration` | coord | 集成分支,合并各模块到 main |
**分支规则**
- 每个 AI 在自己的分支上 `git add``git commit` 提交
- **AI 禁止** `git checkout -b``git switch``git branch``git merge``git push origin main` - **AI 禁止** `git checkout -b``git switch``git branch``git merge``git push origin main`
- AI 在分配的分支上 `git add``git commit` 提交,完成后通知人类合并 - 各模块分支开发完成后,由 coord 合并到 `release/integration` 进行集成测试
- 集成测试通过后,由 coord 将 `release/integration` 合并到 `main`
- 每个 AI 只能修改自己负责的目录(见 §3.2 - 每个 AI 只能修改自己负责的目录(见 §3.2
- `packages/shared-proto/` 仅 coord 修改,其他 AI 只读 - `packages/shared-proto/` 仅 coord 修改,其他 AI 只读
- `docs/``.trae/``infra/``.github/` 仅 coord 修改 - `docs/``.trae/``infra/``.github/` 仅 coord 修改