jira-epic

使用する場面

以下のような Jira エピックを作成するときに、このスキルを使用します。

• 複数のコンポーネントにまたがる大規模な機能
• アプリケーションの新しいビュー／ページ
• 大規模なリファクタリングの取り組み
• API、UI、SDK の作業が必要な機能

エピックのテンプレート

# {Epic Title}

**Figma:** {figma link if available}

## Feature Overview

{2-3 paragraph description of what this feature does and why it's needed}

## Requirements

### {Section 1: Major Functionality Area}

#### {Subsection}
- Requirement 1
- Requirement 2
- Requirement 3

#### {Another Subsection}
- Requirement 1
- Requirement 2

### {Section 2: Another Major Area}

#### {Subsection}
- Requirement 1
- Requirement 2

## Technical Considerations

### Performance
- {Performance requirement 1}
- {Performance requirement 2}

### Data Integration
- {Data source}
- {Integration points}

### UI Components
- {Component 1}
- {Component 2}

## Implementation Checklist

- [ ] {Major deliverable 1}
- [ ] {Major deliverable 2}
- [ ] {Major deliverable 3}

## Diagrams

{Mermaid diagrams for architecture, flow, data model, etc.}

エピックのタイトル規則

形式：[EPIC] 機能名

例：

• [EPIC] Findings View
• [EPIC] Multi-tenant Support
• [EPIC] Compliance Dashboard Redesign
• [EPIC] GovCloud Support

必須セクション

1. 機能の概要

以下について、簡潔かつ十分に説明します。

• 機能の内容
• 使用するユーザー
• 必要とされる理由

2. 要件

機能領域ごとに整理します。

• 関連する要件をまとめる
• 明確な見出しと小見出しを使用する
• 具体的でテスト可能な内容にする

3. 技術的な考慮事項

必ず以下を含めます。

• パフォーマンス：大規模データセットの処理、ページネーション、キャッシュ
• データ統合：データソース、API、関連性
• UI コンポーネント：再利用可能なコンポーネント、デザインシステムの使用

4. 実装チェックリスト

個別のタスクになる、成果物の概要を記載します。

• 各チェックボックスは Jira タスクの候補です
• 依存関係に沿った順序にします（UI より先に API）
• テストのマイルストーンを含めます

図

以下には Mermaid を使用します。

アーキテクチャ図

graph TB
    UI[UI Components] --> API[API Endpoints]
    API --> SDK[Prowler SDK]
    SDK --> Cloud[Cloud Providers]

データフロー図

sequenceDiagram
    User->>UI: Apply filters
    UI->>API: GET /findings?filters
    API->>DB: Query findings
    DB-->>API: Results
    API-->>UI: JSON response
    UI-->>User: Render table

状態図

stateDiagram-v2
    [*] --> Pending
    Pending --> InProgress: Start triage
    InProgress --> Resolved: Mark resolved
    InProgress --> Pending: Reset
    Resolved --> [*]

エンティティ関係図

erDiagram
    FINDING ||--o{ RESOURCE : affects
    FINDING }|--|| CHECK : "belongs to"
    RESOURCE }|--|| ACCOUNT : "belongs to"
    ACCOUNT }|--|| PROVIDER : "belongs to"

エピックをタスクに分割する

エピックを作成した後、jira-task スキルを使用して個別のタスクを作成します。

タスクの命名パターン

エピック [EPIC] Findings View から、次のタスクを作成します。

• [FEATURE] Findings table with pagination (UI)
• [FEATURE] Findings filters - provider and account (UI)
• [FEATURE] Findings detail panel - Overview tab (UI)
• [FEATURE] Findings detail panel - Resources tab (UI)
• [FEATURE] Findings bulk actions - mute/suppress (API + UI)
• [FEATURE] Findings search functionality (API + UI)

タスクの依存関係

各タスクで必ず以下を指定します。

## Related Tasks
- Epic: [EPIC] Findings View
- Blocked by: [task if any]
- Blocks: [task if any]

Figma との連携

Figma のリンクが提供されている場合：

• メインの Figma リンクを冒頭に記載します
• 関連するセクションで該当するフレームを参照します
• 例：https://www.figma.com/design/xxx?node-id=1830-44712&m=dev

