feat: 添加 dev-workflow 和 pr-review-gate 技能
## dev-workflow - Spec-Driven 开发流程 - 从需求生成 spec.md - 创建功能分支 - 调用子代理开发 - 自动创建 Gitea PR ## pr-review-gate - 3 审查者并行审查(安全/质量/逻辑) - 自动合并逻辑 - 修复循环(最多3次) ## .planning - PROJECT.md: 项目定义 - REQUIREMENTS.md: 需求列表 - ROADMAP.md: 开发路线图 - STATE.md: 当前状态
This commit is contained in:
@@ -0,0 +1,36 @@
|
||||
# dev-workflow + pr-review-gate 技能开发
|
||||
|
||||
## Core Value
|
||||
|
||||
为 kb-skills 仓库提供完整的 Spec-Driven 开发流程,包括:
|
||||
- 功能分支开发
|
||||
- 自动创建 Gitea PR
|
||||
- 3 审查者并行审查
|
||||
- 自动测试 + 自动合并
|
||||
|
||||
## Context
|
||||
|
||||
### 现有基础设施
|
||||
- Gitea Runner 已配置 (`self-hosted`, `ubuntu-latest`)
|
||||
- CI/CD: `.gitea/workflows/deploy.yml` (部署), `.gitea/workflows/test.yml` (PR 测试)
|
||||
- 目标仓库: `ssh://gitea-nas/starmen1265/kb-skills.git`
|
||||
|
||||
### 用户工作流
|
||||
```
|
||||
需求 → Spec → 开发 → PR → 3审查者审查 → 测试 → 合并 → 部署
|
||||
```
|
||||
|
||||
## Constraints
|
||||
|
||||
- 必须与现有 Gitea 环境兼容
|
||||
- 审查者使用子代理实现
|
||||
- 修复循环最多 3 次
|
||||
- 必须集成到 kb-skills 作为新技能
|
||||
|
||||
## Key Decisions
|
||||
|
||||
| Decision | Rationale | Outcome |
|
||||
|----------|-----------|---------|
|
||||
| 使用 GSD Spec-Driven | 成熟的开发方法论 | 已安装 GSD |
|
||||
| 审查者为子代理 | 实现并行审查 | 待开发 |
|
||||
| Gitea API 自动 PR | 无 GitHub CLI | 待开发 |
|
||||
@@ -0,0 +1,51 @@
|
||||
# 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 |
|
||||
@@ -0,0 +1,106 @@
|
||||
# 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. 用户可以按照文档使用
|
||||
@@ -0,0 +1,30 @@
|
||||
# Project State
|
||||
|
||||
## Current Phase
|
||||
|
||||
**Phase 1: dev-workflow 核心**
|
||||
|
||||
Status: `in_progress`
|
||||
|
||||
## Progress
|
||||
|
||||
| Phase | Status | Notes |
|
||||
|-------|--------|-------|
|
||||
| Phase 1: dev-workflow 核心 | 🔄 In Progress | 开始开发 |
|
||||
| Phase 2: Gitea PR 集成 | ⏳ Pending | - |
|
||||
| Phase 3: pr-review-gate 核心 | ⏳ Pending | - |
|
||||
| Phase 4: 自动合并逻辑 | ⏳ Pending | - |
|
||||
| Phase 5: 集成测试 | ⏳ Pending | - |
|
||||
|
||||
## Active Context
|
||||
|
||||
- 开发 dev-workflow 技能
|
||||
- 目标: DEV-01 ~ DEV-04
|
||||
- 产出: SKILL.md + dev_workflow.py + templates/
|
||||
|
||||
## Session Log
|
||||
|
||||
### 2026-03-09 01:18
|
||||
- 安装 GSD
|
||||
- 创建 PROJECT.md, REQUIREMENTS.md, ROADMAP.md
|
||||
- 开始 Phase 1 开发
|
||||
Reference in New Issue
Block a user