John Qiu
99881e268a
- 重命名 plugins/ → skills/，个人插件迁移到 skills-personal/（gitignore） - 更新 generate-marketplace.py 支持 config 读取和 skills-personal 扫描 - 新增 claude-config.yaml（技能启用/禁用 + MCP 配置） - 新增 init.sh（交互式 MCP 初始化，支持 stdio/SSE 模式） - 新增 CLAUDE.md 项目说明 - 重写 README.md 反映新结构 - 删除过时脚本：PUSH.sh、generate-marketplace.sh、convert-skills.sh 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 | 生命周期总结 | 归档 |
|