jira-task

使用するタイミング

以下の Jira タスクを作成するときに、このスキルを使用します。

• バグ報告
• 機能リクエスト
• リファクタリングタスク
• ドキュメントタスク

複数コンポーネントにまたがる作業：複数のタスクに分割する

重要： 作業で複数のコンポーネント（API、UI、SDK）の変更が必要な場合は、1 つの大きなタスクにまとめず、コンポーネントごとに個別のタスクを作成します。

分割する理由

• 異なる開発者が並行して作業できます
• レビューとテストが容易になります
• 進捗をより適切に追跡できます
• UI の前に API を完了する必要があります（依存関係）

バグと機能：異なる構成

バグの場合：個別の兄弟タスクを作成する

バグは通常、緊急の修正を要するため、コンポーネントごとに独立したタスクを作成します。

タスク 1 - API：

• タイトル：[BUG] Add aws_region field to AWS provider secrets (API)
• 最初に完了する必要があります（UI が依存します）

タスク 2 - UI：

• タイトル：[BUG] Add region selector to AWS provider connection form (UI)
• API タスクがブロッカーです

機能の場合：親タスクと子タスクを作成する

機能には関係者向けのビジネスコンテキストが必要なため、親子構成を使用します。

親タスク（PM／関係者向け）：

• タイトル：[FEATURE] AWS GovCloud support
• 含める内容：機能の概要、ユーザーストーリー、ユーザー視点の受け入れ条件
• 技術的な詳細は含めません
• 子タスクへのリンク

子タスク 1 - API：

• タイトル：[FEATURE] AWS GovCloud support (API)
• 含める内容：技術的な詳細、影響を受けるファイル、API 固有の受け入れ条件
• 親タスクへのリンク

子タスク 2 - UI：

• タイトル：[FEATURE] AWS GovCloud support (UI)
• 含める内容：技術的な詳細、コンポーネントのパス、UI 固有の受け入れ条件
• 親タスクへのリンク、API タスクがブロッカー

親タスクのテンプレート（機能のみ）

## Description

{User-facing description of the feature - what problem does it solve?}

## User Story

As a {user type}, I want to {action} so that {benefit}.

## Acceptance Criteria (User Perspective)

