pm-breakdown

name	pm-breakdown
description	Phân rã Epic/User Stories thành Tasks cụ thể với estimate, tạo GitHub/GitLab Issues chuẩn. Trigger khi: user nói "breakdown epic", "tạo tasks từ story", "phân rã feature", "tạo github issues", "tạo gitlab issues", "sprint planning", "estimate tasks", hoặc gõ /pm-breakdown.

Skill: /pm-breakdown

Role: Project Manager
Mục đích: Phân rã Epic/User Stories thành Tasks cụ thể, tạo GitHub/GitLab Issues với template chuẩn.

---

Hướng dẫn thực hiện

Bước 1 — Đọc input

Nhận vào: Epic description, User Stories, hoặc yêu cầu trực tiếp từ PM.
Đọc docs/tasks/[TASK-ID]/requirements.md nếu có.

Bước 2 — Gate: Clarify trước khi breakdown

Dùng AskUserQuestion tool với các câu hỏi sau:

• Platform: Bạn dùng platform nào để tạo issues?

  • GitHub (gh CLI / MCP) — dùng gh issue create hoặc GitHub MCP tools
  • GitLab (glab CLI) — dùng glab issue create
  • Chỉ generate markdown — không tạo issue tự động

• Capacity: Sprint này có bao nhiêu dev và capacity (人日 hoặc story points)?

• Milestone: Có milestone/deadline cụ thể không? (để gắn vào issue)

• Labels: Team đang dùng label convention nào? (ví dụ: backend, flutter, P0, testing)

Chờ confirm.

Bước 3 — Đề xuất task breakdown (2-3 phương án)

## Tôi có [N] phương án breakdown:

### Phương án A: [Tên] — [Ưu điểm chính]
[Task list với estimate]
- Ưu: [...]
- Nhược: [...]

### Phương án B: [Tên] — [Ưu điểm chính]  
[Task list với estimate]
- Ưu: [...]
- Nhược: [...]

**Đề xuất của tôi**: Phương án [X] vì [lý do].  
Bạn muốn chọn phương án nào, hoặc kết hợp?

Bước 4 — Tạo GitHub Issue format

Sau khi PM confirm, tạo nội dung issue sử dụng template templates/github-issue.md.

Điền vào các trường:

• TASK-ID và tên task từ breakdown
• Type: Feature / Bug / Tech Debt / Refactor
• Priority: High / Medium / Low (đã quyết định ở Bước 3)
• Estimate: từ estimate đã chốt
• Sprint: Sprint N hiện tại
• Acceptance Criteria: từ requirements.md của task
• Technical Notes: những điểm kỹ thuật quan trọng cho dev
• Labels: theo convention team đã chọn ở Bước 2

Bước 5 — Gate cuối trước khi tạo

Dùng AskUserQuestion tool:

• Review list: Liệt kê [N] issues đã chuẩn bị — issue nào cần adjust priority hoặc estimate?
• Dependencies: Thứ tự tạo issue có phụ thuộc vào nhau không?
• Confirm tạo: Tạo tất cả, hay chọn từng issue?

Chờ confirm.

---

Bước 6 — Tạo issues trên platform

Nếu chọn GitLab (glab CLI)

Kiểm tra glab đã auth chưa:

glab auth status

Tạo từng issue theo template (chạy tuần tự, không batch):

glab issue create \
  --title "[TASK-ID] Tên task" \
  --description "$(cat <<'EOF'
## Mô tả
[Mô tả task]

## Liên kết
- Spec: docs/tasks/[TASK-ID]/requirements.md

## Acceptance Criteria
- [ ] AC-001: ...
- [ ] AC-002: ...

## Definition of Done
- [ ] Code complete + unit tests pass
- [ ] Code review approved
- [ ] Demo cho BA/PM
EOF
)" \
  --label "P0,backend,flutter" \
  --assignee "username" \
  --milestone "Sprint N"

Sau mỗi issue tạo thành công, in ra URL issue để confirm:

✅ Issue tạo thành công: https://gitlab.com/[org]/[repo]/-/issues/[number]

Nếu glab chưa có hoặc chưa auth, hướng dẫn:

# Cài glab
brew install glab          # macOS
# hoặc: https://gitlab.com/gitlab-org/cli#installation

# Auth
glab auth login

Nếu chọn GitHub (gh CLI hoặc MCP)

Dùng gh issue create:

gh issue create \
  --title "[TASK-ID] Tên task" \
  --body "$(cat issue-body.md)" \
  --label "P0,backend" \
  --assignee "username" \
  --milestone "Sprint N"

Hoặc dùng GitHub MCP tool mcp__github__issue_write nếu có sẵn trong session.

Nếu chọn chỉ generate markdown

Output file docs/tasks/sprint-[N]-issues.md chứa toàn bộ nội dung issues, sẵn sàng paste thủ công.

---

Lưu ý

• Mỗi issue phải self-contained: dev đọc xong hiểu ngay mà không cần hỏi thêm.
• Link đến docs luôn dùng relative path trong repo.
• Task ID format: [PROJECT-XXX] — customize theo convention của team.
• glab cần được auth với token có quyền api scope trên GitLab project.
• Với GitLab self-hosted: set GITLAB_HOST hoặc dùng glab auth login --hostname gitlab.your-company.com.