diff --git a/docs/architecture/ai-allocation.md b/docs/architecture/ai-allocation.md index 25fbdac..c27efb8 100644 --- a/docs/architecture/ai-allocation.md +++ b/docs/architecture/ai-allocation.md @@ -366,11 +366,34 @@ coord 收到各 AI 的 contract.md 后,执行以下审查: ### 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 add` → `git commit` 提交,完成后通知人类合并 +- 各模块分支开发完成后,由 coord 合并到 `release/integration` 进行集成测试 +- 集成测试通过后,由 coord 将 `release/integration` 合并到 `main` - 每个 AI 只能修改自己负责的目录(见 §3.2) - `packages/shared-proto/` 仅 coord 修改,其他 AI 只读 - `docs/`、`.trae/`、`infra/`、`.github/` 仅 coord 修改