63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
# 迭代目录与命名规范
|
|
|
|
**版本：** 2026-08-07
|
|
**适用范围：** `agent_ops/03.迭代规划/` 下的新迭代目录
|
|
|
|
## 1. 迭代目录命名
|
|
|
|
迭代目录统一使用：
|
|
|
|
```text
|
|
<迭代编号>.<简短名称>/
|
|
```
|
|
|
|
例如：
|
|
|
|
- `04.runtime_workspace/`
|
|
- `04A.agent_tool_route/`
|
|
- `05.first_isolated_miniapp/`
|
|
|
|
## 2. 每个迭代目录的推荐结构
|
|
|
|
```text
|
|
<迭代目录>/
|
|
├── 01.迭代规划.md
|
|
├── 02.设计评审.md
|
|
├── 03.设计评审（二）.md # 按需要增加
|
|
├── 05.技术实施规范.md
|
|
├── 06.技术实施规范评审.md
|
|
├── 07.技术实施规范评审（二）.md # 按需要增加
|
|
├── 08.验收评审.md
|
|
├── 09.验收评审（二）.md # 按需要增加
|
|
└── evidence/
|
|
```
|
|
|
|
## 3. 命名原则
|
|
|
|
- 主规划始终用 `01.迭代规划.md`
|
|
- 第一轮设计评审固定用 `02.设计评审.md`
|
|
- 技术实施规范固定用 `05.技术实施规范.md`
|
|
- 技术实施规范评审固定用 `06.技术实施规范评审.md`
|
|
- 验收评审从 `08` 开始，避免和前四步混淆
|
|
|
|
## 4. 为什么保留编号空位
|
|
|
|
保留 `03 / 04 / 07 / 09` 等位置，是为了支持：
|
|
|
|
- 多轮设计评审；
|
|
- 多轮技术规范评审；
|
|
- 多轮验收评审；
|
|
- 不打乱主文件的稳定编号。
|
|
|
|
## 5. 跨项目迭代的写法
|
|
|
|
从 `04A` 开始，主规划和技术规范都必须明确写出涉及项目，例如：
|
|
|
|
- `lineup-app`
|
|
- `lineup-adapter/hermes`
|
|
- `lineup-app-server`
|
|
- `infra/wukongim-v3`
|
|
- 文档目录本身
|
|
|
|
不能再把跨项目迭代只写成某一个仓的局部事项。
|