| name | pm-release |
| description | Tạo Release Notes / リリースノート tự động từ merged PRs và closed issues. Dùng trước mỗi release gửi cho khách JP hoặc stakeholder. Trigger khi: user nói "tạo release notes", "viết リリースノート", "changelog sprint", "release notes cho khách JP", "tổng hợp thay đổi release", hoặc gõ /pm-release.
|
Skill: /pm-release
Role: PM / Bridge Engineer
Mục đích: Tạo Release Notes từ merged PRs + closed issues — đủ để gửi khách JP như một deliverable chính thức.
Hướng dẫn thực hiện
Bước 1 — Gate: Xác định phạm vi release
Dùng AskUserQuestion tool:
- Version/Sprint: Release v[X.Y.Z] / Sprint [N] / Hotfix [date]
- Audience: Team internal / Khách hàng JP / Management / Public
- Format output: HTML (recommend cho JP delivery) / Markdown (Slack/Notion/commit) / Cả hai
Chờ confirm.
Bước 2 — Thu thập dữ liệu
Spawn subagent để đọc:
Agent(
description: "Collect release data from git and task docs",
prompt: "Read the following and return structured JSON:
1. git log --oneline --merges [base-tag]..HEAD — list of merged PRs
2. git tag --sort=-version:refname | head -5 — recent tags
3. List all docs/tasks/*/requirements.md for tasks completed this sprint
4. List docs/tasks/*/verification.md for sign-off status
Return JSON: { mergedPRs: [...], closedTasks: [...], openTasks: [...], tagHistory: [...] }
Read only, no changes.",
model: "haiku"
)
Bước 3 — Phân loại thay đổi
Phân loại tự động từ PR titles + task descriptions:
| Category | Tiếng Việt | 日本語 |
|---|
| New Feature | Tính năng mới | 新機能 |
| Bug Fix | Sửa lỗi | バグ修正 |
| Improvement | Cải tiến | 改善 |
| Performance | Hiệu năng | パフォーマンス改善 |
| Security | Bảo mật | セキュリティ |
| Breaking Change | Thay đổi không tương thích | 互換性のない変更 |
| Maintenance | Bảo trì nội bộ | メンテナンス |
Bước 4 — Tạo Release Notes
Format HTML (option A — cho JP delivery)
Sinh docs/reports/release-[version]-[date].html từ template templates/html-artifact.html:
- Header: Release [version] · [Date JST] · badge "リリース済み"
- Section 新機能 / New Features: cards với icon ✨, mô tả JP + VN
- Section バグ修正 / Bug Fixes: cards với icon 🐛
- Section 改善 / Improvements: cards với icon ⚡
- Section ⚠️ 互換性のない変更 / Breaking Changes: nếu có, highlight đỏ
- Footer: link đến repo, PR list, Contact BE
@media print: A4 đẹp để forward email hoặc attach PDF cho khách JP.
Format Markdown (option B — commit/Slack)
Tạo docs/reports/release-[version]-[date].md dùng template templates/release-notes.md.
Điền vào từ danh sách thay đổi phân loại ở Bước 3:
- Thêm mới (Added): tính năng mới
- Cải tiến (Changed): thay đổi tính năng hiện có
- Deprecated: tính năng sẽ xóa trong release sau + migration path
- Xóa bỏ (Removed): tính năng đã xóa
- Sửa lỗi (Fixed): bug fixes với issue references
- Bảo mật (Security): security patches (CVE nếu có)
- Breaking Changes: kèm hướng dẫn migration
- Merged PRs / Closed Issues: bảng đầy đủ từ git log
Bước 5 — Gate cuối
## Release Notes v[X.Y.Z] đã soạn xong.
| # | Câu hỏi | Lựa chọn |
|---|---------|---------|
| 1 | Có thay đổi nào tôi bỏ sót không? | A: Không / B: Có — thêm: ___ / C: Khác: ___ |
| 2 | Breaking Changes có được mô tả đủ rõ chưa? | A: Đủ rõ / B: Cần thêm migration guide / C: Không có breaking changes / D: Khác: ___ |
| 3 | Gửi cho ai? | A: Khách JP (qua BE) / B: Team internal Slack / C: Cả hai / D: Khác: ___ |
Bước tiếp theo nếu gửi JP:
- BE review lại phần 日本語 trước khi gửi
- Gửi kèm regression test results (từ /qa-regression)
Quy tắc
- Breaking changes: LUÔN có migration guide — không chỉ ghi "có breaking change"
- Phần JP trong release notes: dùng thuật ngữ từ
templates/jp-vn-en-glossary.md
- CRs đã implement: list rõ ràng với CR number và ngày JP approved
- File HTML: lưu vào
docs/reports/ (có thể commit để lưu lịch sử release)
