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:
@@ -231,8 +231,10 @@ test(P01-001): 添加登录测试用例
|
|||||||
|
|
||||||
| 文件 | 说明 |
|
| 文件 | 说明 |
|
||||||
|------|------|
|
|------|------|
|
||||||
|
| `.ai/config/architect.json` | Arch AI 配置(权限、职责) |
|
||||||
| `.ai/config/coder.json` | Dev AI 配置(权限、职责) |
|
| `.ai/config/coder.json` | Dev AI 配置(权限、职责) |
|
||||||
| `.ai/config/tester.json` | QA AI 配置(权限、职责) |
|
| `.ai/config/tester.json` | QA AI 配置(权限、职责) |
|
||||||
| `.ai/config/workflow.json` | 工作流配置(阶段、触发器) |
|
| `.ai/config/workflow.json` | 工作流配置(阶段、触发器) |
|
||||||
|
| `.ai/prompts/architecture/` | 架构设计提示词模板 |
|
||||||
| `.ai/prompts/coding/` | 编码提示词模板 |
|
| `.ai/prompts/coding/` | 编码提示词模板 |
|
||||||
| `.ai/prompts/testing/` | 测试提示词模板 |
|
| `.ai/prompts/testing/` | 测试提示词模板 |
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
# ErrLens AI 编程项目
|
# ErrLens AI 编程项目
|
||||||
|
|
||||||
一个"人+2AI"协作模式的 AI 辅助编程项目仓库。
|
一个"人+3AI"协作模式的 AI 辅助编程项目仓库。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -13,12 +13,24 @@
|
|||||||
├── .gitignore
|
├── .gitignore
|
||||||
├── .ai/ # AI协作核心配置
|
├── .ai/ # AI协作核心配置
|
||||||
│ ├── config/
|
│ ├── config/
|
||||||
|
│ │ ├── architect.json # Arch AI 配置
|
||||||
│ │ ├── coder.json # Dev AI 配置
|
│ │ ├── coder.json # Dev AI 配置
|
||||||
│ │ ├── tester.json # QA AI 配置
|
│ │ ├── tester.json # QA AI 配置
|
||||||
│ │ └── workflow.json # 工作流配置
|
│ │ └── workflow.json # 工作流配置
|
||||||
│ └── prompts/
|
│ └── prompts/
|
||||||
|
│ ├── architecture/ # 架构设计提示词模板
|
||||||
│ ├── coding/ # 编码提示词模板
|
│ ├── coding/ # 编码提示词模板
|
||||||
│ └── testing/ # 测试提示词模板
|
│ └── testing/ # 测试提示词模板
|
||||||
|
├── docs/ # 项目级总体文档
|
||||||
|
│ ├── 01_产品需求/
|
||||||
|
│ ├── 02_系统架构/
|
||||||
|
│ ├── 03_开发规范/
|
||||||
|
│ ├── 04_部署运维/
|
||||||
|
│ ├── 05_变更日志/
|
||||||
|
│ │ └── archived/ # 历史变更日志(按年月归档)
|
||||||
|
│ └── 06_开发日志/
|
||||||
|
├── tools/ # 开发工具脚本
|
||||||
|
├── data/ # 训练数据
|
||||||
├── projects/ # 项目代码
|
├── projects/ # 项目代码
|
||||||
│ ├── P01_errlens_app/ # 主应用项目
|
│ ├── P01_errlens_app/ # 主应用项目
|
||||||
│ │ ├── src/ # 业务代码 (Dev AI)
|
│ │ ├── src/ # 业务代码 (Dev AI)
|
||||||
@@ -68,6 +80,7 @@
|
|||||||
| 角色 | 是谁 | 干什么 | 不干什么 |
|
| 角色 | 是谁 | 干什么 | 不干什么 |
|
||||||
|------|------|--------|----------|
|
|------|------|--------|----------|
|
||||||
| **人类负责人** | 你 | 下指令、审阅、做决策、定验收标准 | 不写代码、不写测试 |
|
| **人类负责人** | 你 | 下指令、审阅、做决策、定验收标准 | 不写代码、不写测试 |
|
||||||
|
| **Arch AI** | Claude/TRAE/元宝等 | 需求分析、架构设计、技术选型、跨模块协调 | 不写测试 |
|
||||||
| **Dev AI** | Claude/TRAE/元宝等 | 写业务代码+文档、修bug、写impact | 不动tests/、不跑测试 |
|
| **Dev AI** | Claude/TRAE/元宝等 | 写业务代码+文档、修bug、写impact | 不动tests/、不跑测试 |
|
||||||
| **QA AI** | 扣子编程AI | 写测试、跑测试、写反馈 | 不动src/、不改业务代码 |
|
| **QA AI** | 扣子编程AI | 写测试、跑测试、写反馈 | 不动src/、不改业务代码 |
|
||||||
|
|
||||||
@@ -75,9 +88,9 @@
|
|||||||
|
|
||||||
## 工作流程
|
## 工作流程
|
||||||
|
|
||||||
1. **你**在 `review/active/P01-001/` 下写 `task.md`(要做什么)
|
1. **Arch AI** 分析需求,输出 `docs/01_产品需求/PRD.md` 和 `review/active/P01-001/task.md`
|
||||||
2. **你或Dev AI**补充 `acceptance.md`(怎么算做完了)
|
2. **Arch AI** 设计架构,输出 `docs/02_系统架构/`、`acceptance.md`、`impact.md`
|
||||||
3. **Dev AI** 在 `projects/P01_errlens_app/src/` 写代码,在 `docs/` 写文档,写 `impact.md`
|
3. **Dev AI** 在 `projects/P01_errlens_app/src/` 写代码,在 `docs/` 写文档
|
||||||
4. **你**审一眼,没问题就触发QA AI
|
4. **你**审一眼,没问题就触发QA AI
|
||||||
5. **QA AI** 读 `task.md` + `acceptance.md` + `impact.md`,按 `ENVIRONMENT.md` 准备环境,在 `tests/` 写测试并执行,写 `feedback/round1.md`
|
5. **QA AI** 读 `task.md` + `acceptance.md` + `impact.md`,按 `ENVIRONMENT.md` 准备环境,在 `tests/` 写测试并执行,写 `feedback/round1.md`
|
||||||
6. **有bug** → 你看反馈 → 让Dev AI修 → 回到步骤3(round2)
|
6. **有bug** → 你看反馈 → 让Dev AI修 → 回到步骤3(round2)
|
||||||
|
|||||||
@@ -35,6 +35,37 @@
|
|||||||
- 根目录 ENVIRONMENT.md 开发环境配置
|
- 根目录 ENVIRONMENT.md 开发环境配置
|
||||||
- ai-collab-setup/SKILL.md 版本升至 v2.2
|
- 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) → 验收确认(人类)
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 模板
|
## 模板
|
||||||
|
|||||||
Reference in New Issue
Block a user