ErrLens AI 编程项目

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

---

目录结构

.
├── AGENTS.md                      # AI角色定义+权限约定+工作流
├── README.md
├── .gitignore
├── .ai/                           # AI协作核心配置
│   ├── config/
│   │   ├── coder.json             # Dev AI 配置
│   │   ├── tester.json            # QA AI 配置
│   │   └── workflow.json          # 工作流配置
│   └── prompts/
│       ├── coding/                # 编码提示词模板
│       └── testing/               # 测试提示词模板
├── projects/                      # 项目代码
│   ├── P01_errlens_app/           # 主应用项目
│   │   ├── src/                   # 业务代码 (Dev AI)
│   │   ├── tests/                 # 测试代码 (QA AI)
│   │   ├── docs/                  # 项目文档 (Dev AI)
│   │   │   ├── 01_需求概要.md
│   │   │   ├── 02_架构设计.md
│   │   │   └── 03_接口定义.md
│   │   └── ENVIRONMENT.md         # 项目级环境准备
│   └── P02_errlens_training/      # AI训练项目
│       ├── src/
│       ├── tests/
│       ├── docs/
│       │   ├── 01_需求概要.md
│       │   ├── 02_架构设计.md
│       │   └── 03_训练流程.md
│       └── ENVIRONMENT.md
├── review/                        # 交接中心
│   ├── active/                    # 活跃任务
│   │   ├── P01-001/               # 项目1-任务001
│   │   │   ├── task.md            # 任务描述
│   │   │   ├── acceptance.md      # 验收标准
│   │   │   ├── impact.md          # 变更影响范围
│   │   │   └── feedback/          # 反馈记录
│   │   │       └── round1.md
│   │   ├── P01-002/               # 项目1-任务002
│   │   ├── P02-001/               # 项目2-任务001
│   │   └── CROSS-001/             # 跨项目任务
│   └── archived/                  # 已完成任务（按季度归档）
│       ├── 2026-Q2/
│       └── 2026-Q3/
├── shared/                        # 共享资源
│   ├── scripts/                   # 共享脚本
│   ├── templates/                 # 代码/文档模板
│   └── utils/                     # 工具函数
├── reports/                       # 统一报告
│   ├── test-results/              # 测试结果
│   └── quality-reports/           # 质量评审报告
└── .github/                       # CI/CD配置
    └── workflows/

---

团队角色

角色	是谁	干什么	不干什么
人类负责人	你	下指令、审阅、做决策、定验收标准	不写代码、不写测试
Dev AI	Claude/TRAE/元宝等	写业务代码+文档、修bug、写impact	不动tests/、不跑测试
QA AI	扣子编程AI	写测试、跑测试、写反馈	不动src/、不改业务代码

---

工作流程

1. 你在 review/active/P01-001/ 下写 task.md（要做什么）
2. 你或Dev AI补充 acceptance.md（怎么算做完了）
3. Dev AI 在 projects/P01_errlens_app/src/ 写代码，在 docs/ 写文档，写 impact.md
4. 你审一眼，没问题就触发QA AI
5. QA AI 读 task.md + acceptance.md + impact.md，按 ENVIRONMENT.md 准备环境，在 tests/ 写测试并执行，写 feedback/round1.md
6. 有bug → 你看反馈 → 让Dev AI修 → 回到步骤3（round2） 通过 → 你确认 → 任务关闭，报告归档到 reports/

---

任务状态流转

TODO → IN_PROGRESS → REVIEW → DONE → ARCHIVED（移入archived/季度目录）

task.md 中添加状态字段：

status: TODO | IN_PROGRESS | REVIEW | DONE | ARCHIVED

---

决策总结

问题	决策
任务创建	先手动，中期脚本化（create-task.sh），后期CI联动Issue
跨项目任务	CROSS-xxx/，feedback按项目分文件（如 P01-round1.md）
任务归档	review/active/ + review/archived/2026-Qx/，状态字段驱动，定期归档

---

快速开始

# 克隆仓库
git clone <repository-url>
cd errlens

# 查看目录结构
find . -type d | sort

# 查看当前任务
ls -la review/

---

参考文档

文件	说明
AGENTS.md	AI角色定义与权限约定
workflow.json	工作流配置
P01-001 任务	示例任务单

---

版本历史

版本	日期	说明
v1.0	2026-05-22	初始版本，完成目录结构设计