出力形式

## Epic: [EPIC] {Title}

{Full epic content following template}

---

## Suggested Tasks

Based on this epic, create the following tasks:

| # | Title | Component | Blocked By |
|---|-------|-----------|------------|
| 1 | [FEATURE] Task name | API | - |
| 2 | [FEATURE] Task name | UI | Task 1 |
| 3 | [FEATURE] Task name | UI | Task 2 |

Would you like me to generate the full task descriptions?

提出前のチェックリスト

1. ✅ タイトルが [EPIC] 機能名 の形式になっている
2. ✅ 機能の概要で内容、対象ユーザー、理由を説明している
3. ✅ 要件が機能領域ごとに整理されている
4. ✅ 技術的な考慮事項でパフォーマンス、データ、UI を網羅している
5. ✅ 実装チェックリストに成果物の概要が記載されている
6. ✅ 必要に応じて図が含まれている（Mermaid 形式）
7. ✅ 利用可能な場合、Figma のリンクが含まれている
8. ✅ 最後に提案タスクの表が記載されている

書式規則

重要： 出力はすべて、Jira に貼り付けられる Markdown 形式にする必要があります。

• エピックのタイトルには #、メインセクションには ##、小見出しには ### を使用します
• 強調には **太字** を使用します
• 実装チェックリストのチェックボックスには - [ ] を使用します
• コードブロックと Mermaid 図には ``` を使用します
• ファイルパス、コマンド、コード参照には バッククォート を使用します
• 提案タスクのセクションには表を使用します
• エピックと提案タスクの区切りには --- を使用します

Jira MCP との連携

重要： MCP 経由でエピックを作成するときは、次のパラメーターを正確に使用します。

必須フィールド

{
  "project_key": "PROWLER",
  "summary": "[EPIC] Feature name",
  "issue_type": "Epic",
  "additional_fields": {
    "customfield_10359": {"value": "UI"}
  }
}

Team フィールド（必須）

customfield_10359（Team）フィールドは必須です。選択肢：

• "UI" - フロントエンドのエピック
• "API" - バックエンドのエピック
• "SDK" - Prowler SDK のエピック

Work Item Description フィールド

重要： UI での表示には、標準の description フィールドではなく、customfield_10363（Work Item Description）を使用するプロジェクトです。

重要： Markdown ではなく、Jira Wiki マークアップを使用します。

• ## の代わりに h2.
• **text** の代わりに、太字には *text*
• 箇条書きには * item（同じ）
• ネストした箇条書きには ** subitem

エピックを作成した後、次の内容で説明を更新します。

{
  "customfield_10363": "h2. Feature Overview\n\n{overview}\n\nh2. Requirements\n\n*{Section 1}*\n* {requirement 1}\n* {requirement 2}\n\n*{Section 2}*\n* {requirement 1}\n* {requirement 2}\n\nh2. Technical Considerations\n\n*Performance:*\n* {consideration 1}\n\n*Data Integration:*\n* {consideration 2}\n\nh2. Implementation Checklist\n\n* [ ] {deliverable 1}\n* [ ] {deliverable 2}\n* [ ] {deliverable 3}"
}

タスクをエピックにリンクする

子タスクを作成するときは、エピックのキーを親として使用します。

{
  "additional_fields": {
    "parent": "PROWLER-XXX"
  }
}

ワークフローのトランジション

Backlog (10037) → To Do (14) → In Progress (11) → Done (21)
                → Blocked (10)

MCP コマンドの手順

1. エピックを作成：

mcp__mcp-atlassian__jira_create_issue (issue_type: "Epic")

2. 作業項目の説明を更新：

mcp__mcp-atlassian__jira_update_issue with customfield_10363

3. 子タスクを作成：

mcp__mcp-atlassian__jira_create_issue with parent: EPIC-KEY

4. 割り当ててステータスを変更：

mcp__mcp-atlassian__jira_update_issue (assignee)
mcp__mcp-atlassian__jira_transition_issue (status)

キーワード

jira、エピック、機能、イニシアチブ、prowler、大規模な機能