jira-task-manager

name	jira-task-manager
description	Create and manage Jira tasks for the AI project, assign tasks to correct team members, assign to sprints, and link to appropriate Epics. Use when user wants to create, update, or manage Jira tickets.

Jira Workflow — Tạo task và quản lý trên Jira

CLI entrypoint: ./.agent/skills/jira-task-manager/helpers/jira-mcp

Ví dụ: ./.agent/skills/jira-task-manager/helpers/jira-mcp jira-search --jql "project = AI" --limit 5 --output json

🔍 Auto-Context Detection (LUÔN chạy đầu tiên với READ/FETCH queries)

Khi user yêu cầu lấy/tìm/list Jira tasks mà KHÔNG nêu rõ project key:

Bước 0: Tự động detect project context — KHÔNG hỏi user

1. Gọi jira_search với JQL: issue in issueHistory() ORDER BY lastViewed DESC và maxResults=5
2. Từ kết quả, đếm project key xuất hiện nhiều nhất → đó là active project
3. Proceed ngay với project đó — KHÔNG hỏi "bạn muốn project nào?"
4. Fallback: Nếu issueHistory() rỗng hoặc lỗi → default về project AI

Thông tin context mặc định của team:

• Default project: AI (project key cố định của team này)
• Default board ID: 168 (board của project AI — confirm lại bằng query nếu cần)
• Default sprint: sprint đang active (query để lấy ID thực tế)

Ví dụ áp dụng:

User nói	AI làm
"Lấy tasks chưa có description"	→ detect project từ history → query ngay với JQL
"Tasks nào đang In Progress?"	→ detect project → filter status = "In Progress"
"Tasks được assign cho tôi"	→ detect project → filter assignee = currentUser()

⚠️ KHÔNG hỏi lại về project, filter, hay format nếu user đã nêu ý định rõ ràng. Chạy query trước, sau đó hỏi nếu kết quả cần clarify thêm.

Khi tạo task mới cho một sprint, bạn cần thực hiện đầy đủ các bước sau:

Bước 1: Tạo Jira issue

• Dùng tool mcp__MCP_DOCKER__jira_create_issue với project_key AI.
• Điền đầy đủ thông tin: summary, description (dùng format Jira markup), priority, labels.
• Quy tắc Assignee:
  • Gán cho Thiện ([e-mail]): Các tasks liên quan đến Langfuse, Logfire, truy cập Log, Tracing, Debug, Input/Output context metadata, hoặc Token.
  • Gán cho Khánh ([e-mail]): Các tasks liên quan đến Knowledge Base, Article, Content, SOP, OmniAgent UI, tính năng giao diện người dùng (edit/xoá).

Bước 2: Gán task vào đúng sprint trên Jira

• Dùng mcp__MCP_DOCKER__jira_get_sprints_from_board để tìm sprint ID hiện hành. Board ID của dự án AI thường là 168 (dùng jira_get_agile_boards nếu cần xác nhận lại).
• Lọc các sprint có state: "active" hoặc state: "future" để chọn đúng sprint (ví dụ: Sprint 17).
• Gán Sprint khi tạo task (thông qua additional_fields với customfield_10107: <Sprint ID>) hoặc cập nhật sau đó bằng jira_update_issue.
• QUAN TRỌNG: Chỉ tạo issue trên Jira mà KHÔNG gán vào sprint là chưa đủ. Phải đảm bảo task đã vào đúng Sprint (active) đang chạy.

Bước 3: Link task vào Epic tương ứng

• Dùng mcp__MCP_DOCKER__jira_search để tìm các Epics đang mở trong dự án: project = AI AND issuetype = Epic AND status != Done AND status != Closed.
• Xác định Epic phù hợp dựa theo chủ đề task. Ví dụ hiện tại:
  • Các tasks về Langfuse, Tracing, Log, Debug -> Gán vào Epic liên quan tới "Debug & Tracing" (ví dụ: AI-439).
  • Các tasks về Knowledge Base, SOP, Content -> Gán vào Epic liên quan tới "Knowledge Deduplication" hoặc "Knowledge Enhancement" (ví dụ: AI-265).
• Sử dụng tool mcp__MCP_DOCKER__jira_update_issue với field customfield_10103: <Epic_Key> để gán vào Epic phù hợp (Không sử dụng jira_link_to_epic vì sẽ không đúng định dạng Epic Link của Jira).

Bước 4: Cập nhật tài liệu Sprint Goal (Nếu cần)

• Thêm task vào file docs/roadmaps/q1-2026/sprint-{N}-goal.md (Tuỳ theo thư mục hiện tại).
• Cập nhật cả ở section "Việc mới" VÀ section "Tasks Details".

Các lưu ý khác

• Luôn hỏi user muốn đưa vào sprint nào nếu có nhiều tuỳ chọn tương lai.
• Khi link issues (block, relate) với nhau dùng jira_create_issue_link — chú ý có thể fail nếu issue target chưa tồn tại.
• Board ID (168) và Sprint ID: luôn luôn nên query để lấy số liệu thực tế tại thời điểm đó thay vì hardcode chết số ID vì nó thay đổi hàng tuần.