From 490af832eada235989eab82441f74d541a15524e Mon Sep 17 00:00:00 2001 From: hwd32 Date: Sat, 23 May 2026 22:28:45 +0800 Subject: [PATCH] =?UTF-8?q?feat(arch-ai):=20=E6=96=B0=E5=A2=9E=20Arch=20AI?= =?UTF-8?q?=EF=BC=88=E6=9E=B6=E6=9E=84AI=EF=BC=89=E8=A7=92=E8=89=B2?= =?UTF-8?q?=EF=BC=8C=E5=8D=87=E7=BA=A7=E4=B8=BA'1=20=E4=BA=BA+3AI'?= =?UTF-8?q?=E5=8D=8F=E4=BD=9C=E6=A8=A1=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增: - .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) → 验收确认(人类) --- .ai/config/architect.json | 38 +++++ .ai/config/workflow.json | 16 +- .trae/skills/ai-collab-setup/SKILL.md | 222 +++++++++++++++++++------- .trae/skills/resume-context/SKILL.md | 28 ++-- AGENTS.md | 109 ++++++++----- 5 files changed, 298 insertions(+), 115 deletions(-) create mode 100644 .ai/config/architect.json diff --git a/.ai/config/architect.json b/.ai/config/architect.json new file mode 100644 index 0000000..c9bda53 --- /dev/null +++ b/.ai/config/architect.json @@ -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/" + } +} diff --git a/.ai/config/workflow.json b/.ai/config/workflow.json index 86127fe..e61ceb5 100644 --- a/.ai/config/workflow.json +++ b/.ai/config/workflow.json @@ -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": "测试验证", diff --git a/.trae/skills/ai-collab-setup/SKILL.md b/.trae/skills/ai-collab-setup/SKILL.md index eaf0e5b..d0df073 100644 --- a/.trae/skills/ai-collab-setup/SKILL.md +++ b/.trae/skills/ai-collab-setup/SKILL.md @@ -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 → ⚠️ 升级给人类 > **图例**：`-` = 无权访问    `R` = 只读    `W` = 可写（含读）    `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 开发环境配置 \ No newline at end of file +**Changes from v2.2**: +- 新增 Arch AI（架构AI）角色，形成"1 人+3AI"协作模式 +- 新增 .ai/config/architect.json 配置文件 +- 新增架构设计阶段，工作流从 4 阶段扩展为 5 阶段 +- 权限矩阵增加 Arch AI 列 +- 新增 .ai/prompts/architecture/ 提示词目录 \ No newline at end of file diff --git a/.trae/skills/resume-context/SKILL.md b/.trae/skills/resume-context/SKILL.md index b6b37a4..5295a83 100644 --- a/.trae/skills/resume-context/SKILL.md +++ b/.trae/skills/resume-context/SKILL.md @@ -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"协作模式 diff --git a/AGENTS.md b/AGENTS.md index 8876f23..1bc73be 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 → ⚠️ 升级给人类 > **图例**：`-` = 无权访问    `R` = 只读    `W` = 可写（含读）    `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`。禁止规则永远优先。 >