jira-task

适用场景

在以下情况下使用此技能创建 Jira 任务：

• Bug 报告
• 功能请求
• 重构任务
• 文档任务

多组件工作：拆分为多个任务

重要： 当工作需要更改多个组件（API、UI、SDK）时，请为每个组件创建单独的任务，而不是创建一个大型任务。

为什么要拆分？

• 不同开发者可以并行工作
• 更易于审查和测试
• 更好地跟踪进度
• UI 需要在 API 完成后才能开始（依赖关系）

Bug 与功能：使用不同的结构

对于 Bug：创建并列任务

Bug 通常需要紧急修复，因此应为每个组件创建独立任务：

任务 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] 简要描述（组件）

类型：

• [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)

优先级指南

优先级	标准
严重	生产环境宕机、数据丢失、安全漏洞
高	阻碍用户使用、没有变通方案、影响付费功能
中	有变通方案、影响部分用户
低	有则更好、外观问题、内部工具

受影响文件部分

已知时始终填写完整路径：

## 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 任务

包括：

• Serializer 更改
• View/ViewSet 更改
• 迁移要求
• 是否需要重新生成 API 规范

UI 任务

包括：

• 组件路径
• 表单验证更改
• 对状态管理的影响
• 响应式设计注意事项

SDK 任务

包括：

• 受影响的提供商
• 受影响的服务
• 检查项更改
• 配置更改

提交前检查清单

1. ✅ 标题遵循 [TYPE] description (components) 格式
2. ✅ 描述包含当前状态/预期状态
3. ✅ 验收标准具体且可测试
4. ✅ 技术说明包含文件路径
5. ✅ 测试部分涵盖正常流程和边缘情况
6. ✅ 说明优先级的理由
7. ✅ 多组件工作已拆分为单独任务
8. ✅ 建议为所有任务提供标题

输出格式

对于 Bug（并列任务）：

## 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}

格式规则

重要： 所有输出都必须采用 Markdown 格式，以便直接粘贴到 Jira。

• 主章节使用 ##（描述、验收标准等）
• 使用 **粗体** 强调内容
• 使用 - [ ] 创建复选框
• 代码块使用带语言提示的 ```
• 文件路径、命令和代码引用使用 反引号
• 适当时使用表格
• 使用 --- 分隔多个任务

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（团队）字段为必填项。可选值：

• "UI" - 前端任务
• "API" - 后端任务
• "SDK" - Prowler SDK 任务

工作项描述字段

重要： 项目使用 customfield_10363（工作项描述）字段，而非标准的 description 字段来在 UI 中显示内容。

重要： 使用 Jira Wiki 标记语言，而非 Markdown：

• 使用 h2. 代替 ##
• 使用 *text* 代替 **text** 表示粗体
• 使用 * item 表示项目符号（相同）
• 使用 ** subitem 表示嵌套项目符号

创建问题后，使用以下内容更新描述：

{
  "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}"
}

常见史诗

史诗	Key	用途
UI - Bug 与改进	PROWLER-193	UI Bug、增强功能
API - Bug / 改进	PROWLER-XXX	API Bug、增强功能
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