docs: 恢复分支开发模式 - AI 不切换分支,默认多AI协作,经验沉淀不标注AI身份

This commit is contained in:
SpecialX
2026-07-10 13:46:47 +08:00
parent f15912c7ee
commit 6051f84a65
5 changed files with 557 additions and 372 deletions

View File

@@ -1,13 +1,15 @@
# AI 分配方案与架构设计外包流程
> 版本1.0
> 日期2026-07-09
> 适用范围Edu 微服务项目模块架构设计外包阶段
> 版本1.1
> 日期2026-07-10
> 适用范围Edu 微服务项目架构设计外包阶段已实施,进入持续开发阶段)
> 关联文档:[多 AI 协作指南](../standards/multi-ai-collaboration.md)、[004 架构影响地图](./004_architecture_impact_map.md)、[待开发功能路线图](./roadmap/pending-features.md)
>
> **状态说明**:架构设计外包三阶段(模块理解 → 模块架构设计 → 按图实施)已实施完成,各模块设计文档见 `services/<service>/docs/` 与 `apps/<app>/docs/`。当前进入持续开发阶段,所有 AI 工作默认按多 AI 协作模式进行。
---
## 1. 外包总流程:三阶段
## 1. 外包总流程:三阶段(已实施)
```
阶段 1模块理解 阶段 2模块架构设计 阶段 3按图实施
@@ -21,6 +23,8 @@
交付:理解确认书 交付:模块架构设计文档 交付:代码 + 更新图
```
> **三阶段已实施完成**。阶段 1 产出见各模块 `docs/01-understanding.md`,阶段 2 产出见各模块 `docs/02-architecture-design.md`,阶段 3 持续进行中。
**阶段 1 目标**:每个 AI 读懂自己负责的模块在架构中的位置、边界、契约(按需阅读,见 §4
**阶段 2 目标**:每个 AI 产出自己模块的内部架构设计,经过 coord 交叉审查后放行。
**阶段 3 目标**按设计文档写代码coord 定期巡检一致性。
@@ -103,11 +107,11 @@
### 4.1 全员必读(所有 AI无论模块开发还是全局工作
| 顺序 | 文档 | 说明 |
| ---- | ------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| 1 | [project_rules.md](../../.trae/rules/project_rules.md) | 项目强制约束(架构规则、编码规范、提交规范、多 AI 协作、直接 push main |
| 2 | [coding-standards.md](../standards/coding-standards.md) | 多语言编码标准 |
| 3 | [multi-ai-collaboration.md](../standards/multi-ai-collaboration.md) | 多 AI 协作指南§2.1 严格模块边界、§2.2 按需阅读、§3 直接 push main |
| 顺序 | 文档 | 说明 |
| ---- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| 1 | [project_rules.md](../../.trae/rules/project_rules.md) | 项目强制约束(架构规则、编码规范、提交规范、多 AI 协作、分支开发) |
| 2 | [coding-standards.md](../standards/coding-standards.md) | 多语言编码标准 |
| 3 | [multi-ai-collaboration.md](../standards/multi-ai-collaboration.md) | 多 AI 协作指南§2.1 严格模块边界、§2.2 按需阅读、§3 分支开发规则) |
### 4.2 模块开发按需阅读(只读自己模块,禁止读其他模块内部实现)
@@ -367,38 +371,48 @@ coord 收到全部 7 份设计文档后,执行以下审查:
## 9. 协作规则
### 9.1 单仓库并行开发
> **默认多 AI 协作**:所有 AI 工作默认按多 AI 合作模式进行,详见 [multi-ai-collaboration.md](../standards/multi-ai-collaboration.md)。
当前阶段采用**单仓库直接 push main**模式,不经过 PR
### 9.1 分支并行开发
采用**分支开发**模式,人类决策者维护分支:
- 人类决策者为每个任务/模块创建分支并分配给 AI
- **AI 禁止** `git checkout -b``git switch``git branch``git merge``git push origin main`
- AI 在分配的分支上 `git add``git commit` 提交,完成后通知人类合并
- 每个 AI 只能修改自己负责的目录(见 §3.2
- `packages/shared-proto/` 仅 coord 修改,其他 AI 只读
- `docs/``.trae/``infra/``.github/` 仅 coord 修改
### 9.2 唯一冲突文件处理
`pnpm-lock.yaml` 是唯一可能多 AI 同时修改的文件,冲突时:
`pnpm-lock.yaml` 是唯一可能多 AI 同时修改的文件,冲突时由**人类决策者**在合并时解决
```bash
git pull origin main --rebase
# 人类决策者操作AI 不执行)
git checkout main
git merge <branch>
# 冲突时:
git checkout --theirs pnpm-lock.yaml # 取远程版本
git checkout --theirs pnpm-lock.yaml # 取分支版本
pnpm install # 重新生成
git add pnpm-lock.yaml
git rebase --continue
git commit
```
### 9.3 提交规范
```bash
# 每个 AI 在自己的服务目录内工作
# 每个 AI 在自己的服务目录内工作(在分配的分支上)
git add services/<service>/...
git commit -m "docs(<service>): 模块架构设计文档"
# 或
git commit -m "docs(<service>): 阶段1理解确认书"
# 完成后通知人类决策者合并
```
> **不标注 AI 身份**commit message 不追加 `AI-Agent:` 等身份字段,经验沉淀不出现 AI 标识。
### 9.4 proto 变更流程
任何 AI 需要新增/修改 proto