# Requirements - dev-workflow + pr-review-gate

## v1 Requirements

### dev-workflow 技能

- [ ] **DEV-01**: 用户描述需求后，生成 spec.md 文件
- [ ] **DEV-02**: 从 spec 创建 `feature/*` 功能分支
- [ ] **DEV-03**: 调用子代理进行开发（基于 GSD 子代理编排）
- [ ] **DEV-04**: 开发完成后自动提交到功能分支
- [ ] **DEV-05**: 调用 Gitea API 创建 PR
- [ ] **DEV-06**: 触发 CI 测试（通过现有 test.yml）

### pr-review-gate 技能

- [ ] **PRG-01**: PR 创建后自动启动 3 个审查子代理
- [ ] **PRG-02**: 审查者1 - Security Reviewer（安全审查）
- [ ] **PRG-03**: 审查者2 - Quality Reviewer（代码质量审查）
- [ ] **PRG-04**: 审查者3 - Logic Reviewer（业务逻辑审查）
- [ ] **PRG-05**: 收集 3 个审查结果
- [ ] **PRG-06**: 全部 approve + CI 通过 → 调用 Gitea API 合并
- [ ] **PRG-07**: 有 reject → 修复 → 重新审查（最多 3 次）
- [ ] **PRG-08**: 3 次修复后仍有问题 → 汇报失败，等待人工介入

### 集成要求

- [ ] **INT-01**: 技能安装到 `kb-skills/dev-workflow/` 和 `kb-skills/pr-review-gate/`
- [ ] **INT-02**: 每个技能包含 `SKILL.md` 和 Python 辅助脚本
- [ ] **INT-03**: 修改 `.gitea/workflows/` 支持自动合并逻辑

## v2 Requirements (Future)

- 支持自定义审查者数量
- 支持不同类型的审查模板
- 支持 GitHub 兼容模式

## Out of Scope

- GitHub 原生支持（仅 Gitea）
- 图形化界面
- 实时协作审查

## Traceability

| Phase | Requirements |
|-------|--------------|
| Phase 1: dev-workflow 核心 | DEV-01, DEV-02, DEV-03, DEV-04 |
| Phase 2: Gitea PR 集成 | DEV-05, DEV-06 |
| Phase 3: pr-review-gate 核心 | PRG-01 ~ PRG-05 |
| Phase 4: 自动合并逻辑 | PRG-06, PRG-07, PRG-08, INT-03 |
| Phase 5: 集成测试 | INT-01, INT-02 |