初始化 agent_ops 文档治理体系

2026-08-07 16:56:51 +08:00
commit 10840909ab
75 changed files with 15750 additions and 0 deletions
@@ -0,0 +1,62 @@
+# 迭代目录与命名规范
+
+**版本：** 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`
+- 文档目录本身
+
+不能再把跨项目迭代只写成某一个仓的局部事项。