- [ ] User can {do something}
- [ ] User sees {something}
- [ ] {Behavior from user's point of view}

## Out of Scope

- {What this feature does NOT include}

## Design

- Figma: {link if available}
- Screenshots/mockups if available

## Child Tasks

- [ ] `[FEATURE] {Feature name} (API)` - Backend implementation
- [ ] `[FEATURE] {Feature name} (UI)` - Frontend implementation

## Priority

{High/Medium/Low} ({business justification})

子タスクのテンプレート（機能のみ）

## Description

Technical implementation of {feature name} for {component}.

## Parent Task

`[FEATURE] {Feature name}`

## Acceptance Criteria (Technical)

- [ ] {Technical requirement 1}
- [ ] {Technical requirement 2}

## Technical Notes

- Affected files:
  - `{file path 1}`
  - `{file path 2}`
- {Implementation hints}

## Testing

- [ ] {Test case 1}
- [ ] {Test case 2}

## Related Tasks

- Parent: `[FEATURE] {Feature name}`
- Blocked by: {if any}
- Blocks: {if any}

タスクのリンク

各タスクの説明に、以下を追加します。

## Related Tasks
- Parent: [Parent task title/link] (for child tasks)
- Blocked by: [API task title/link]
- Blocks: [UI task title/link]

タスクのテンプレート

## Description

{Brief explanation of the problem or feature request}

**Current State:**
- {What's happening now / What's broken}
- {Impact on users}

**Expected State:**
- {What should happen}
- {Desired behavior}

## Acceptance Criteria

- [ ] {Specific, testable requirement}
- [ ] {Another requirement}
- [ ] {Include both API and UI tasks if applicable}

## Technical Notes

- {Implementation hints}
- {Affected files with full paths}
- {Dependencies or related components}

## Testing

- [ ] {Test case 1}
- [ ] {Test case 2}
- [ ] {Include regression tests}

## Priority

{High/Medium/Low} ({justification})

タイトルの規則

形式：[TYPE] Brief description (components)

種類：

• [BUG] - 以前は動作していたものが壊れている
• [FEATURE] - 新機能
• [ENHANCEMENT] - 既存機能の改善
• [REFACTOR] - 動作を変更せずにコードを再構成する
• [DOCS] - ドキュメントのみ
• [CHORE] - メンテナンス、依存関係、CI/CD

コンポーネント（複数に影響する場合）：

• (API) - バックエンドのみ
• (UI) - フロントエンドのみ
• (SDK) - Prowler SDK のみ
• (API + UI) - バックエンドとフロントエンドの両方
• (SDK + API) - SDK とバックエンド
• (Full Stack) - すべてのコンポーネント

例：

• [BUG] AWS GovCloud accounts cannot connect - STS region hardcoded (API + UI)
• [FEATURE] Add dark mode toggle (UI)
• [REFACTOR] Migrate E2E tests to Page Object Model (UI)
• [ENHANCEMENT] Improve scan performance for large accounts (SDK)

優先度のガイドライン

優先度	基準
Critical	本番環境の停止、データ損失、セキュリティの脆弱性
High	ユーザーの作業を妨げる、回避策がない、有料機能に影響する
Medium	回避策がある、一部のユーザーに影響する
Low	あれば便利、外観上の問題、社内ツール

影響を受けるファイルのセクション

判明している場合は、必ずフルパスを記載します。

## Technical Notes

- Affected files:
  - `api/src/backend/api/v1/serializers.py`
  - `ui/components/providers/workflow/forms/aws-credentials-form.tsx`
  - `prowler/providers/aws/config.py`

コンポーネント固有のセクション

API タスク

以下を含めます。

• シリアライザーの変更
• View／ViewSet の変更
• マイグレーションの要件
• API 仕様の再生成の必要性

UI タスク

以下を含めます。

• コンポーネントのパス
• フォームのバリデーションの変更
• 状態管理への影響
• レスポンシブデザインに関する考慮事項

SDK タスク

以下を含めます。

• 影響を受けるプロバイダー
• 影響を受けるサービス
• チェックの変更
• 設定の変更

提出前のチェックリスト

1. ✅ タイトルが [TYPE] description (components) の形式に従っている
2. ✅ 説明に現在の状態／期待される状態が記載されている
3. ✅ 受け入れ条件が具体的で、テスト可能である
4. ✅ 技術的なメモにファイルパスが含まれている
5. ✅ テストセクションで正常系とエッジケースをカバーしている
6. ✅ 優先度の根拠が記載されている
7. ✅ 複数コンポーネントにまたがる作業が個別のタスクに分割されている
8. ✅ すべてのタスクにタイトルを付けることを推奨します

出力形式

バグの場合（兄弟タスク）：

## Recommended Tasks

### Task 1: [BUG] {Description} (API)
{Full task content}

---

### Task 2: [BUG] {Description} (UI)
{Full task content}

機能の場合（親タスクと子タスク）：

## Recommended Tasks

### Parent Task: [FEATURE] {Feature name}
{User-facing content, no technical details}

---

### Child Task 1: [FEATURE] {Feature name} (API)
{Technical content for API team}

---

### Child Task 2: [FEATURE] {Feature name} (UI)
{Technical content for UI team}

書式ルール

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

• メインセクション（Description、Acceptance Criteria など）には ## を使用します
• 強調には **太字** を使用します
• チェックボックスには - [ ] を使用します
• 言語ヒント付きのコードブロックには ``` を使用します
• ファイルパス、コマンド、コード参照には バッククォート を使用します
• 必要に応じて表を使用します
• 複数のタスクを区切るには --- を使用します

Jira MCP 統合

重要： MCP 経由でタスクを作成するときは、次のパラメーターを正確に使用してください。

必須フィールド

{
  "project_key": "PROWLER",
  "summary": "[TYPE] Task title (component)",
  "issue_type": "Task",
  "additional_fields": {
    "parent": "PROWLER-XXX",
    "customfield_10359": {"value": "UI"}
  }
}

チームフィールド（必須）

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

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

作業項目の説明フィールド

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

重要： Markdown ではなく、Jira Wiki マークアップを使用してください。

• ## の代わりに h2.
• **太字** の代わりに *テキスト*
• 箇条書きには * 項目（同じ形式）
• 入れ子の箇条書きには ** サブ項目

課題の作成後、説明を次の内容で更新します。

{
  "customfield_10363": "h2. Description\n\n{content}\n\n*Current State:*\n* {problem 1}\n* {problem 2}\n\n*Expected State:*\n* {solution 1}\n* {solution 2}\n\nh2. Acceptance Criteria\n\n* {criteria 1}\n* {criteria 2}\n\nh2. Technical Notes\n\nPR: [{pr_url}]\n\nAffected files:\n* {file 1}\n* {file 2}\n\nh2. Testing\n\n* [ ] PR - Local environment\n** {test case 1}\n** {test case 2}\n* [ ] After merge in prowler - dev\n** {test case 3}"
}

よく使われるエピック

エピック	キー	用途
UI - バグと改善	PROWLER-193	UI のバグ、機能強化
API - バグ／改善	PROWLER-XXX	API のバグ、機能強化
LightHouse AI	PROWLER-594	AI 機能
技術的負債 - UI	PROWLER-502	リファクタリング

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

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

MCP コマンドの実行順序

1. 課題を作成：

mcp__mcp-atlassian__jira_create_issue

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

mcp__mcp-atlassian__jira_update_issue with customfield_10363

3. 担当者を設定してトランジション：

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

キーワード

jira, task, ticket, issue, bug, feature, prowler