Create Epics

---
name: create-epics
description: "创建Epic，将SRS与ADR转化为分层Epic（foundation/core/feature）。"
license: MIT
metadata:
  model: sonnet
  argument-hint: "layer:[foundation/core/feature]"
  user-invocable: true
  allowed-tools:
    - Read
    - Glob
    - Grep
    - Write
    - AskUserQuestion
  platforms:
    claude-code: {enabled: true}
    cursor: {enabled: true}
    codex: {enabled: true}
    windsurf: {enabled: true, trigger: /create-epics}
    trae: {enabled: true}
    hermes: {enabled: true, platforms: [macos, linux, windows]}
    workbuddy: {enabled: true}
---

# create-epics — Epic 创建

## 技能目的

将 SRS 需求与 ADR 决策转化为分层 Epic，按 foundation（基础设施层）、core（核心层）、feature（功能层）三个层级组织，确保开发顺序合理且依赖关系清晰。

## 参数说明

- `layer:[foundation/core/feature]`：目标层级，可选基础层、核心层或功能层。

## 分阶段工作流

### 阶段 1：加载上下文

- **输入**：layer 参数
- **处理**：
  1. 使用 Read 读取 `docs/systems-index.md` 获取模块清单
  2. 使用 Glob 扫描 `docs/srs/*.md` 读取所有 SRS
  3. 使用 Glob 扫描 `docs/adr/*.md` 读取所有 Accepted ADR
  4. 使用 Read 读取 `docs/architecture-doc.md` 获取分层架构
  5. 使用 Glob 检查已存在的 Epic 文件
- **输出**：需求与架构上下文

### 阶段 2：识别该层 Epic 候选

- **输入**：上下文 + layer 参数
- **处理**：
  1. 根据 layer 过滤对应的 SRS 需求与 ADR 决策
  2. foundation 层：基础设施、数据库、认证、配置等
  3. core 层：核心业务逻辑、领域服务
  4. feature 层：用户可见功能、界面交互
  5. 为每个候选 Epic 定义范围与目标
- **输出**：Epic 候选清单

### 阶段 3：定义 Epic 详情

- **输入**：Epic 候选清单
- **处理**：
  1. 为每个 Epic 编写描述、业务价值、验收标准
  2. 定义 Epic 间的依赖关系
  3. 标注 Epic 关联的 SRS 编号与 ADR 编号
  4. 通过 AskUserQuestion 与用户确认 Epic 优先级
- **输出**：Epic 详情文档

### 阶段 4：写入文件

- **输入**：Epic 详情
- **处理**：
  1. 向用户展示 Epic 草稿
  2. 批准后使用 Write 写入 `docs/epics/{layer}/{epic-slug}.md`
  3. 更新 `docs/epics/index.md` 索引
- **输出**：Epic 文件 + 索引

## 协作协议引用

- 遵循 `.claude/docs/templates/collaborative-protocols/design-agent-protocol.md` Epic 编写规范
- Epic 必须关联 SRS 需求编号与 ADR 编号
- 写入前需用户批准

## 推荐下一步

对每个 Epic 使用 `/create-stories` 分解为用户故事。使用 `/estimate` 估算工作量。使用 `/sprint-plan` 将 Epic 纳入 Sprint 规划。