From c31ab669b3ba92bcf988b3c2a317741869d13ae4 Mon Sep 17 00:00:00 2001
From: hwd32 <tupingr@qq.com>
Date: Sat, 23 May 2026 22:35:05 +0800
Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E8=A1=A5=E5=85=85=20README.md?=
 =?UTF-8?q?=20=E5=92=8C=E5=8F=98=E6=9B=B4=E6=97=A5=E5=BF=97=20-=20?=
 =?UTF-8?q?=E5=90=8C=E6=AD=A5=20Arch=20AI=20=E5=8D=87=E7=BA=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- README.md: 更新为'1 人+3AI'协作模式，目录结构、团队角色、工作流程全面更新
- AGENTS.md: AI 配置文件说明增加 architect.json 和 architecture/ 提示词
- docs/05_变更日志/2026-05-23.md: 补充今天所有提交的变更记录

教训：核心代码改了，文档和变更日志必须同步更新，不能忘
---
 AGENTS.md                      |  2 ++
 README.md                      | 21 +++++++++++++++++----
 docs/05_变更日志/2026-05-23.md | 31 +++++++++++++++++++++++++++++++
 3 files changed, 50 insertions(+), 4 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 1bc73be..8755b72 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -231,8 +231,10 @@ 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` | 工作流配置（阶段、触发器） |
+| `.ai/prompts/architecture/` | 架构设计提示词模板 |
 | `.ai/prompts/coding/` | 编码提示词模板 |
 | `.ai/prompts/testing/` | 测试提示词模板 |
\ No newline at end of file
diff --git a/README.md b/README.md
index 4b55dac..6c847c6 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # ErrLens AI 编程项目
 
-一个"人+2AI"协作模式的 AI 辅助编程项目仓库。
+一个"人+3AI"协作模式的 AI 辅助编程项目仓库。
 
 ---
 
@@ -13,12 +13,24 @@
 ├── .gitignore
 ├── .ai/                           # AI协作核心配置
 │   ├── config/
+│   │   ├── architect.json         # Arch AI 配置
 │   │   ├── coder.json             # Dev AI 配置
 │   │   ├── tester.json            # QA AI 配置
 │   │   └── workflow.json          # 工作流配置
 │   └── prompts/
+│       ├── architecture/          # 架构设计提示词模板
 │       ├── coding/                # 编码提示词模板
 │       └── testing/               # 测试提示词模板
+├── docs/                          # 项目级总体文档
+│   ├── 01_产品需求/
+│   ├── 02_系统架构/
+│   ├── 03_开发规范/
+│   ├── 04_部署运维/
+│   ├── 05_变更日志/
+│   │   └── archived/              # 历史变更日志（按年月归档）
+│   └── 06_开发日志/
+├── tools/                         # 开发工具脚本
+├── data/                          # 训练数据
 ├── projects/                      # 项目代码
 │   ├── P01_errlens_app/           # 主应用项目
 │   │   ├── src/                   # 业务代码 (Dev AI)
@@ -68,6 +80,7 @@
 | 角色 | 是谁 | 干什么 | 不干什么 |
 |------|------|--------|----------|
 | **人类负责人** | 你 | 下指令、审阅、做决策、定验收标准 | 不写代码、不写测试 |
+| **Arch AI** | Claude/TRAE/元宝等 | 需求分析、架构设计、技术选型、跨模块协调 | 不写测试 |
 | **Dev AI** | Claude/TRAE/元宝等 | 写业务代码+文档、修bug、写impact | 不动tests/、不跑测试 |
 | **QA AI** | 扣子编程AI | 写测试、跑测试、写反馈 | 不动src/、不改业务代码 |
 
@@ -75,9 +88,9 @@
 
 ## 工作流程
 
-1. **你**在 `review/active/P01-001/` 下写 `task.md`（要做什么）
-2. **你或Dev AI**补充 `acceptance.md`（怎么算做完了）
-3. **Dev AI** 在 `projects/P01_errlens_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_errlens_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）
diff --git a/docs/05_变更日志/2026-05-23.md b/docs/05_变更日志/2026-05-23.md
index 2b18d22..9973bd1 100644
--- a/docs/05_变更日志/2026-05-23.md
+++ b/docs/05_变更日志/2026-05-23.md
@@ -35,6 +35,37 @@
 - 根目录 ENVIRONMENT.md 开发环境配置
 - ai-collab-setup/SKILL.md 版本升至 v2.2
 
+**fix(changelog): 补充变更日志归档目录 archived/** (`b7c3d4e`)
+- 创建 docs/05_变更日志/archived/ 目录
+- PROJECT_CONTEXT.md 项目结构图补充 archived/ 子目录
+- ai-collab-setup/SKILL.md 两处目录树同步更新
+
+**fix(constitution): 修正 QA AI 权限 - 区分'禁止修改'与'禁止读取'** (`defecb0`)
+- tester.json: projects/*/src/、projects/*/docs/、shared/ 从 forbidden 移至 read_only
+- AGENTS.md: QA AI 只读路径补充业务代码、技术文档、共享资源、验收标准
+- ai-collab-setup/SKILL.md: 权限矩阵同步更新，QA AI 可读 src/docs/shared
+
+**feat(resume-context): 增加角色识别机制** (`da14b96`)
+- 触发词格式：接着干 开发/测试/架构
+- 开发模式：Dev AI，按宪法约束（coder.json）
+- 测试模式：QA AI，按宪法约束（tester.json）
+- 架构模式：人类负责人，最高权限，不受宪法约束
+- 版本升至 v2.0
+
+**feat(arch-ai): 新增 Arch AI（架构AI）角色，升级为'1 人+3AI'协作模式** (`490af83`)
+- 新增 .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
+- README.md: 目录结构、团队角色、工作流程全面更新
+
+**工作流变更**:
+```
+需求分析(Arch AI) → 架构设计(Arch AI) → 开发实现(Dev AI) → 测试验证(QA AI) → 验收确认(人类)
+```
+
 ---
 
 ## 模板