From 5144ec729269f10d1a01eb80a2e7cf54ce2bd484 Mon Sep 17 00:00:00 2001 From: SpecialX <47072643+wangxiner55@users.noreply.github.com> Date: Fri, 10 Jul 2026 14:07:02 +0800 Subject: [PATCH] =?UTF-8?q?docs(docs):=20=E6=9B=B4=E6=96=B0=E5=88=86?= =?UTF-8?q?=E6=94=AF=E7=AD=96=E7=95=A5=E4=B8=BA=2017=20=E9=95=BF=E6=9C=9F?= =?UTF-8?q?=E5=88=86=E6=94=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture/ai-allocation.md | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) 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 修改