feat(arch-ai): 新增 Arch AI（架构AI）角色，升级为'1 人+3AI'协作模式

新增: - .ai/config/architect.json - Arch AI 配置文件（最高 AI 权限） - .ai/prompts/architecture/ - 架构设计提示词目录修改: - AGENTS.md: 新增 Arch AI 角色定义，权限矩阵增加 Arch AI 列 - workflow.json: 工作流从 4 阶段扩展为 5 阶段（新增架构设计阶段） - ai-collab-setup/SKILL.md: 全面支持 3 角色架构，版本升至 v3.0 - resume-context/SKILL.md: 架构模式改为 Arch AI，版本升至 v3.0 工作流变更: 需求分析(Arch AI) → 架构设计(Arch AI) → 开发实现(Dev AI) → 测试验证(QA AI) → 验收确认(人类)
2026-05-23 22:28:45 +08:00
parent da14b96f22
commit 490af832ea
5 changed files with 298 additions and 115 deletions
@@ -0,0 +1,38 @@
+{
+  "name": "Arch AI",
+  "role": "架构设计师",
+  "description": "allowed_paths = 可写路径（含读）；read_only_paths = 只读路径；不在二者中的路径禁止访问。详细权限见 AGENTS.md 权限矩阵。",
+  "responsibilities": [
+    "需求分析和产品规划",
+    "系统架构设计",
+    "技术选型和评估",
+    "跨模块协调和集成",
+    "编写架构文档",
+    "定义验收标准",
+    "评估变更影响",
+    "维护共享资源",
+    "指导 Dev AI 和 QA AI 工作"
+  ],
+  "allowed_paths": [
+    "docs/",
+    "shared/",
+    "projects/*/src/",
+    "projects/*/docs/",
+    "review/*/acceptance.md",
+    "review/*/impact.md",
+    "review/*/task.md",
+    "tools/",
+    "data/"
+  ],
+  "read_only_paths": [
+    ".ai/",
+    "projects/*/tests/",
+    "reports/",
+    "review/*/feedback/"
+  ],
+  "forbidden_paths": [],
+  "prompt_templates": {
+    "architecture": ".ai/prompts/architecture/",
+    "documentation": ".ai/prompts/architecture/"
+  }
+}
@@ -1,17 +1,23 @@
 {
  "workflow": "human-ai-collaboration",
-  "roles": ["human", "dev-ai", "qa-ai"],
+  "roles": ["human", "arch-ai", "dev-ai", "qa-ai"],
  "stages": [
    {
      "name": "需求分析",
-      "actor": "human",
-      "output": "review/{task_id}/task.md"
+      "actor": "arch-ai",
+      "output": ["docs/01_产品需求/PRD.md", "review/{task_id}/task.md"]
+    },
+    {
+      "name": "架构设计",
+      "actor": "arch-ai",
+      "input": ["docs/01_产品需求/PRD.md", "review/{task_id}/task.md"],
+      "output": ["docs/02_系统架构/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"]
    },
    {
      "name": "开发实现",
      "actor": "dev-ai",
-      "input": "review/{task_id}/task.md",
-      "output": ["projects/*/src/", "projects/*/docs/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"]
+      "input": ["review/{task_id}/task.md", "review/{task_id}/acceptance.md"],
+      "output": ["projects/*/src/", "projects/*/docs/"]
    },
    {
      "name": "测试验证",
@@ -1,18 +1,18 @@
 ---
 name: "ai-collab-setup"
-description: "Creates complete '1 Human + 2 AI' collaboration framework with directory structure and AI constitution. Invoke when starting a new AI-assisted programming project."
+description: "Creates complete '1 Human + 3 AI' collaboration framework with directory structure and AI constitution. Invoke when starting a new AI-assisted programming project."
 ---

 # AI 协作框架快速搭建

 ## 功能

-一键创建"1 人+2AI（Coder+Tester）"协作框架，包括：
+一键创建"1 人+3AI（Arch+Coder+Tester）"协作框架，包括：
 - 完整的目录结构
 - AI 角色定义与权限约定（AGENTS.md）—— R/W/RW/- 四态权限体系
 - AI 配置文件（含 read_only_paths、forbidden_paths、description）
 - 提示词模板（code-style.md、doc-template.md、bug-report.md）
- 工作流配置（4 阶段 + retry + escalation）
+- 工作流配置（5 阶段 + retry + escalation）
 - 示例任务模板
 - README 文档

@@ -35,6 +35,7 @@ description: "Creates complete '1 Human + 2 AI' collaboration framework with dir
 ├── .gitignore
 ├── .ai/
 │   ├── config/
+│   │   ├── architect.json          # Arch AI 配置（含 read_only_paths）
 │   │   ├── coder.json             # Dev AI 配置（含 read_only_paths）
 │   │   ├── tester.json            # QA AI 配置（含 read_only_paths）
 │   │   └── workflow.json          # 工作流配置（含 retry + escalation）
@@ -138,22 +139,46 @@ cat > AGENTS.md << 'EOF'
 ┌─────────────────────────────────────────────┐
 │              人类负责人                      │
 │      需求分析 · 架构设计 · 最终决策          │
-└───────────────────┬─────────────────────────┘
-                    │
-        ┌───────────┴───────────┐
-        ▼                       ▼
-┌───────────────┐       ┌───────────────┐
-│    Dev AI     │       │    QA AI      │
-│ 代码编写      │       │ 测试设计      │
-│ 文档生成      │       │ 测试执行      │
-│ 影响评估      │       │ 质量保障      │
-└───────────────┘       └───────────────┘
+└───────────────┬───────────┬─────────────────┘
+                │           │
+    ┌───────────┴──┐  ┌────┴────────────┐
+    ▼              ▼  ▼                 ▼
+┌───────────────┐  ┌──────────────┐  ┌───────────────┐
+│   Arch AI     │  │   Dev AI     │  │    QA AI      │
+│ 需求分析      │  │ 代码编写     │  │ 测试设计      │
+│ 架构设计      │  │ 文档生成     │  │ 测试执行      │
+│ 技术选型      │  │ 影响评估     │  │ 质量保障      │
+│ 跨模块协调    │  └──────────────┘  └───────────────┘
+└───────────────┘
 ```

 ---

 ## 角色职责

+### Arch AI (架构AI)
+**职责范围：**
+- ✅ 需求分析和产品规划
+- ✅ 系统架构设计
+- ✅ 技术选型和评估
+- ✅ 跨模块协调和集成
+- ✅ 编写架构文档 (`docs/`)
+- ✅ 定义验收标准 (`review/*/acceptance.md`)
+- ✅ 评估变更影响 (`review/*/impact.md`)
+- ✅ 维护共享资源 (`shared/`)
+- ✅ 维护开发工具 (`tools/`)
+- ✅ 维护训练数据 (`data/`)
+- ✅ 指导 Dev AI 和 QA AI 工作
+
+**可读但不可写：**
+- 👁 AI 配置文件 (`.ai/`) —— 只读，了解团队规则
+- 👁 测试代码 (`projects/*/tests/`) —— 只读，了解测试覆盖
+- 👁 测试报告 (`reports/`) —— 只读，了解质量状况
+- 👁 测试反馈 (`review/*/feedback/`) —— 只读，了解问题
+
+**禁止操作：**
+- ❌ 无（架构 AI 拥有最高 AI 权限）
+
 ### Dev AI (编码AI)
 **职责范围：**
 - ✅ 编写业务代码 (`projects/*/src/`)
@@ -206,21 +231,31 @@ cat > AGENTS.md << 'EOF'
 ## 工作流程

 ```
-┌──────────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────────┐
-│  需求分析    │ ───→ │  开发实现    │ ───→ │  测试验证    │ ───→ │  验收确认    │
-│  (人类)      │      │  (Dev AI)    │      │  (QA AI)     │      │  (人类)      │
-└──────────────┘      └──────────────┘      └──────────────┘      └──────────────┘
-                              ↑                      │
-                              │      Bug → 修复      │
-                              └──────────────────────┘
-                                   (最多 2 轮)
+┌──────────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────────┐
+│  需求分析    │ ───→ │  架构设计    │ ───→ │  开发实现    │ ───→ │  测试验证    │ ───→ │  验收确认    │
+│  (Arch AI)   │      │  (Arch AI)   │      │  (Dev AI)    │      │  (QA AI)     │      │  (人类)      │
+└──────────────┘      └──────────────┘      └──────────────┘      └──────────────┘      └──────────────┘
+                                                                      ↑                      │
+                                                                      │      Bug → 修复      │
+                                                                      └──────────────────────┘
+                                                                           (最多 2 轮)
 ```

 ### 详细流程说明

 **1. 需求分析阶段**
- 人类负责人创建任务单
- 输出: `review/{task_id}/task.md`
+- Arch AI 分析用户需求，输出产品规划
+- 输出: `docs/01_产品需求/PRD.md`、`review/{task_id}/task.md`
+
+**2. 架构设计阶段**
+- Arch AI 设计系统架构，技术选型
+- 输出: `docs/02_系统架构/`、`review/{task_id}/impact.md`、`review/{task_id}/acceptance.md`
+
+**3. 开发实现阶段**
+- Dev AI 读取任务描述和验收标准，编写代码 + 文档
+- 输出: `projects/*/src/`, `projects/*/docs/`
+
+**4. 测试验证阶段**

 **2. 开发实现阶段**
 - Dev AI 读取任务描述，编写代码 + 文档
@@ -262,22 +297,22 @@ Round 3: Dev 修复 → QA 复查 → 仍 1 个 HIGH → ⚠️ 升级给人类

 > **图例**：`-` = 无权访问 &nbsp;&nbsp; `R` = 只读 &nbsp;&nbsp; `W` = 可写（含读） &nbsp;&nbsp; `RW` = 读写

-| 目录路径 | Dev AI | QA AI | 人类 |
-|---------|--------|-------|------|
-| `.ai/` | `-` | `-` | `RW` |
-| `docs/` | `RW` | `R` | `RW` |
-| `tools/` | `RW` | `-` | `RW` |
-| `data/` | `RW` | `R` | `RW` |
-| `shared/` | `RW` | `R` | `RW` |
-| `projects/*/src/` | `RW` | `R` | `RW` |
-| `projects/*/tests/` | `-` | `RW` | `RW` |
-| `projects/*/docs/` | `RW` | `R` | `RW` |
-| `review/*/task.md` | `R` | `R` | `RW` |
-| `review/*/acceptance.md` | `RW` | `RW` | `RW` |
-| `review/*/impact.md` | `RW` | `-` | `RW` |
-| `review/*/feedback/` | `R` | `RW` | `RW` |
-| `reports/` | `-` | `RW` | `RW` |
-| `.github/` | `-` | `-` | `RW` |
+| 目录路径 | Arch AI | Dev AI | QA AI | 人类 |
+|---------|---------|--------|-------|------|
+| `.ai/` | `R` | `-` | `-` | `RW` |
+| `docs/` | `RW` | `RW` | `R` | `RW` |
+| `tools/` | `RW` | `RW` | `-` | `RW` |
+| `data/` | `RW` | `RW` | `R` | `RW` |
+| `shared/` | `RW` | `RW` | `R` | `RW` |
+| `projects/*/src/` | `RW` | `RW` | `R` | `RW` |
+| `projects/*/tests/` | `R` | `-` | `RW` | `RW` |
+| `projects/*/docs/` | `RW` | `RW` | `R` | `RW` |
+| `review/*/task.md` | `RW` | `R` | `R` | `RW` |
+| `review/*/acceptance.md` | `RW` | `RW` | `RW` | `RW` |
+| `review/*/impact.md` | `RW` | `RW` | `-` | `RW` |
+| `review/*/feedback/` | `R` | `R` | `RW` | `RW` |
+| `reports/` | `R` | `-` | `RW` | `RW` |
+| `.github/` | `-` | `-` | `-` | `RW` |

 > **解析优先级**：当同一条路径被多个规则匹配时，`forbidden > read_only > allowed`。禁止规则永远优先。
 > 
@@ -334,6 +369,7 @@ test(P01-001): 添加登录测试用例

 | 文件 | 说明 |
 |------|------|
+| `.ai/config/architect.json` | Arch AI 配置（权限、职责） |
 | `.ai/config/coder.json` | Dev AI 配置（权限、职责） |
 | `.ai/config/tester.json` | QA AI 配置（权限、职责） |
 | `.ai/config/workflow.json` | 工作流配置（阶段、触发器） |
@@ -345,7 +381,7 @@ EOF
 cat > README.md << 'EOF'
 # AI 协作项目

-一个"人+2AI"协作模式的 AI 辅助编程项目仓库。
+一个"人+3AI"协作模式的 AI 辅助编程项目仓库。

 ---

@@ -358,6 +394,7 @@ cat > README.md << 'EOF'
 ├── .gitignore
 ├── .ai/                           # AI协作核心配置
 │   ├── config/
+│   │   ├── architect.json         # Arch AI 配置
 │   │   ├── coder.json             # Dev AI 配置
 │   │   ├── tester.json            # QA AI 配置
 │   │   └── workflow.json          # 工作流配置
@@ -399,6 +436,7 @@ cat > README.md << 'EOF'
 | 角色 | 是谁 | 干什么 | 不干什么 |
 |------|------|--------|----------|
 | **人类负责人** | 你 | 下指令、审阅、做决策、定验收标准 | 不写代码、不写测试 |
+| **Arch AI** | Claude/TRAE/元宝等 | 需求分析、架构设计、技术选型、跨模块协调 | 不写测试 |
 | **Dev AI** | Claude/TRAE/元宝等 | 写业务代码+文档、修bug、写impact | 不动tests/、不跑测试 |
 | **QA AI** | 扣子编程AI | 写测试、跑测试、写反馈 | 不动src/、不改业务代码 |

@@ -406,9 +444,9 @@ cat > README.md << 'EOF'

 ## 工作流程

-1. **你**在 `review/active/P01-001/` 下写 `task.md`（要做什么）
-2. **你或Dev AI**补充 `acceptance.md`（怎么算做完了）
-3. **Dev AI** 在 `projects/P01_app/src/` 写代码，在 `docs/` 写文档，写 `impact.md`
+1. **Arch AI** 分析需求，输出 `docs/01_产品需求/PRD.md` 和 `review/active/P01-001/task.md`
+2. **Arch AI** 设计架构，输出 `docs/02_系统架构/`、`acceptance.md`、`impact.md`
+3. **Dev AI** 在 `projects/P01_app/src/` 写代码，在 `docs/` 写文档
 4. **你**审一眼，没问题就触发QA AI
 5. **QA AI** 读 `task.md` + `acceptance.md` + `impact.md`，按 `ENVIRONMENT.md` 准备环境，在 `tests/` 写测试并执行，写 `feedback/round1.md`
 6. **有bug** → 你看反馈 → 让Dev AI修 → 回到步骤3（round2）
@@ -482,6 +520,49 @@ data/
 EOF

 # 5. 创建 AI 配置文件（新版：含 read_only_paths、forbidden_paths、description）
+cat > .ai/config/architect.json << 'EOF'
+{
+  "name": "Arch AI",
+  "role": "架构设计师",
+  "description": "allowed_paths = 可写路径（含读）；read_only_paths = 只读路径；不在二者中的路径禁止访问。详细权限见 AGENTS.md 权限矩阵。",
+  "responsibilities": [
+    "需求分析和产品规划",
+    "系统架构设计",
+    "技术选型和评估",
+    "跨模块协调和集成",
+    "编写架构文档",
+    "定义验收标准",
+    "评估变更影响",
+    "维护共享资源",
+    "维护开发工具",
+    "维护训练数据",
+    "指导 Dev AI 和 QA AI 工作"
+  ],
+  "allowed_paths": [
+    "docs/",
+    "shared/",
+    "projects/*/src/",
+    "projects/*/docs/",
+    "review/*/acceptance.md",
+    "review/*/impact.md",
+    "review/*/task.md",
+    "tools/",
+    "data/"
+  ],
+  "read_only_paths": [
+    ".ai/",
+    "projects/*/tests/",
+    "reports/",
+    "review/*/feedback/"
+  ],
+  "forbidden_paths": [],
+  "prompt_templates": {
+    "architecture": ".ai/prompts/architecture/",
+    "documentation": ".ai/prompts/architecture/"
+  }
+}
+EOF
+
 cat > .ai/config/coder.json << 'EOF'
 {
  "name": "Dev AI",
@@ -534,13 +615,19 @@ cat > .ai/config/tester.json << 'EOF'
    "review/*/feedback/"
  ],
  "read_only_paths": [
-    "review/*/task.md"
-  ],
-  "forbidden_paths": [
    "projects/*/src/",
    "projects/*/docs/",
+    "docs/",
+    "data/",
    "shared/",
-    "review/*/impact.md"
+    "review/*/task.md",
+    "review/*/acceptance.md"
+  ],
+  "forbidden_paths": [
+    ".ai/",
+    "tools/",
+    "review/*/impact.md",
+    "review/*/feedback/"
  ],
  "prompt_templates": {
    "testing": ".ai/prompts/testing/"
@@ -551,18 +638,24 @@ EOF
 cat > .ai/config/workflow.json << 'EOF'
 {
  "workflow": "human-ai-collaboration",
-  "roles": ["human", "dev-ai", "qa-ai"],
+  "roles": ["human", "arch-ai", "dev-ai", "qa-ai"],
  "stages": [
    {
      "name": "需求分析",
-      "actor": "human",
-      "output": "review/{task_id}/task.md"
+      "actor": "arch-ai",
+      "output": ["docs/01_产品需求/PRD.md", "review/{task_id}/task.md"]
+    },
+    {
+      "name": "架构设计",
+      "actor": "arch-ai",
+      "input": ["docs/01_产品需求/PRD.md", "review/{task_id}/task.md"],
+      "output": ["docs/02_系统架构/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"]
    },
    {
      "name": "开发实现",
      "actor": "dev-ai",
-      "input": "review/{task_id}/task.md",
-      "output": ["projects/*/src/", "projects/*/docs/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"]
+      "input": ["review/{task_id}/task.md", "review/{task_id}/acceptance.md"],
+      "output": ["projects/*/src/", "projects/*/docs/"]
    },
    {
      "name": "测试验证",
@@ -594,6 +687,8 @@ cat > .ai/config/workflow.json << 'EOF'
 EOF

 # 6. 创建提示词模板
+mkdir -p .ai/prompts/architecture
+
 cat > .ai/prompts/coding/README.md << 'EOF'
 # Dev AI 提示词库

@@ -611,6 +706,15 @@ cat > .ai/prompts/testing/README.md << 'EOF'
 | [bug-report.md](bug-report.md) | 测试反馈 / Bug 报告模板与格式规范 |
 EOF

+cat > .ai/prompts/architecture/README.md << 'EOF'
+# Arch AI 提示词库
+
+| 文件 | 说明 |
+|------|------|
+| [architecture-design.md](architecture-design.md) | 架构设计模板与规范 |
+| [tech-selection.md](tech-selection.md) | 技术选型评估模板 |
+EOF
+
 cat > .ai/prompts/coding/code-style.md << 'EOF'
 # Dev AI 代码风格规范

@@ -1067,13 +1171,13 @@ skill 执行后：

 ---

-**Version**: 2.2  
+**Version**: 3.0  
 **Created**: 2026-05-23  
 **Updated**: 2026-05-23  
 **Based On**: ErrLens AI Programming Project  
-**Changes from v2.1**: 
- 新增 resume-context Skill（接着干）- 解决多电脑切换时的上下文同步
- 新增 docs/PROJECT_CONTEXT.md 项目整体上下文
- 新增 docs/DECISIONS.md 架构决策记录（ADR）
- 新增 docs/06_开发日志/ 按日期记录讨论内容
- 新增根目录 ENVIRONMENT.md 开发环境配置
+**Changes from v2.2**: 
+- 新增 Arch AI（架构AI）角色，形成"1 人+3AI"协作模式
+- 新增 .ai/config/architect.json 配置文件
+- 新增架构设计阶段，工作流从 4 阶段扩展为 5 阶段
+- 权限矩阵增加 Arch AI 列
+- 新增 .ai/prompts/architecture/ 提示词目录
@@ -30,7 +30,7 @@ description: "Loads project context and syncs conversation history. Invoke when
 ```
 开发/dev/coder → Dev AI
 测试/test/qa   → QA AI
-架构/arch      → 人类负责人（全权限）
+架构/arch      → Arch AI（架构设计师）
 ```

 ### 2. 读取项目上下文
@@ -48,6 +48,15 @@ description: "Loads project context and syncs conversation history. Invoke when

 根据识别的角色，读取对应的配置文件：

+**Arch AI**：
+```
+.ai/config/architect.json
+```
+- 读取 `allowed_paths`、`read_only_paths`、`forbidden_paths`
+- 读取 `responsibilities`
+- 读取 `prompt_templates`
+- **拥有最高 AI 权限**，可以进行架构设计和跨模块修改
+
 **Dev AI**：
 ```
 .ai/config/coder.json
@@ -64,11 +73,6 @@ description: "Loads project context and syncs conversation history. Invoke when
 - 读取 `responsibilities`
 - 读取 `prompt_templates`

-**架构模式（人类负责人）**：
- 读取 `AGENTS.md` 中"人类负责人"职责
- **不受宪法约束**，可以修改所有目录
- 拥有最终决策权
-
 ### 4. 读取最新开发日志

 ```powershell
@@ -172,16 +176,20 @@ Get-ChildItem "docs/06_开发日志/" -Filter "*.md" | Sort-Object Name -Descend
 ## 注意事项

 1. **角色必须明确**：用户必须指定"开发"、"测试"或"架构"，否则询问用户
-2. **架构模式特殊**：架构模式下 AI 拥有最高权限，不受宪法约束，可以修改所有目录
+2. **架构模式**：架构模式对应 Arch AI，拥有最高 AI 权限，可以进行架构设计和跨模块修改
 3. **不要修改文档**：此 skill 只读取上下文，不修改任何文件（除非用户明确要求）
 4. **关注最新内容**：优先读取最新的开发日志
 5. **识别阻塞点**：注意 PROJECT_CONTEXT.md 中的"待解决问题"
-6. **权限意识**：开发/测试模式下严格遵循 AGENTS.md 中的权限约定
+6. **权限意识**：开发/测试/架构模式下严格遵循 AGENTS.md 中的权限约定

 ---

-**Version**: 2.0  
+**Version**: 3.0  
 **Created**: 2026-05-23  
 **Updated**: 2026-05-23  
 **Based On**: ErrLens AI Programming Project  
-**Purpose**: 解决用户多电脑切换时的上下文同步问题，明确 AI 角色和权限
+**Purpose**: 解决用户多电脑切换时的上下文同步问题，明确 AI 角色和权限  
+**Changes from v2.0**: 
+- 架构模式从"人类负责人"改为"Arch AI（架构设计师）"
+- 新增 .ai/config/architect.json 配置读取
+- 支持"1 人+3AI"协作模式
@@ -5,22 +5,46 @@
 ┌─────────────────────────────────────────────┐
 │              人类负责人                      │
 │      需求分析 · 架构设计 · 最终决策          │
-└───────────────────┬─────────────────────────┘
-                    │
-        ┌───────────┴───────────┐
-        ▼                       ▼
-┌───────────────┐       ┌───────────────┐
-│    Dev AI     │       │    QA AI      │
-│ 代码编写      │       │ 测试设计      │
-│ 文档生成      │       │ 测试执行      │
-│ 影响评估      │       │ 质量保障      │
-└───────────────┘       └───────────────┘
+└───────────────┬───────────┬─────────────────┘
+                │           │
+    ┌───────────┴──┐  ┌────┴────────────┐
+    ▼              ▼  ▼                 ▼
+┌───────────────┐  ┌──────────────┐  ┌───────────────┐
+│   Arch AI     │  │   Dev AI     │  │    QA AI      │
+│ 需求分析      │  │ 代码编写     │  │ 测试设计      │
+│ 架构设计      │  │ 文档生成     │  │ 测试执行      │
+│ 技术选型      │  │ 影响评估     │  │ 质量保障      │
+│ 跨模块协调    │  └──────────────┘  └───────────────┘
+└───────────────┘
 ```

 ---

 ## 角色职责

+### Arch AI (架构AI)
+**职责范围：**
+- ✅ 需求分析和产品规划
+- ✅ 系统架构设计
+- ✅ 技术选型和评估
+- ✅ 跨模块协调和集成
+- ✅ 编写架构文档 (`docs/`)
+- ✅ 定义验收标准 (`review/*/acceptance.md`)
+- ✅ 评估变更影响 (`review/*/impact.md`)
+- ✅ 维护共享资源 (`shared/`)
+- ✅ 维护开发工具 (`tools/`)
+- ✅ 维护训练数据 (`data/`)
+- ✅ 指导 Dev AI 和 QA AI 工作
+
+**可读但不可写：**
+- 👁 AI 配置文件 (`.ai/`) —— 只读，了解团队规则
+- 👁 测试代码 (`projects/*/tests/`) —— 只读，了解测试覆盖
+- 👁 测试报告 (`reports/`) —— 只读，了解质量状况
+- 👁 测试反馈 (`review/*/feedback/`) —— 只读，了解问题
+
+**禁止操作：**
+- ❌ 无（架构 AI 拥有最高 AI 权限）
+
 ### Dev AI (编码AI)
 **职责范围：**
 - ✅ 编写业务代码 (`projects/*/src/`)
@@ -76,28 +100,31 @@
 ## 工作流程

 ```
-┌──────────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────────┐
-│  需求分析    │ ───→ │  开发实现    │ ───→ │  测试验证    │ ───→ │  验收确认    │
-│  (人类)      │      │  (Dev AI)    │      │  (QA AI)     │      │  (人类)      │
-└──────────────┘      └──────────────┘      └──────────────┘      └──────────────┘
-                              ↑                      │
-                              │      Bug → 修复      │
-                              └──────────────────────┘
-                                   (最多 2 轮)
+┌──────────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────────┐
+│  需求分析    │ ───→ │  架构设计    │ ───→ │  开发实现    │ ───→ │  测试验证    │ ───→ │  验收确认    │
+│  (Arch AI)   │      │  (Arch AI)   │      │  (Dev AI)    │      │  (QA AI)     │      │  (人类)      │
+└──────────────┘      └──────────────┘      └──────────────┘      └──────────────┘      └──────────────┘
+                                                                      ↑                      │
+                                                                      │      Bug → 修复      │
+                                                                      └──────────────────────┘
+                                                                           (最多 2 轮)
 ```

 ### 详细流程说明

 **1. 需求分析阶段**
- 人类负责人创建任务单
- 输出: `review/{task_id}/task.md`
+- Arch AI 分析用户需求，输出产品规划
+- 输出: `docs/01_产品需求/PRD.md`、`review/{task_id}/task.md`

-**2. 开发实现阶段**
- Dev AI 读取任务描述，编写代码 + 文档
- 同时输出验收标准和变更影响范围
- 输出: `projects/*/src/`, `projects/*/docs/`, `review/{task_id}/impact.md`, `review/{task_id}/acceptance.md`
+**2. 架构设计阶段**
+- Arch AI 设计系统架构，技术选型
+- 输出: `docs/02_系统架构/`、`review/{task_id}/impact.md`、`review/{task_id}/acceptance.md`

-**3. 测试验证阶段**
+**3. 开发实现阶段**
+- Dev AI 读取任务描述和验收标准，编写代码 + 文档
+- 输出: `projects/*/src/`, `projects/*/docs/`
+
+**4. 测试验证阶段**
 - QA AI 根据验收标准编写测试，执行测试，生成报告
 - 测试反馈写入 `review/{task_id}/feedback/round{round}.md`
 - 输出: `projects/*/tests/`, `reports/test-results/`, `review/{task_id}/feedback/`
@@ -132,22 +159,22 @@ Round 3: Dev 修复 → QA 复查 → 仍 1 个 HIGH → ⚠️ 升级给人类

 > **图例**：`-` = 无权访问 &nbsp;&nbsp; `R` = 只读 &nbsp;&nbsp; `W` = 可写（含读） &nbsp;&nbsp; `RW` = 读写

-| 目录路径 | Dev AI | QA AI | 人类 |
-|---------|--------|-------|------|
-| `.ai/` | `-` | `-` | `RW` |
-| `docs/` | `RW` | `R` | `RW` |
-| `tools/` | `RW` | `-` | `RW` |
-| `data/` | `RW` | `R` | `RW` |
-| `shared/` | `RW` | `-` | `RW` |
-| `projects/*/src/` | `RW` | `-` | `RW` |
-| `projects/*/tests/` | `-` | `RW` | `RW` |
-| `projects/*/docs/` | `RW` | `-` | `RW` |
-| `review/*/task.md` | `R` | `R` | `RW` |
-| `review/*/acceptance.md` | `RW` | `RW` | `RW` |
-| `review/*/impact.md` | `RW` | `-` | `RW` |
-| `review/*/feedback/` | `R` | `RW` | `RW` |
-| `reports/` | `-` | `RW` | `RW` |
-| `.github/` | `-` | `-` | `RW` |
+| 目录路径 | Arch AI | Dev AI | QA AI | 人类 |
+|---------|---------|--------|-------|------|
+| `.ai/` | `R` | `-` | `-` | `RW` |
+| `docs/` | `RW` | `RW` | `R` | `RW` |
+| `tools/` | `RW` | `RW` | `-` | `RW` |
+| `data/` | `RW` | `RW` | `R` | `RW` |
+| `shared/` | `RW` | `RW` | `R` | `RW` |
+| `projects/*/src/` | `RW` | `RW` | `R` | `RW` |
+| `projects/*/tests/` | `R` | `-` | `RW` | `RW` |
+| `projects/*/docs/` | `RW` | `RW` | `R` | `RW` |
+| `review/*/task.md` | `RW` | `R` | `R` | `RW` |
+| `review/*/acceptance.md` | `RW` | `RW` | `RW` | `RW` |
+| `review/*/impact.md` | `RW` | `RW` | `-` | `RW` |
+| `review/*/feedback/` | `R` | `R` | `RW` | `RW` |
+| `reports/` | `R` | `-` | `RW` | `RW` |
+| `.github/` | `-` | `-` | `-` | `RW` |

 > **解析优先级**：当同一条路径被多个规则匹配时，`forbidden > read_only > allowed`。禁止规则永远优先。
 >