From 837d0679286a766b82d0dd5bb31c2f35052f4e9a Mon Sep 17 00:00:00 2001 From: tupingr Date: Fri, 22 May 2026 15:27:36 +0800 Subject: [PATCH] =?UTF-8?q?Initial=20commit:=201=E4=BA=BA+2AI=E5=8D=8F?= =?UTF-8?q?=E4=BD=9C=E6=A1=86=E6=9E=B6=20-=20=E5=AE=8C=E6=95=B4=E7=9B=AE?= =?UTF-8?q?=E5=BD=95=E7=BB=93=E6=9E=84=E5=92=8CAI=E5=AE=AA=E6=B3=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .ai/config/coder.json | 26 ++ .ai/config/tester.json | 26 ++ .ai/config/workflow.json | 53 ++++ .gitignore | 58 ++++ .trae/skills/ai-collab-setup/SKILL.md | 287 ++++++++++++++++++ AGENTS.md | 188 ++++++++++++ README.md | 141 +++++++++ projects/P01_errlens_app/ENVIRONMENT.md | 37 +++ projects/P01_errlens_app/docs/01_需求概要.md | 21 ++ projects/P01_errlens_app/docs/02_架构设计.md | 59 ++++ projects/P01_errlens_app/docs/03_接口定义.md | 95 ++++++ projects/P02_errlens_training/ENVIRONMENT.md | 38 +++ .../P02_errlens_training/docs/01_需求概要.md | 21 ++ .../P02_errlens_training/docs/02_架构设计.md | 39 +++ .../P02_errlens_training/docs/03_训练流程.md | 50 +++ review/active/CROSS-001/acceptance.md | 20 ++ .../active/CROSS-001/feedback/P01-round1.md | 23 ++ .../active/CROSS-001/feedback/P02-round1.md | 19 ++ review/active/CROSS-001/impact.md | 22 ++ review/active/CROSS-001/task.md | 26 ++ review/active/P01-001/acceptance.md | 24 ++ review/active/P01-001/feedback/round1.md | 37 +++ review/active/P01-001/impact.md | 26 ++ review/active/P01-001/task.md | 30 ++ review/active/P01-002/acceptance.md | 21 ++ review/active/P01-002/impact.md | 18 ++ review/active/P01-002/task.md | 27 ++ review/active/P02-001/acceptance.md | 19 ++ review/active/P02-001/impact.md | 18 ++ review/active/P02-001/task.md | 29 ++ 30 files changed, 1498 insertions(+) create mode 100644 .ai/config/coder.json create mode 100644 .ai/config/tester.json create mode 100644 .ai/config/workflow.json create mode 100644 .gitignore create mode 100644 .trae/skills/ai-collab-setup/SKILL.md create mode 100644 AGENTS.md create mode 100644 README.md create mode 100644 projects/P01_errlens_app/ENVIRONMENT.md create mode 100644 projects/P01_errlens_app/docs/01_需求概要.md create mode 100644 projects/P01_errlens_app/docs/02_架构设计.md create mode 100644 projects/P01_errlens_app/docs/03_接口定义.md create mode 100644 projects/P02_errlens_training/ENVIRONMENT.md create mode 100644 projects/P02_errlens_training/docs/01_需求概要.md create mode 100644 projects/P02_errlens_training/docs/02_架构设计.md create mode 100644 projects/P02_errlens_training/docs/03_训练流程.md create mode 100644 review/active/CROSS-001/acceptance.md create mode 100644 review/active/CROSS-001/feedback/P01-round1.md create mode 100644 review/active/CROSS-001/feedback/P02-round1.md create mode 100644 review/active/CROSS-001/impact.md create mode 100644 review/active/CROSS-001/task.md create mode 100644 review/active/P01-001/acceptance.md create mode 100644 review/active/P01-001/feedback/round1.md create mode 100644 review/active/P01-001/impact.md create mode 100644 review/active/P01-001/task.md create mode 100644 review/active/P01-002/acceptance.md create mode 100644 review/active/P01-002/impact.md create mode 100644 review/active/P01-002/task.md create mode 100644 review/active/P02-001/acceptance.md create mode 100644 review/active/P02-001/impact.md create mode 100644 review/active/P02-001/task.md diff --git a/.ai/config/coder.json b/.ai/config/coder.json new file mode 100644 index 0000000..ffe122f --- /dev/null +++ b/.ai/config/coder.json @@ -0,0 +1,26 @@ +{ + "name": "Dev AI", + "role": "代码开发者", + "responsibilities": [ + "编写业务代码", + "生成技术文档", + "维护代码质量" + ], + "allowed_paths": [ + "projects/*/src/", + "projects/*/docs/", + "shared/", + "review/*/task.md", + "review/*/acceptance.md", + "review/*/impact.md" + ], + "forbidden_paths": [ + "projects/*/tests/", + "reports/", + "review/*/feedback/" + ], + "prompt_templates": { + "coding": ".ai/prompts/coding/", + "documentation": ".ai/prompts/coding/" + } +} \ No newline at end of file diff --git a/.ai/config/tester.json b/.ai/config/tester.json new file mode 100644 index 0000000..eef3c42 --- /dev/null +++ b/.ai/config/tester.json @@ -0,0 +1,26 @@ +{ + "name": "QA AI", + "role": "测试工程师", + "responsibilities": [ + "编写测试用例", + "执行测试", + "生成测试报告", + "提供反馈" + ], + "allowed_paths": [ + "projects/*/tests/", + "reports/", + "review/*/acceptance.md", + "review/*/feedback/" + ], + "forbidden_paths": [ + "projects/*/src/", + "projects/*/docs/", + "shared/", + "review/*/task.md", + "review/*/impact.md" + ], + "prompt_templates": { + "testing": ".ai/prompts/testing/" + } +} \ No newline at end of file diff --git a/.ai/config/workflow.json b/.ai/config/workflow.json new file mode 100644 index 0000000..5fe31c7 --- /dev/null +++ b/.ai/config/workflow.json @@ -0,0 +1,53 @@ +{ + "workflow": "human-ai-collaboration", + "roles": ["human", "dev-ai", "qa-ai"], + "stages": [ + { + "name": "需求分析", + "actor": "human", + "output": "review/{task_id}/task.md" + }, + { + "name": "开发实现", + "actor": "dev-ai", + "input": "review/{task_id}/task.md", + "output": ["projects/*/src/", "projects/*/docs/"] + }, + { + "name": "影响评估", + "actor": "dev-ai", + "output": "review/{task_id}/impact.md" + }, + { + "name": "验收标准定义", + "actor": "dev-ai", + "output": "review/{task_id}/acceptance.md" + }, + { + "name": "测试设计", + "actor": "qa-ai", + "input": ["review/{task_id}/task.md", "review/{task_id}/acceptance.md"], + "output": "projects/*/tests/" + }, + { + "name": "测试执行", + "actor": "qa-ai", + "output": ["reports/test-results/", "reports/reviews/"] + }, + { + "name": "反馈提交", + "actor": "qa-ai", + "output": "review/{task_id}/feedback/round{round}.md" + }, + { + "name": "验收确认", + "actor": "human", + "input": ["review/{task_id}/feedback/", "reports/test-results/"] + } + ], + "ci_triggers": { + "on_push_to_main": ["run-tests", "generate-reports"], + "on_pr_open": ["run-tests", "code-review"], + "on_task_update": ["notify-qa-ai"] + } +} \ No newline at end of file diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..22e887f --- /dev/null +++ b/.gitignore @@ -0,0 +1,58 @@ +# Dependencies +node_modules/ +vendor/ +__pycache__/ +*.pyc +*.pyo +venv/ + +# Build outputs +dist/ +build/ +*.log +*.out + +# IDE +.vscode/ +.idea/ +*.swp +*.swo +*.DS_Store + +# OS +Thumbs.db +.DS_Store + +# Environment variables +.env +.env.local +.env.*.local +.env.production + +# Test reports +reports/test-results/*.json +reports/test-results/*.xml +reports/reviews/*.md + +# Model files +models/ +*.pt +*.pth +*.onnx + +# Data files +data/ +*.csv +*.jsonl + +# Temporary files +*.tmp +*.temp +*.bak + +# Logs +logs/ +*.log + +# AI history (optional - uncomment to track) +# .ai/history/ \ No newline at end of file diff --git a/.trae/skills/ai-collab-setup/SKILL.md b/.trae/skills/ai-collab-setup/SKILL.md new file mode 100644 index 0000000..985c48b --- /dev/null +++ b/.trae/skills/ai-collab-setup/SKILL.md @@ -0,0 +1,287 @@ +--- +name: "ai-collab-setup" +description: "Creates complete '1 Human + 2 AI' collaboration framework with directory structure and AI constitution. Invoke when starting a new AI-assisted programming project." +--- + +# AI 协作框架快速搭建 + +## 功能 + +一键创建"1 人+2AI(Coder+Tester)"协作框架,包括: +- 完整的目录结构 +- AI 角色定义与权限约定(AGENTS.md) +- AI 配置文件 +- 示例任务模板 +- README 文档 + +## 使用方法 + +在新项目根目录执行: + +```bash +# 调用此 skill +# skill 会自动创建所有必要的目录和文件 +``` + +## 创建的内容 + +### 目录结构 +``` +. +├── AGENTS.md # AI 宪法(角色定义 + 权限约定) +├── README.md # 项目说明 +├── .gitignore +├── .ai/ +│ ├── config/ +│ │ ├── coder.json # Dev AI 配置 +│ │ ├── tester.json # QA AI 配置 +│ │ └── workflow.json # 工作流配置 +│ └── prompts/ +│ ├── coding/ # 编码提示词 +│ └── testing/ # 测试提示词 +├── projects/ +│ ├── P01_app/ +│ │ ├── src/ # Dev AI 工作区 +│ │ ├── tests/ # QA AI 工作区 +│ │ ├── docs/ +│ │ └── ENVIRONMENT.md +│ └── P02_training/ +│ ├── src/ +│ ├── tests/ +│ ├── docs/ +│ └── ENVIRONMENT.md +├── review/ +│ ├── active/ # 活跃任务 +│ │ ├── P01-001/ +│ │ │ ├── task.md +│ │ │ ├── acceptance.md +│ │ │ ├── impact.md +│ │ │ └── feedback/ +│ │ ├── P01-002/ +│ │ └── CROSS-001/ +│ └── archived/ # 归档任务 +│ └── 2026-Q2/ +├── shared/ +│ ├── scripts/ +│ ├── templates/ +│ └── utils/ +├── reports/ +│ ├── test-results/ +│ └── quality-reports/ +└── .github/workflows/ +``` + +### 核心文件 + +**AGENTS.md** - AI 宪法: +- 三个角色定义(人类、Dev AI、QA AI) +- 权限矩阵 +- 工作流程(8 个步骤) +- 沟通规范 +- 命名规范 + +**AI 配置文件**: +- `.ai/config/coder.json` - Dev AI 权限和职责 +- `.ai/config/tester.json` - QA AI 权限和职责 +- `.ai/config/workflow.json` - 工作流配置 + +**示例任务**: +- `review/active/P01-001/` - 示例任务(包含 task、acceptance、impact、feedback) +- `review/active/CROSS-001/` - 跨项目任务示例 + +## 执行命令 + +```bash +# 1. 创建目录结构 +mkdir -p .ai/{config,prompts/{coding,testing}} \ + projects/{P01_app,P02_training}/{src,tests,docs} \ + review/{active/{P01-001, P01-002, CROSS-001},archived/2026-Q2}/feedback \ + shared/{scripts,templates,utils} \ + reports/{test-results,quality-reports} \ + .github/workflows + +# 2. 创建 AGENTS.md +cat > AGENTS.md << 'EOF' +# AI 角色定义与权限约定 + +## 团队架构 + +| 角色 | 是谁 | 干什么 | 不干什么 | +|------|------|--------|----------| +| 人类 | 你 | 下指令、审阅、做决策 | 不写代码、不写测试 | +| Dev AI | Claude/TRAE 等 | 写代码 + 文档、修 bug | 不动 tests/、不跑测试 | +| QA AI | 扣子编程 AI | 写测试、跑测试、写反馈 | 不动 src/、不改业务代码 | + +## 目录权限矩阵 + +| 目录 | Dev AI | QA AI | 人类 | +|------|--------|-------|------| +| projects/*/src/ | ✅ | ❌ | ✅ | +| projects/*/tests/ | ❌ | ✅ | ✅ | +| projects/*/docs/ | ✅ | ❌ | ✅ | +| review/*/task.md | ❌ | ❌ | ✅ | +| review/*/acceptance.md | ✅ | ✅ | ✅ | +| review/*/impact.md | ✅ | ❌ | ✅ | +| review/*/feedback/ | ❌ | ✅ | ✅ | +| shared/ | ✅ | ❌ | ✅ | +| reports/ | ❌ | ✅ | ✅ | + +## 工作流程 + +1. 人类创建 task.md +2. Dev AI 写代码、文档、impact.md +3. 人类审核 +4. QA AI 写测试、执行、写 feedback +5. 人类确认或返回修改 + +## 任务状态 + +TODO → IN_PROGRESS → REVIEW → DONE → ARCHIVED +EOF + +# 3. 创建 README.md +cat > README.md << 'EOF' +# AI 协作项目 + +## 目录结构 + +详见 AGENTS.md + +## 快速开始 + +1. 在 review/active/ 下创建任务目录 +2. 编写 task.md +3. Dev AI 开始工作 +EOF + +# 4. 创建 AI 配置 +cat > .ai/config/coder.json << 'EOF' +{ + "name": "Dev AI", + "role": "代码开发者", + "allowed_paths": ["projects/*/src/", "projects/*/docs/", "shared/"], + "forbidden_paths": ["projects/*/tests/", "reports/"] +} +EOF + +cat > .ai/config/tester.json << 'EOF' +{ + "name": "QA AI", + "role": "测试工程师", + "allowed_paths": ["projects/*/tests/", "reports/"], + "forbidden_paths": ["projects/*/src/", "shared/"] +} +EOF + +cat > .ai/config/workflow.json << 'EOF' +{ + "workflow": "human-ai-collaboration", + "roles": ["human", "dev-ai", "qa-ai"], + "stages": [ + {"name": "需求分析", "actor": "human"}, + {"name": "开发实现", "actor": "dev-ai"}, + {"name": "测试执行", "actor": "qa-ai"}, + {"name": "验收确认", "actor": "human"} + ] +} +EOF + +# 5. 创建示例任务 +cat > review/active/P01-001/task.md << 'EOF' +# P01-001 - 示例任务 + +## 任务信息 +- 任务编号:P01-001 +- 项目:P01_app +- 状态:TODO + +## 任务描述 +这是一个示例任务,展示任务单的结构。 + +## 交付物 +- src/example.js +- tests/example.test.js +EOF + +cat > review/active/P01-001/acceptance.md << 'EOF' +# P01-001 - 验收标准 + +## 功能验收 +- [ ] 功能点 1 +- [ ] 功能点 2 + +## 测试覆盖要求 +- 单元测试覆盖率:>= 80% +EOF + +cat > review/active/P01-001/impact.md << 'EOF' +# P01-001 - 变更影响范围 + +## 修改的文件 +| 文件路径 | 修改类型 | 影响等级 | +|---------|---------|---------| +| src/example.js | 新增 | HIGH | + +## 需要回归测试的场景 +- 场景 1 +EOF + +cat > review/active/P01-001/feedback/round1.md << 'EOF' +# P01-001 - 第一轮测试反馈 + +## 测试结果 +- 通过:0 +- 失败:0 + +## 反馈 +待执行测试 +EOF + +# 6. 创建项目环境文件 +cat > projects/P01_app/ENVIRONMENT.md << 'EOF' +# P01_app - 环境准备 + +## 依赖 +- Node.js >= 20.x +- npm >= 10.x + +## 安装 +npm install +EOF + +cat > projects/P02_training/ENVIRONMENT.md << 'EOF' +# P02_training - 环境准备 + +## 依赖 +- Python >= 3.10 +- PyTorch >= 2.0 + +## 安装 +pip install -r requirements.txt +EOF +``` + +## 使用场景 + +**何时调用此 skill:** +- ✅ 启动新的 AI 辅助编程项目 +- ✅ 需要建立标准化的 AI 协作流程 +- ✅ 团队开始使用"1 人+2AI"模式 + +**不适用场景:** +- ❌ 纯人工开发项目 +- ❌ 已有现成的协作框架 + +## 后续步骤 + +skill 执行后: +1. 检查 `review/active/P01-001/` 示例任务 +2. 根据实际需求修改 `AGENTS.md` +3. 创建第一个真实任务 +4. 开始协作开发 + +--- + +**Version**: 1.0 +**Created**: 2026-05-22 +**Based On**: ErrLens AI Programming Project \ No newline at end of file diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..320e789 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,188 @@ +# AI 角色定义与权限约定 + +## 团队架构 +``` +┌─────────────────────────────────────────────┐ +│ 人类负责人 │ +│ 需求分析 · 架构设计 · 最终决策 │ +└───────────────────┬─────────────────────────┘ + │ + ┌───────────┴───────────┐ + ▼ ▼ +┌───────────────┐ ┌───────────────┐ +│ Dev AI │ │ QA AI │ +│ 代码编写 │ │ 测试设计 │ +│ 文档生成 │ │ 测试执行 │ +│ 影响评估 │ │ 质量保障 │ +└───────────────┘ └───────────────┘ +``` + +--- + +## 角色职责 + +### Dev AI (编码AI) +**职责范围:** +- ✅ 编写业务代码 (`projects/*/src/`) +- ✅ 生成技术文档 (`projects/*/docs/`) +- ✅ 定义验收标准 (`review/*/acceptance.md`) +- ✅ 评估变更影响 (`review/*/impact.md`) +- ✅ 维护共享资源 (`shared/`) + +**禁止操作:** +- ❌ 修改测试代码 (`projects/*/tests/`) +- ❌ 修改测试报告 (`reports/`) +- ❌ 提交测试反馈 (`review/*/feedback/`) + +### QA AI (测试AI) +**职责范围:** +- ✅ 编写测试用例 (`projects/*/tests/`) +- ✅ 执行测试并生成报告 (`reports/`) +- ✅ 补充验收标准 (`review/*/acceptance.md`) +- ✅ 提交测试反馈 (`review/*/feedback/`) + +**禁止操作:** +- ❌ 修改业务代码 (`projects/*/src/`) +- ❌ 修改技术文档 (`projects/*/docs/`) +- ❌ 修改共享资源 (`shared/`) +- ❌ 修改任务描述和影响评估 + +### 人类负责人 +**职责范围:** +- ✅ 可以修改所有目录 +- ✅ 审核 AI 输出质量 +- ✅ 解决 AI 之间的冲突 +- ✅ 最终决策和验收 + +--- + +## 工作流程 + +``` +┌─────────────┐ ┌─────────────┐ ┌─────────────┐ +│ 需求分析 │ ──→ │ 开发实现 │ ──→ │ 影响评估 │ +│ (人类) │ │ (Dev AI) │ │ (Dev AI) │ +└─────────────┘ └─────────────┘ └─────────────┘ + │ │ │ + ▼ ▼ ▼ +┌─────────────┐ ┌─────────────┐ ┌─────────────┐ +│ 验收标准 │ ──→ │ 测试设计 │ ──→ │ 测试执行 │ +│ (Dev AI) │ │ (QA AI) │ │ (QA AI) │ +└─────────────┘ └─────────────┘ └─────────────┘ + │ + ▼ +┌─────────────┐ ┌─────────────┐ +│ 反馈提交 │ ──→ │ 验收确认 │ +│ (QA AI) │ │ (人类) │ +└─────────────┘ └─────────────┘ +``` + +### 详细流程说明 + +**1. 需求分析阶段** +- 人类负责人创建任务单 +- 输出: `review/{task_id}/task.md` + +**2. 开发实现阶段** +- Dev AI 根据任务描述编写代码 +- 输出: `projects/*/src/`, `projects/*/docs/` + +**3. 影响评估阶段** +- Dev AI 分析变更影响范围 +- 输出: `review/{task_id}/impact.md` + +**4. 验收标准定义** +- Dev AI 定义验收标准 +- QA AI 可补充测试要点 +- 输出: `review/{task_id}/acceptance.md` + +**5. 测试设计阶段** +- QA AI 根据验收标准编写测试用例 +- 输出: `projects/*/tests/` + +**6. 测试执行阶段** +- QA AI 执行测试并生成报告 +- 输出: `reports/test-results/`, `reports/quality-reports/` + +**7. 反馈提交阶段** +- QA AI 提交测试反馈 +- 输出: `review/{task_id}/feedback/round{round}.md` + +**8. 验收确认阶段** +- 人类负责人审核测试结果 +- 确认任务完成或返回修改 + +--- + +## 目录权限矩阵 + +| 目录路径 | Dev AI | QA AI | 人类 | +|---------|--------|-------|------| +| `.ai/` | ❌ | ❌ | ✅ | +| `shared/` | ✅ | ❌ | ✅ | +| `projects/*/src/` | ✅ | ❌ | ✅ | +| `projects/*/tests/` | ❌ | ✅ | ✅ | +| `projects/*/docs/` | ✅ | ❌ | ✅ | +| `review/*/task.md` | ❌ | ❌ | ✅ | +| `review/*/acceptance.md` | ✅ | ✅ | ✅ | +| `review/*/impact.md` | ✅ | ❌ | ✅ | +| `review/*/feedback/` | ❌ | ✅ | ✅ | +| `reports/` | ❌ | ✅ | ✅ | +| `.github/` | ❌ | ❌ | ✅ | + +--- + +## 沟通规范 + +### Dev AI → QA AI +在 `review/{task_id}/` 目录提交: +- **验收标准** (`acceptance.md`) - 明确测试目标 +- **变更影响范围** (`impact.md`) - 指导回归测试 +- **环境准备** 参考项目级 `ENVIRONMENT.md` + +### QA AI → Dev AI +在 `review/{task_id}/feedback/` 目录提交: +- **测试结果报告** (`round{round}.md`) +- **Bug清单** - 列出问题和严重程度 +- **改进建议** - 代码优化建议 + +--- + +## 命名规范 + +### 项目命名 +``` +P01_项目名称 # P01 表示项目编号 +``` + +### 任务编号 +``` +P01-001 # P01 项目编号 + 001 任务编号 +``` + +### 分支命名 +``` +feature/P01-001-login # 功能开发 +bugfix/P01-001-password # Bug修复 +test/P01-001-testcases # 测试用例 +``` + +### 提交信息 +``` +feat(P01-001): 实现用户登录功能 +fix(P01-001): 修复密码验证问题 +docs(P01-001): 更新接口文档 +test(P01-001): 添加登录测试用例 +``` + +--- + +## AI 配置文件说明 + +| 文件 | 说明 | +|------|------| +| `.ai/config/coder.json` | Dev AI 配置(权限、职责) | +| `.ai/config/tester.json` | QA AI 配置(权限、职责) | +| `.ai/config/workflow.json` | 工作流配置(阶段、触发器) | +| `.ai/prompts/coding/` | 编码提示词模板 | +| `.ai/prompts/testing/` | 测试提示词模板 | \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..4b55dac --- /dev/null +++ b/README.md @@ -0,0 +1,141 @@ +# 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/`,状态字段驱动,定期归档 | + +--- + +## 快速开始 + +```bash +# 克隆仓库 +git clone +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 | 初始版本,完成目录结构设计 | \ No newline at end of file diff --git a/projects/P01_errlens_app/ENVIRONMENT.md b/projects/P01_errlens_app/ENVIRONMENT.md new file mode 100644 index 0000000..9c65f7f --- /dev/null +++ b/projects/P01_errlens_app/ENVIRONMENT.md @@ -0,0 +1,37 @@ +# P01_errlens_app - 环境准备指南 + +## 依赖要求 +- Node.js >= 20.x +- npm >= 10.x +- 数据库: PostgreSQL 15+ + +## 安装步骤 +```bash +# 安装依赖 +npm install + +# 配置环境变量 +cp .env.example .env + +# 初始化数据库 +npm run db:migrate +``` + +## 环境变量 +| 变量名 | 说明 | 默认值 | +|--------|------|--------| +| PORT | 服务端口 | 3000 | +| DATABASE_URL | 数据库连接 | postgresql://localhost:5432/errlens | +| NODE_ENV | 运行环境 | development | + +## 运行命令 +```bash +# 开发模式 +npm run dev + +# 生产构建 +npm run build + +# 运行测试 +npm test +``` \ No newline at end of file diff --git a/projects/P01_errlens_app/docs/01_需求概要.md b/projects/P01_errlens_app/docs/01_需求概要.md new file mode 100644 index 0000000..5d2d5ab --- /dev/null +++ b/projects/P01_errlens_app/docs/01_需求概要.md @@ -0,0 +1,21 @@ +# P01_errlens_app - 需求概要 + +## 项目概述 +ErrLens 是一个 AI 辅助编程工具,旨在帮助开发者快速定位和修复代码错误。 + +## 核心功能 +1. **错误检测** - 实时分析代码中的潜在问题 +2. **智能修复** - 自动生成修复建议 +3. **代码审查** - 提供代码质量评估 +4. **学习建议** - 根据错误类型提供学习资源 + +## 用户角色 +- 初级开发者:学习编程时获得实时反馈 +- 中级开发者:提高代码质量和效率 +- 团队负责人:监控团队代码质量 + +## 技术栈 +- 前端:React + TypeScript +- 后端:Node.js + Express +- 数据库:PostgreSQL +- AI 服务:自定义模型 + OpenAI API \ No newline at end of file diff --git a/projects/P01_errlens_app/docs/02_架构设计.md b/projects/P01_errlens_app/docs/02_架构设计.md new file mode 100644 index 0000000..482506f --- /dev/null +++ b/projects/P01_errlens_app/docs/02_架构设计.md @@ -0,0 +1,59 @@ +# P01_errlens_app - 架构设计 + +## 系统架构 +采用微服务架构,前后端分离。 + +### 架构图 +``` +┌─────────────────────────────────────────────────────┐ +│ 前端层 │ +│ React + TypeScript + Tailwind CSS │ +└──────────────────────┬──────────────────────────────┘ + │ HTTP/WebSocket + ▼ +┌─────────────────────────────────────────────────────┐ +│ API网关 │ +│ Express + Middleware │ +└──────────────────────┬──────────────────────────────┘ + │ + ┌─────────────────┼─────────────────┐ + ▼ ▼ ▼ +┌──────────┐ ┌──────────┐ ┌──────────┐ +│ 代码分析 │ │ AI服务 │ │ 用户管理 │ +│ Service │ │ Service │ │ Service │ +└──────────┘ └──────────┘ └──────────┘ + │ │ │ + └─────────────────┼─────────────────┘ + ▼ + ┌──────────────┐ + │ PostgreSQL │ + └──────────────┘ +``` + +## 核心模块 + +### 1. 代码分析模块 +- 解析源代码 +- 静态分析检测 +- 错误分类与评级 + +### 2. AI 服务模块 +- 调用 AI 模型 +- 生成修复建议 +- 优化提示词 + +### 3. 用户管理模块 +- 用户认证授权 +- 使用统计 +- 个性化配置 + +## 目录结构 +``` +src/ +├── api/ # REST API 路由 +├── controllers/ # 业务逻辑 +├── services/ # 核心服务 +├── models/ # 数据模型 +├── middleware/ # 中间件 +└── utils/ # 工具函数 +``` \ No newline at end of file diff --git a/projects/P01_errlens_app/docs/03_接口定义.md b/projects/P01_errlens_app/docs/03_接口定义.md new file mode 100644 index 0000000..50f8317 --- /dev/null +++ b/projects/P01_errlens_app/docs/03_接口定义.md @@ -0,0 +1,95 @@ +# P01_errlens_app - 接口定义 + +## API 基础路径 +`/api/v1` + +## 认证方式 +JWT Token,放在 Authorization 头: +``` +Authorization: Bearer +``` + +## 接口列表 + +### 1. 代码分析 + +#### POST /api/v1/analyze +分析代码中的错误 + +**请求体:** +```json +{ + "code": "string", + "language": "string", + "options": { + "strict": true + } +} +``` + +**响应:** +```json +{ + "success": true, + "errors": [ + { + "line": 10, + "column": 5, + "type": "error", + "message": "变量未定义", + "suggestion": "建议在使用前定义变量" + } + ] +} +``` + +### 2. 用户管理 + +#### POST /api/v1/users/login +用户登录 + +**请求体:** +```json +{ + "email": "string", + "password": "string" +} +``` + +**响应:** +```json +{ + "success": true, + "token": "string", + "user": { + "id": "string", + "email": "string", + "name": "string" + } +} +``` + +### 3. 修复建议 + +#### POST /api/v1/fix +获取修复建议 + +**请求体:** +```json +{ + "code": "string", + "error": { + "type": "string", + "message": "string" + } +} +``` + +**响应:** +```json +{ + "success": true, + "fixedCode": "string", + "explanation": "string" +} +``` \ No newline at end of file diff --git a/projects/P02_errlens_training/ENVIRONMENT.md b/projects/P02_errlens_training/ENVIRONMENT.md new file mode 100644 index 0000000..51961a9 --- /dev/null +++ b/projects/P02_errlens_training/ENVIRONMENT.md @@ -0,0 +1,38 @@ +# P02_errlens_training - 环境准备指南 + +## 依赖要求 +- Python >= 3.10 +- PyTorch >= 2.0 +- CUDA >= 11.8 (GPU训练) + +## 安装步骤 +```bash +# 创建虚拟环境 +python -m venv venv +source venv/bin/activate + +# 安装依赖 +pip install -r requirements.txt + +# 下载预训练模型 +python scripts/download_model.py +``` + +## 环境变量 +| 变量名 | 说明 | 默认值 | +|--------|------|--------| +| MODEL_DIR | 模型存储目录 | ./models | +| DATA_DIR | 数据集目录 | ./data | +| GPU_ENABLED | 是否使用GPU | true | + +## 运行命令 +```bash +# 训练模型 +python train.py + +# 评估模型 +python evaluate.py + +# 运行测试 +pytest tests/ +``` \ No newline at end of file diff --git a/projects/P02_errlens_training/docs/01_需求概要.md b/projects/P02_errlens_training/docs/01_需求概要.md new file mode 100644 index 0000000..0b1a8a9 --- /dev/null +++ b/projects/P02_errlens_training/docs/01_需求概要.md @@ -0,0 +1,21 @@ +# P02_errlens_training - 需求概要 + +## 项目概述 +ErrLens Training 是 AI 模型训练组件,负责训练和优化代码错误检测模型。 + +## 核心功能 +1. **数据集管理** - 收集和预处理训练数据 +2. **模型训练** - 训练代码分析模型 +3. **模型评估** - 评估模型性能 +4. **模型部署** - 导出和部署模型 + +## 技术栈 +- Python 3.10+ +- PyTorch 2.0 +- Hugging Face Transformers +- scikit-learn + +## 数据来源 +- 开源代码仓库 +- 开发者上传的错误代码 +- 人工标注的错误样本 \ No newline at end of file diff --git a/projects/P02_errlens_training/docs/02_架构设计.md b/projects/P02_errlens_training/docs/02_架构设计.md new file mode 100644 index 0000000..e0bea1c --- /dev/null +++ b/projects/P02_errlens_training/docs/02_架构设计.md @@ -0,0 +1,39 @@ +# P02_errlens_training - 架构设计 + +## 系统架构 + +### 架构图 +``` +┌─────────────────────────────────────────────────────┐ +│ 数据层 │ +│ 原始数据 → 清洗 → 标注 → 特征提取 → 数据集 │ +└──────────────────────┬──────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────┐ +│ 训练层 │ +│ 模型定义 → 训练循环 → 验证 → 保存 │ +└──────────────────────┬──────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────┐ +│ 评估层 │ +│ 测试集评估 → 指标计算 → 报告生成 │ +└──────────────────────┬──────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────┐ +│ 部署层 │ +│ 模型导出 → 量化优化 → 服务部署 │ +└─────────────────────────────────────────────────────┘ +``` + +## 目录结构 +``` +src/ +├── data/ # 数据处理模块 +├── models/ # 模型定义 +├── training/ # 训练逻辑 +├── evaluation/ # 评估模块 +└── deployment/ # 部署工具 +``` \ No newline at end of file diff --git a/projects/P02_errlens_training/docs/03_训练流程.md b/projects/P02_errlens_training/docs/03_训练流程.md new file mode 100644 index 0000000..b7b613a --- /dev/null +++ b/projects/P02_errlens_training/docs/03_训练流程.md @@ -0,0 +1,50 @@ +# P02_errlens_training - 训练流程 + +## 训练流程 + +### 阶段一:数据准备 +```bash +# 1. 下载原始数据 +python src/data/download.py + +# 2. 数据清洗 +python src/data/clean.py + +# 3. 数据标注(可选) +python src/data/label.py +``` + +### 阶段二:模型训练 +```bash +# 训练命令 +python src/training/train.py \ + --data data/train \ + --model-base microsoft/codebert-base \ + --epochs 10 \ + --batch-size 32 \ + --lr 2e-5 +``` + +### 阶段三:模型评估 +```bash +# 评估命令 +python src/evaluation/evaluate.py \ + --model models/best_model \ + --data data/test +``` + +### 阶段四:模型导出 +```bash +# 导出为 ONNX 格式 +python src/deployment/export.py \ + --model models/best_model \ + --output models/exported +``` + +## 评估指标 +| 指标 | 说明 | 目标值 | +|------|------|--------| +| Precision | 精确率 | >= 0.90 | +| Recall | 召回率 | >= 0.85 | +| F1 Score | F1分数 | >= 0.87 | +| Accuracy | 准确率 | >= 0.92 | \ No newline at end of file diff --git a/review/active/CROSS-001/acceptance.md b/review/active/CROSS-001/acceptance.md new file mode 100644 index 0000000..75ac022 --- /dev/null +++ b/review/active/CROSS-001/acceptance.md @@ -0,0 +1,20 @@ +# CROSS-001 - 验收标准 + +## 功能验收 +- [ ] 字符串处理工具优化完成 +- [ ] 日期格式化工具添加完成 +- [ ] 日志工具bug修复完成 +- [ ] P01 项目测试通过 +- [ ] P02 项目测试通过 + +## 非功能验收 +- [ ] 工具函数性能提升 >= 20% +- [ ] 代码覆盖率 >= 80% + +## 测试覆盖要求 +- P01 回归测试覆盖率: >= 90% +- P02 回归测试覆盖率: >= 90% + +## 验收通过条件 +- 所有功能点验证通过 +- 两个项目回归测试通过 \ No newline at end of file diff --git a/review/active/CROSS-001/feedback/P01-round1.md b/review/active/CROSS-001/feedback/P01-round1.md new file mode 100644 index 0000000..9f3f7fd --- /dev/null +++ b/review/active/CROSS-001/feedback/P01-round1.md @@ -0,0 +1,23 @@ +# CROSS-001 - P01 测试反馈 + +## 测试执行信息 +- 测试时间: 2026-05-23 +- 测试项目: P01_errlens_app +- 测试人员: QA AI + +## 测试结果概览 +- 测试用例总数: 15 +- 通过: 14 +- 失败: 1 +- 跳过: 0 + +## 失败用例详情 +- **测试点**: API响应日期格式 +- **预期结果**: 返回 ISO 8601 格式日期 +- **实际结果**: 返回格式不一致 +- **严重程度**: MEDIUM +- **建议修复**: 统一日期格式化输出 + +## 代码质量评估 +- 代码覆盖率: 85% +- 静态检查警告: 0 个 \ No newline at end of file diff --git a/review/active/CROSS-001/feedback/P02-round1.md b/review/active/CROSS-001/feedback/P02-round1.md new file mode 100644 index 0000000..cfc4ac1 --- /dev/null +++ b/review/active/CROSS-001/feedback/P02-round1.md @@ -0,0 +1,19 @@ +# CROSS-001 - P02 测试反馈 + +## 测试执行信息 +- 测试时间: 2026-05-23 +- 测试项目: P02_errlens_training +- 测试人员: QA AI + +## 测试结果概览 +- 测试用例总数: 12 +- 通过: 12 +- 失败: 0 +- 跳过: 0 + +## 代码质量评估 +- 代码覆盖率: 88% +- 静态检查警告: 0 个 + +## 测试结论 +P02 项目测试全部通过,工具库更新未引入新问题。 \ No newline at end of file diff --git a/review/active/CROSS-001/impact.md b/review/active/CROSS-001/impact.md new file mode 100644 index 0000000..3809fc6 --- /dev/null +++ b/review/active/CROSS-001/impact.md @@ -0,0 +1,22 @@ +# CROSS-001 - 变更影响范围 + +## 修改的文件 +| 文件路径 | 修改类型 | 影响等级 | +|---------|---------|---------| +| shared/utils/stringUtils.js | 更新 | HIGH | +| shared/utils/dateUtils.js | 新增 | MEDIUM | +| shared/utils/logUtils.js | 更新 | HIGH | + +## 影响的项目和模块 +- **P01_errlens_app**: + - [x] API模块 + - [x] 工具模块 +- **P02_errlens_training**: + - [x] 数据处理模块 + - [x] 日志模块 + +## 需要回归测试的场景 +- P01: API响应格式验证 +- P01: 日志记录完整性 +- P02: 数据处理流程 +- P02: 训练日志输出 \ No newline at end of file diff --git a/review/active/CROSS-001/task.md b/review/active/CROSS-001/task.md new file mode 100644 index 0000000..605f713 --- /dev/null +++ b/review/active/CROSS-001/task.md @@ -0,0 +1,26 @@ +# CROSS-001 - 共享工具库更新 + +## 任务信息 +- 任务编号: CROSS-001 +- 项目: 跨项目任务 +- 创建时间: 2026-05-22 +- 负责人: Dev AI +- 状态: TODO + +## 任务描述 +更新 shared/utils/ 中的工具函数,修复影响 P01 和 P02 的通用问题: +1. 优化字符串处理工具 +2. 添加日期格式化工具 +3. 修复日志工具的bug + +## 影响项目 +- P01_errlens_app +- P02_errlens_training + +## 需求来源 +- 技术债务清理计划 + +## 交付物 +- `shared/utils/stringUtils.js` - 字符串处理工具 +- `shared/utils/dateUtils.js` - 日期格式化工具 +- `shared/utils/logUtils.js` - 日志工具修复 \ No newline at end of file diff --git a/review/active/P01-001/acceptance.md b/review/active/P01-001/acceptance.md new file mode 100644 index 0000000..74bc0b9 --- /dev/null +++ b/review/active/P01-001/acceptance.md @@ -0,0 +1,24 @@ +# P01-001 - 验收标准 + +## 功能验收 +- [ ] 用户可以注册新账户 +- [ ] 用户可以使用邮箱密码登录 +- [ ] 登录成功返回 JWT Token +- [ ] 密码错误时返回明确的错误信息 +- [ ] 支持密码重置功能 + +## 非功能验收 +- [ ] 密码使用 bcrypt 加密存储 +- [ ] JWT Token 有效期为 24 小时 +- [ ] 密码强度验证(至少8位,包含大小写和数字) +- [ ] API 响应时间 < 200ms + +## 测试覆盖要求 +- 单元测试覆盖率: >= 80% +- 集成测试覆盖率: >= 60% +- E2E 测试场景: 3 个 + +## 验收通过条件 +- 所有功能点验证通过 +- 测试覆盖率达标 +- 无重大安全漏洞 \ No newline at end of file diff --git a/review/active/P01-001/feedback/round1.md b/review/active/P01-001/feedback/round1.md new file mode 100644 index 0000000..21ef10c --- /dev/null +++ b/review/active/P01-001/feedback/round1.md @@ -0,0 +1,37 @@ +# P01-001 - 第一轮测试反馈 + +## 测试执行信息 +- 测试时间: 2026-05-23 +- 测试人员: QA AI +- 测试环境: 测试服务器 + +## 测试结果概览 +- 测试用例总数: 12 +- 通过: 10 +- 失败: 2 +- 跳过: 0 + +## 失败用例详情 + +### 1. 用户注册 - 密码强度验证 +- **测试点**: 密码强度验证 +- **预期结果**: 密码不足8位时拒绝注册 +- **实际结果**: 密码6位也能注册成功 +- **严重程度**: HIGH +- **建议修复**: 增加密码长度验证逻辑 + +### 2. Token 过期测试 +- **测试点**: Token 过期处理 +- **预期结果**: Token 过期后返回 401 错误 +- **实际结果**: 返回 500 服务器错误 +- **严重程度**: MEDIUM +- **建议修复**: 在中间件中正确处理 TokenExpiredError + +## 代码质量评估 +- 代码覆盖率: 78% (目标: 80%) +- 静态检查警告: 3 个 +- 建议优化: authService.js 第45行有未使用的变量 + +## 下一步行动 +- Dev AI 修复上述问题 +- 进行第二轮测试 \ No newline at end of file diff --git a/review/active/P01-001/impact.md b/review/active/P01-001/impact.md new file mode 100644 index 0000000..40b6b0d --- /dev/null +++ b/review/active/P01-001/impact.md @@ -0,0 +1,26 @@ +# P01-001 - 变更影响范围 + +## 修改的文件 +| 文件路径 | 修改类型 | 影响等级 | +|---------|---------|---------| +| src/api/users.js | 新增 | HIGH | +| src/controllers/userController.js | 新增 | HIGH | +| src/services/authService.js | 新增 | HIGH | +| docs/03_接口定义.md | 更新 | MEDIUM | +| src/models/User.js | 更新 | MEDIUM | + +## 影响的功能模块 +- [x] 用户管理模块 +- [x] 认证授权模块 +- [ ] 代码分析模块(无影响) +- [ ] AI服务模块(无影响) + +## 需要回归测试的场景 +- 场景1: 用户注册后立即登录 +- 场景2: 使用错误密码登录 +- 场景3: 密码重置流程 +- 场景4: Token 过期后重新登录 + +## 外部依赖变更 +- 新增依赖: bcrypt, jsonwebtoken +- 影响说明: 需更新 package.json \ No newline at end of file diff --git a/review/active/P01-001/task.md b/review/active/P01-001/task.md new file mode 100644 index 0000000..78f05a3 --- /dev/null +++ b/review/active/P01-001/task.md @@ -0,0 +1,30 @@ +# P01-001 - 用户登录功能开发 + +## 任务信息 +- 任务编号: P01-001 +- 项目: P01_errlens_app +- 创建时间: 2026-05-22 +- 负责人: Dev AI +- 状态: TODO + +## 任务描述 +实现用户登录功能,包括: +1. 用户注册 +2. 用户登录(邮箱+密码) +3. JWT Token 生成 +4. 密码重置 + +## 需求来源 +- 产品需求文档: PRD-001 +- 相关Issue: #123 + +## 技术要求 +- 使用 bcrypt 进行密码加密 +- JWT Token 有效期 24 小时 +- 支持密码强度验证 + +## 交付物 +- `src/api/users.js` - 用户API路由 +- `src/controllers/userController.js` - 用户控制器 +- `src/services/authService.js` - 认证服务 +- `docs/03_接口定义.md` - 更新接口文档 \ No newline at end of file diff --git a/review/active/P01-002/acceptance.md b/review/active/P01-002/acceptance.md new file mode 100644 index 0000000..5aa1d8d --- /dev/null +++ b/review/active/P01-002/acceptance.md @@ -0,0 +1,21 @@ +# P01-002 - 验收标准 + +## 功能验收 +- [ ] 支持 JavaScript/TypeScript 代码分析 +- [ ] 支持 Python 代码分析 +- [ ] 检测常见语法错误 +- [ ] 检测代码质量问题 +- [ ] 生成修复建议 + +## 非功能验收 +- [ ] 分析时间 < 500ms +- [ ] 支持最大 1000 行代码 +- [ ] 错误分类准确率 >= 90% + +## 测试覆盖要求 +- 单元测试覆盖率: >= 75% +- 集成测试覆盖率: >= 50% + +## 验收通过条件 +- 所有功能点验证通过 +- 测试覆盖率达标 \ No newline at end of file diff --git a/review/active/P01-002/impact.md b/review/active/P01-002/impact.md new file mode 100644 index 0000000..a451056 --- /dev/null +++ b/review/active/P01-002/impact.md @@ -0,0 +1,18 @@ +# P01-002 - 变更影响范围 + +## 修改的文件 +| 文件路径 | 修改类型 | 影响等级 | +|---------|---------|---------| +| src/api/analyze.js | 新增 | HIGH | +| src/controllers/analyzeController.js | 新增 | HIGH | +| src/services/analyzeService.js | 新增 | HIGH | + +## 影响的功能模块 +- [x] 代码分析模块 +- [x] AI服务模块 +- [ ] 用户管理模块(无影响) + +## 需要回归测试的场景 +- 场景1: JavaScript 代码分析 +- 场景2: Python 代码分析 +- 场景3: 大文件分析性能 \ No newline at end of file diff --git a/review/active/P01-002/task.md b/review/active/P01-002/task.md new file mode 100644 index 0000000..009bfbd --- /dev/null +++ b/review/active/P01-002/task.md @@ -0,0 +1,27 @@ +# P01-002 - 代码分析API开发 + +## 任务信息 +- 任务编号: P01-002 +- 项目: P01_errlens_app +- 创建时间: 2026-05-22 +- 负责人: Dev AI +- 状态: TODO + +## 任务描述 +实现代码分析API,包括: +1. 代码解析 +2. 错误检测 +3. 修复建议生成 + +## 需求来源 +- 产品需求文档: PRD-002 + +## 技术要求 +- 支持多种编程语言 +- 与AI服务模块集成 +- 返回结构化的错误信息 + +## 交付物 +- `src/api/analyze.js` - 分析API路由 +- `src/controllers/analyzeController.js` - 分析控制器 +- `src/services/analyzeService.js` - 分析服务 \ No newline at end of file diff --git a/review/active/P02-001/acceptance.md b/review/active/P02-001/acceptance.md new file mode 100644 index 0000000..cf823d3 --- /dev/null +++ b/review/active/P02-001/acceptance.md @@ -0,0 +1,19 @@ +# P02-001 - 验收标准 + +## 功能验收 +- [ ] 支持从 GitHub 下载代码仓库 +- [ ] 自动清洗无效代码 +- [ ] 支持人工标注接口 +- [ ] 提取代码特征向量 + +## 非功能验收 +- [ ] 处理速度: 1000 文件/分钟 +- [ ] 内存占用: < 2GB +- [ ] 数据准确率: >= 95% + +## 测试覆盖要求 +- 单元测试覆盖率: >= 80% + +## 验收通过条件 +- 所有功能点验证通过 +- 测试覆盖率达标 \ No newline at end of file diff --git a/review/active/P02-001/impact.md b/review/active/P02-001/impact.md new file mode 100644 index 0000000..deb10d5 --- /dev/null +++ b/review/active/P02-001/impact.md @@ -0,0 +1,18 @@ +# P02-001 - 变更影响范围 + +## 修改的文件 +| 文件路径 | 修改类型 | 影响等级 | +|---------|---------|---------| +| src/data/download.py | 新增 | HIGH | +| src/data/clean.py | 新增 | HIGH | +| src/data/label.py | 新增 | MEDIUM | +| src/data/features.py | 新增 | HIGH | + +## 影响的功能模块 +- [x] 数据处理模块 +- [x] 模型训练模块 + +## 需要回归测试的场景 +- 场景1: 大规模数据下载 +- 场景2: 数据清洗质量 +- 场景3: 特征提取准确性 \ No newline at end of file diff --git a/review/active/P02-001/task.md b/review/active/P02-001/task.md new file mode 100644 index 0000000..bda671f --- /dev/null +++ b/review/active/P02-001/task.md @@ -0,0 +1,29 @@ +# P02-001 - 数据集预处理模块 + +## 任务信息 +- 任务编号: P02-001 +- 项目: P02_errlens_training +- 创建时间: 2026-05-22 +- 负责人: Dev AI +- 状态: TODO + +## 任务描述 +实现数据集预处理模块,包括: +1. 数据下载 +2. 数据清洗 +3. 数据标注 +4. 特征提取 + +## 需求来源 +- 模型训练需求文档 + +## 技术要求 +- 支持多线程处理 +- 数据格式标准化 +- 支持增量更新 + +## 交付物 +- `src/data/download.py` - 数据下载 +- `src/data/clean.py` - 数据清洗 +- `src/data/label.py` - 数据标注 +- `src/data/features.py` - 特征提取 \ No newline at end of file