hwd32/ai_soc_sw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9f493c12f91fe14623b35579a012b7f7cdf14a3f
ai_soc_sw/docs/PROJECT_CONTEXT.md
T
tupingr 9f493c12f9 feat(context): 新增 resume-context Skill 和项目上下文文档体系 
- 新增 resume-context Skill（接着干）- 换电脑时自动同步上下文
- 新增 docs/PROJECT_CONTEXT.md 项目整体上下文
- 新增 docs/DECISIONS.md 架构决策记录（ADR）
- 新增 docs/06_开发日志/ 按日期记录讨论内容
- 新增根目录 ENVIRONMENT.md 开发环境配置
- 更新 ai-collab-setup/SKILL.md 版本升至 v2.2
2026-05-23 21:53:05 +08:00

4.1 KiB
Raw Blame History

项目上下文 - ErrLens 错题本

项目愿景

打造跨平台的学生错题本应用，配套 Web 管理后台和数据训练算法，形成"数据采集 → AI 分析 → 个性化推荐"的数据飞轮。

当前阶段

框架搭建阶段（2026-05-23 完成）

已完成：

  • ✅ "1 人 + 2AI（Dev AI + QA AI）"协作框架
  • ✅ 完整目录结构和权限体系（R/W/RW/- 四态）
  • ✅ AI 配置文件（coder.json、tester.json、workflow.json）
  • ✅ 提示词模板（code-style.md、doc-template.md、bug-report.md）
  • ✅ Skill 工具（ai-collab-setup、add-subproject、resume-context）
  • ✅ 项目级文档目录（docs/、tools/、data/）

待启动：

  • ⏳ P01_errlens_app 小程序开发
  • ⏳ P02_errlens_training 数据训练算法
  • ⏳ P03_errlens_web Web 管理后台

技术栈

层级 技术选型 说明
小程序 Taro + React + TypeScript 跨平台（微信优先，预留支付宝/抖音）
Web 管理 Next.js + React + TypeScript SSR，便于 SEO 和性能
后端 NestJS + TypeScript 统一语言，便于维护
数据库 PostgreSQL 关系型数据，支持复杂查询
AI 训练 Python + PyTorch 错题分析和推荐算法
包管理 pnpm 快速、节省磁盘空间
协作框架 1 人 + 2AI Dev AI（编码）+ QA AI（测试）

团队架构

人类负责人（唯一决策者）
├── Dev AI（编码 AI）- 编写代码、文档、影响评估
└── QA AI（测试 AI）- 编写测试、执行测试、质量保障

详细权限见 AGENTS.md

关键决策

决策 原因 日期
采用 R/W/RW/- 四态权限体系 比二元权限更灵活，明确只读路径 2026-05-23
项目级文档放在根目录 docs/ 不属于任何子项目，业界标准做法 2026-05-23
新增 tools/ 和 data/ 目录 开发工具和训练数据需要独立管理 2026-05-23
创建 resume-context Skill 解决多电脑切换时的上下文同步问题 2026-05-23
工作流增加 retry 机制 允许最多 3 轮测试修复循环 2026-05-23
工作流增加 escalation 机制 第 3 轮仍有严重 Bug 时升级给人类 2026-05-23

待解决问题

  1. Web 管理后台具体功能 - 尚未确定，需要简化设计，保持可扩展性
  2. 数据来源 - 用户有一些数据但不够，需要数据飞轮思维
  3. 跨平台优先级 - 目前主要是微信，但框架上要考虑跨平台
  4. AI 训练算法细节 - 错题分析和推荐算法的具体实现方案

下一步计划

  1. 完成产品需求文档（PRD）
  2. 完成系统架构设计
  3. 启动 P01_errlens_app 小程序开发
  4. 设计数据采集方案
  5. 规划 Web 管理后台功能

项目结构

errlens/
├── docs/                    # 项目级总体文档
│   ├── 01_产品需求/
│   ├── 02_系统架构/
│   ├── 03_开发规范/
│   ├── 04_部署运维/
│   ├── 05_变更日志/
│   └── 06_开发日志/
├── tools/                   # 开发工具脚本
├── data/                    # 训练数据
├── projects/                # 子项目
│   ├── P01_errlens_app/     # 错题本小程序
│   ├── P02_errlens_training/# 数据训练算法
│   └── P03_errlens_web/     # Web 管理后台
├── review/                  # 任务交接中心
├── reports/                 # 测试/质量报告
├── shared/                  # 共享资源
└── .ai/                     # AI 协作配置

开发环境

  • 操作系统: Windows / macOS / Linux（跨平台开发）
  • IDE: Trae CN
  • Node.js: >= 20.x
  • 包管理器: pnpm >= 9.0.0
  • Python: >= 3.10（AI 训练）

同步机制

  • 代码同步: Git（远程仓库：GitCode）
  • 上下文同步: docs/PROJECT_CONTEXT.md + docs/06_开发日志/
  • 恢复上下文: 使用 resume-context Skill

最后更新: 2026-05-23
维护者: 人类负责人 + Dev AI

Reference in New Issue View Git Blame Copy Permalink