docs: 恢复分支开发模式 - AI 不切换分支,默认多AI协作,经验沉淀不标注AI身份
This commit is contained in:
@@ -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:
|
||||
|
||||
Reference in New Issue
Block a user