Files
ai-proj-helper/skills-req/req-plugin/docs/workflow-example.md
John Qiu 712063071c refactor: 通用技能按类别拆分为独立目录
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>
2026-03-14 11:31:58 +10:30

3.1 KiB
Raw Blame History

完整开发工作流示例

以「酷采3.0 标签管理模块」为例的完整需求生命周期。

第一步:创建需求

/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 文档

第三步:创建开发子任务

# 创建子任务
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=[...])

第四步:提交并审批需求

/req review          # draft → pending
/req review pass     # pending → approved

第五步:执行开发任务

/req dev REQ-2026-0006

按分层架构开发Model → Store → Biz → Handler → Router

第六步:代码评审

/req cr REQ-2026-0006

开发完成后必须进行代码评审,评审通过后才能进入测试。

第七步:创建测试任务

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用户验收测试")

第八步:执行测试

/req test REQ-2026-0006

按环境顺序:本机 → 预发布 → 生产

第九步CI/CD 发布

/req deploy REQ-2026-0006 --env staging

第十步:完成归档

/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 生命周期总结 归档