John Qiu
712063071c
skills/ → skills-dev(9), skills-req(10), skills-ops(4), skills-integration(8), skills-biz(4), skills-workflow(7) generate-marketplace.py 改为自动扫描所有 skills-* 目录。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
121 lines
3.1 KiB
Markdown
121 lines
3.1 KiB
Markdown
# 完整开发工作流示例
|
||
|
||
以「酷采3.0 标签管理模块」为例的完整需求生命周期。
|
||
|
||
## 第一步：创建需求
|
||
|
||
```bash
|
||
/req new 酷采3.0 商品标签管理模块
|
||
```
|
||
|
||
执行：`mcp__ai-proj__create_requirement` → 自动分配 display_id（如 REQ-2026-0006）
|
||
|
||
## 第二步：编写 PRD 文档
|
||
|
||
调用 `req-prd` 技能：
|
||
1. 创建 PRD 任务并关联到需求
|
||
2. 调用 `mcp__ai-proj__create-and-attach` 写入 PRD 文档
|
||
|
||
## 第三步：创建开发子任务
|
||
|
||
```python
|
||
# 创建子任务
|
||
mcp__ai-proj__create_subtask(parentId=PRD任务ID, title="后端：数据模型设计")
|
||
mcp__ai-proj__create_subtask(parentId=PRD任务ID, title="后端：Store/Biz实现")
|
||
mcp__ai-proj__create_subtask(parentId=PRD任务ID, title="后端：API Handler实现")
|
||
mcp__ai-proj__create_subtask(parentId=PRD任务ID, title="前端：页面开发")
|
||
|
||
# 批量关联到需求
|
||
mcp__ai-proj__link_tasks_to_requirement(requirementId=需求ID, taskIds=[...])
|
||
```
|
||
|
||
## 第四步：提交并审批需求
|
||
|
||
```bash
|
||
/req review # draft → pending
|
||
/req review pass # pending → approved
|
||
```
|
||
|
||
## 第五步：执行开发任务
|
||
|
||
```bash
|
||
/req dev REQ-2026-0006
|
||
```
|
||
|
||
按分层架构开发：Model → Store → Biz → Handler → Router
|
||
|
||
## 第六步：代码评审
|
||
|
||
```bash
|
||
/req cr REQ-2026-0006
|
||
```
|
||
|
||
开发完成后必须进行代码评审，评审通过后才能进入测试。
|
||
|
||
## 第七步：创建测试任务
|
||
|
||
```python
|
||
mcp__ai-proj__create_subtask(parentId=测试父任务, title="后端：单元测试")
|
||
mcp__ai-proj__create_subtask(parentId=测试父任务, title="后端：集成测试")
|
||
mcp__ai-proj__create_subtask(parentId=测试父任务, title="E2E：端到端测试")
|
||
mcp__ai-proj__create_subtask(parentId=测试父任务, title="UAT：用户验收测试")
|
||
```
|
||
|
||
## 第八步：执行测试
|
||
|
||
```bash
|
||
/req test REQ-2026-0006
|
||
```
|
||
|
||
按环境顺序：本机 → 预发布 → 生产
|
||
|
||
## 第九步：CI/CD 发布
|
||
|
||
```bash
|
||
/req deploy REQ-2026-0006 --env staging
|
||
```
|
||
|
||
## 第十步：完成归档
|
||
|
||
```bash
|
||
/req done REQ-2026-0006
|
||
```
|
||
|
||
自动生成需求生命周期总结文档，归档需求。
|
||
|
||
---
|
||
|
||
## 标准任务结构
|
||
|
||
```
|
||
需求: REQ-2026-XXXX
|
||
├── PRD 任务 (父任务，包含 PRD 文档)
|
||
│ ├── 后端：数据模型设计 (implementation)
|
||
│ ├── 后端：业务层实现 (implementation)
|
||
│ ├── 后端：API 实现 (implementation)
|
||
│ └── 前端：页面开发 (implementation)
|
||
│
|
||
├── 代码评审任务 (code_review) ← 必须步骤
|
||
│
|
||
├── 测试任务 (父任务)
|
||
│ ├── 单元测试 (test)
|
||
│ ├── 集成测试 (test)
|
||
│ ├── E2E测试 (test)
|
||
│ └── UAT验收 (test, 包含测试报告)
|
||
│
|
||
└── 发布任务 (父任务，包含发布记录)
|
||
├── Docker 镜像构建 (deploy)
|
||
├── 前端资源构建 (deploy)
|
||
└── 部署到环境 (deploy)
|
||
```
|
||
|
||
## 5 阶段文档
|
||
|
||
| 序号 | 文档 | 阶段 |
|
||
|------|------|------|
|
||
| 01 | PRD | 需求定义 |
|
||
| 02 | 开发设计 | 开发实现 |
|
||
| 03 | 测试报告 | 测试验收 |
|
||
| 04 | 发布记录 | CI/CD部署 |
|
||
| 05 | 生命周期总结 | 归档 |
|