docs(readme): 补充 README.md 和变更日志 - 同步 Arch AI 升级

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

教训:核心代码改了,文档和变更日志必须同步更新,不能忘
This commit is contained in:
2026-05-23 22:35:05 +08:00
parent 490af832ea
commit c31ab669b3
3 changed files with 50 additions and 4 deletions
+2
View File
@@ -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/` | 测试提示词模板 |
+17 -4
View File
@@ -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修 → 回到步骤3round2
+31
View File
@@ -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) → 验收确认(人类)
```
---
## 模板