tupingr
5dfc382c55
- .ai/config/tester.json: 修复 review/*/acceptance.md 和 review/*/feedback/ 路径冲突 - README.md: 新增可用 Skill 列表（7 个） - docs/PROJECT_CONTEXT.md: 更新为 1 人+3AI，补充关键决策记录 - docs/05_变更日志/2026-05-23.md: 补充今日所有提交记录
168 lines
6.2 KiB
Markdown
168 lines
6.2 KiB
Markdown
# ErrLens AI 编程项目
|
||
|
||
一个"人+3AI"协作模式的 AI 辅助编程项目仓库。
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
.
|
||
├── AGENTS.md # AI角色定义+权限约定+工作流
|
||
├── README.md
|
||
├── .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)
|
||
│ │ ├── 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/
|
||
```
|
||
|
||
---
|
||
|
||
## 团队角色
|
||
|
||
| 角色 | 是谁 | 干什么 | 不干什么 |
|
||
|------|------|--------|----------|
|
||
| **人类负责人** | 你 | 下指令、审阅、做决策、定验收标准 | 不写代码、不写测试 |
|
||
| **Arch AI** | Claude/TRAE/元宝等 | 需求分析、架构设计、技术选型、跨模块协调 | 不写测试 |
|
||
| **Dev AI** | Claude/TRAE/元宝等 | 写业务代码+文档、修bug、写impact | 不动tests/、不跑测试 |
|
||
| **QA AI** | 扣子编程AI | 写测试、跑测试、写反馈 | 不动src/、不改业务代码 |
|
||
|
||
---
|
||
|
||
## 工作流程
|
||
|
||
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）
|
||
**通过** → 你确认 → 任务关闭，报告归档到 `reports/`
|
||
|
||
---
|
||
|
||
## 可用 Skill
|
||
|
||
| Skill | 功能 | 触发词 |
|
||
|-------|------|--------|
|
||
| **ai-collab-setup** | 创建协作框架 | 初始化项目时 |
|
||
| **add-subproject** | 添加子项目 | 新增子项目时 |
|
||
| **resume-context** | 换电脑时同步上下文 | `接着干 开发/测试/架构` |
|
||
| **switch-model** | 换大模型时同步上下文 | `切换模型 架构/开发/测试` |
|
||
| **update-constitution** | 更新宪法文件 | AI 角色/权限/工作流变更时 |
|
||
| **update-docs** | 更新项目文档 | 代码/结构变更后 |
|
||
| **git** | 封装 git 操作 | 提交/推送/分支管理时 |
|
||
|
||
---
|
||
|
||
## 任务状态流转
|
||
|
||
```
|
||
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/`，状态字段驱动，定期归档 |
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 克隆仓库
|
||
git clone <repository-url>
|
||
cd errlens
|
||
|
||
# 查看目录结构
|
||
find . -type d | sort
|
||
|
||
# 查看当前任务
|
||
ls -la review/
|
||
```
|
||
|
||
---
|
||
|
||
## 参考文档
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| [AGENTS.md](AGENTS.md) | AI角色定义与权限约定 |
|
||
| [workflow.json](.ai/config/workflow.json) | 工作流配置 |
|
||
| [P01-001 任务](review/P01-001/task.md) | 示例任务单 |
|
||
|
||
---
|
||
|
||
## 版本历史
|
||
|
||
| 版本 | 日期 | 说明 |
|
||
|------|------|------|
|
||
| v1.0 | 2026-05-22 | 初始版本，完成目录结构设计 | |