starmen1265
33c8de02da
## dev-workflow - Spec-Driven 开发流程 - 从需求生成 spec.md - 创建功能分支 - 调用子代理开发 - 自动创建 Gitea PR ## pr-review-gate - 3 审查者并行审查（安全/质量/逻辑） - 自动合并逻辑 - 修复循环（最多3次） ## .planning - PROJECT.md: 项目定义 - REQUIREMENTS.md: 需求列表 - ROADMAP.md: 开发路线图 - STATE.md: 当前状态
107 lines
3.0 KiB
Markdown
107 lines
3.0 KiB
Markdown
# Roadmap - dev-workflow + pr-review-gate
|
||
|
||
## Overview
|
||
|
||
**5 Phases** | **11 Requirements** | All v1 requirements covered ✓
|
||
|
||
| # | Phase | Goal | Requirements | Success Criteria |
|
||
|---|-------|------|--------------|------------------|
|
||
| 1 | dev-workflow 核心 | 实现基础开发流程技能 | DEV-01~04 | 用户可以说"添加XXX功能"，系统生成 spec 并在 feature 分支开发 |
|
||
| 2 | Gitea PR 集成 | 自动创建 PR 和触发测试 | DEV-05~06 | 开发完成后自动创建 PR，CI 测试运行 |
|
||
| 3 | pr-review-gate 核心 | 实现 3 审查者并行审查 | PRG-01~05 | PR 创建后自动启动 3 个审查子代理并收集结果 |
|
||
| 4 | 自动合并逻辑 | 实现审查通过后自动合并 | PRG-06~08, INT-03 | 全部通过自动合并，失败自动修复循环 |
|
||
| 5 | 集成测试 | 完整流程验证 | INT-01~02 | 端到端测试通过，技能可用 |
|
||
|
||
---
|
||
|
||
## Phase 1: dev-workflow 核心
|
||
|
||
**Goal:** 实现基础开发流程技能
|
||
|
||
**Requirements:** DEV-01, DEV-02, DEV-03, DEV-04
|
||
|
||
**Deliverables:**
|
||
- `kb-skills/dev-workflow/SKILL.md`
|
||
- `kb-skills/dev-workflow/dev_workflow.py`
|
||
- `kb-skills/dev-workflow/templates/spec-template.md`
|
||
|
||
**Success Criteria:**
|
||
1. 用户描述需求后，生成 `.planning/spec.md` 文件
|
||
2. 从 spec 创建 `feature/*` 功能分支
|
||
3. 子代理可以基于 spec 进行开发
|
||
4. 开发完成后提交到功能分支
|
||
|
||
---
|
||
|
||
## Phase 2: Gitea PR 集成
|
||
|
||
**Goal:** 自动创建 PR 和触发测试
|
||
|
||
**Requirements:** DEV-05, DEV-06
|
||
|
||
**Deliverables:**
|
||
- `dev_workflow.py` 添加 Gitea API 调用
|
||
- 获取 Gitea API Token 配置
|
||
|
||
**Success Criteria:**
|
||
1. 开发完成后调用 Gitea API 创建 PR
|
||
2. PR 创建后自动触发 CI 测试
|
||
3. 返回 PR 编号和链接
|
||
|
||
---
|
||
|
||
## Phase 3: pr-review-gate 核心
|
||
|
||
**Goal:** 实现 3 审查者并行审查
|
||
|
||
**Requirements:** PRG-01, PRG-02, PRG-03, PRG-04, PRG-05
|
||
|
||
**Deliverables:**
|
||
- `kb-skills/pr-review-gate/SKILL.md`
|
||
- `kb-skills/pr-review-gate/pr_gate.py`
|
||
- `kb-skills/pr-review-gate/reviewers/security.md`
|
||
- `kb-skills/pr-review-gate/reviewers/quality.md`
|
||
- `kb-skills/pr-review-gate/reviewers/logic.md`
|
||
|
||
**Success Criteria:**
|
||
1. PR 创建后自动启动 3 个审查子代理
|
||
2. 每个审查者有明确的审查重点
|
||
3. 收集 3 个审查结果（approve/reject + 评论）
|
||
4. 审查结果可追溯
|
||
|
||
---
|
||
|
||
## Phase 4: 自动合并逻辑
|
||
|
||
**Goal:** 实现审查通过后自动合并
|
||
|
||
**Requirements:** PRG-06, PRG-07, PRG-08, INT-03
|
||
|
||
**Deliverables:**
|
||
- `pr_gate.py` 添加合并逻辑
|
||
- `.gitea/workflows/auto-merge.yml`（可选）
|
||
- 修复循环逻辑
|
||
|
||
**Success Criteria:**
|
||
1. 全部 approve + CI 通过 → 自动合并到 main
|
||
2. 有 reject → 启动修复流程
|
||
3. 修复后重新审查（最多 3 次）
|
||
4. 3 次后仍有问题 → 汇报失败详情
|
||
|
||
---
|
||
|
||
## Phase 5: 集成测试
|
||
|
||
**Goal:** 完整流程验证
|
||
|
||
**Requirements:** INT-01, INT-02
|
||
|
||
**Deliverables:**
|
||
- 端到端测试文档
|
||
- 使用示例
|
||
|
||
**Success Criteria:**
|
||
1. 完整流程可运行：需求 → Spec → 开发 → PR → 审查 → 合并
|
||
2. 技能文档完整（SKILL.md）
|
||
3. 用户可以按照文档使用
|