ai_soc_sw/README.md

# ErrLens

一个"人+3AI"协作模式的 AI 编程项目。学生错题本应用（小程序 + AI 训练 + Web 后台）。

---

## 快速入口

| 入口 | 谁看 | 说明 |
|------|------|------|
| [DASHBOARD.md](DASHBOARD.md) | 人类 | 30 秒了解项目全貌 |
| [ROADMAP.md](ROADMAP.md) | 人类 + AI | 阶段进度 + 任务看板 |
| [docs/share/](docs/share/) | 所有人 | 项目开发过程全记录 |
| [.ai/roles/](.ai/roles/) | AI | 角色工作台（每个 AI 的入口） |

---

## 团队角色

| 角色 | 是谁 | 干什么 |
|------|------|--------|
| 人类负责人 | 你 | 需求、审阅、决策、验收 |
| Arch AI | AI 模型 | 需求分析、架构设计、跨模块协调 |
| Dev AI | AI 模型 | 写代码、写文档、修 Bug |
| QA AI | AI 模型 | 写测试、跑测试、写反馈 |

角色详情：[AGENTS.md](AGENTS.md)

---

## 快速开始

```bash
git clone <repository-url>
cd errlens

# 安装前端依赖
pnpm install

# 启动 P01 开发服务器
cd projects/P01_errlens_app
pnpm dev
```

---

## 目录结构

```
.
├── DASHBOARD.md         # 人类仪表盘
├── ROADMAP.md           # 路线图看板
├── AGENTS.md            # AI 角色 + 权限
├── ENVIRONMENT.md        # 开发环境
├── .ai/                 # AI 协作核心
│   ├── roles/           # 角色工作台（AI 日常入口）
│   ├── phases/          # 阶段上下文
│   ├── knowledge/       # 知识沉淀
│   ├── prompts/         # 提示词模板
│   └── config/          # 角色配置
├── docs/                # 项目文档
│   ├── 01_产品需求/
│   ├── 02_系统架构/
│   ├── share/           # 对外分享内容
│   └── ...
├── projects/            # 代码
│   ├── P01_errlens_app/
│   ├── P02_errlens_training/
│   └── P03_errlens_web/
├── review/              # 任务交接
│   └── active/          # 活跃任务
├── shared/              # 共享资源
└── tools/               # 开发工具
```

---

## 可用 Skill

| Skill | 功能 |
|-------|------|
| resume-context | 换电脑时同步上下文 |
| switch-model | 换大模型时同步上下文 |
| update-constitution | 更新 AI 角色/权限/工作流 |
| update-docs | 代码变更后同步文档 |
| git | 封装 git 操作 |
| ai-collab-setup | 初始化协作框架 |
| add-subproject | 添加子项目 |