executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
prd-templateSoạn tài liệu yêu cầu sản phẩm (PRD) theo cấu trúc mẫu đã được kiểm chứng trong nghề PM. Dùng khi được yêu cầu viết PRD, product spec, đặc tả tính năng hoặc tài liệu yêu cầu cho một tính năng hay sản phẩm mới. Tạo ra một PRD hoàn chỉnh gồm phát biểu vấn đề, user story, yêu cầu chức năng, các cân nhắc kỹ thuật và chỉ số thành công.
Independent GitHub snapshot · Automated classification · Original documentation governs
Bản dịch tiếng Việt của prd-template. Bản tiếng Anh là bản chuẩn.
Kỹ năng này giúp soạn tài liệu yêu cầu sản phẩm (PRD) chuyên nghiệp theo các thực hành tốt nhất của ngành.
Đứng thứ hai trong chuỗi ra quyết định sản phẩm: /assumption-mapper → prd-template →
/rice-prioritisation → /roadmap-narrative. Kỹ năng này nhận giả định rủi ro nhất
từ /assumption-mapper (nếu bước đó đã chạy, hãy đọc bản đồ của nó thay vì đoán lại các rủi ro)
và chuyển cho /rice-prioritisation chỉ số thành công của PRD: con số duy nhất đã có baseline,
sẽ trở thành Impact trong RICE. Các thuật ngữ dùng chung (phát biểu vấn đề, giả thuyết, chỉ số
thành công, nguồn gốc) được định nghĩa một lần tại
docs/craft/product-decisions.md; hãy dùng
đúng như vậy.
PRD được viết từ ngoài vào trong (luôn là vấn đề trước, giải pháp sau) qua bốn giai đoạn. Giai đoạn 1 là nền móng: một PRD dựng trên một vấn đề mơ hồ thì dù trau chuốt đến đâu vẫn sai từ gốc.
/assumption-mapper phía trước vào đây dưới dạng Câu hỏi bỏ ngỏ, không đặt cược ngầm.
Hoàn thành khi: chỉ số có baseline (hoặc được đánh dấu rõ là chưa có baseline),
và nó đo lường vấn đề chứ không đo hoạt động./rice-prioritisation có thể chấm Impact từ chính chỉ số này, không phải một chỉ số tự nghĩ lại.
Hoàn thành khi: PRD nêu tên chỉ số và phạm vi mà /rice-prioritisation cần
để chấm điểm mà không phải hỏi lại.Hỏi người dùng những thông tin sau nếu chưa được cung cấp:
Nếu có professional-brain (brain/), hãy dùng nó thay vì hỏi lại bối cảnh bạn đã có:
context.md (sản phẩm, định nghĩa chỉ số, giọng văn), knowledge/strategy.md
(sản phẩm đang hướng tới đâu), mọi hypotheses/ liên quan và file tính năng tương ứng trong entities/.
Chạy python3 ../professional-brain/scripts/brain_query.py ./brain "<feature>" để lấy
các dữ kiện có căn cứ, và giữ nguyên nhãn nguồn gốc của chúng khi đưa vào PRD (đừng trình bày một [hunch] như một
yêu cầu đã được chốt).entities/<feature>.md, ghi mọi quyết định về phạm vi vào
decisions/, và thêm các giả định mới vào hypotheses/. Gắn nhãn nguồn gốc cho từng mục.Kỹ năng này đi kèm hai file hỗ trợ, hãy dùng chúng khi có sẵn:
templates/prd-skeleton.md: khung PRD để điền, mỗi phần có gợi ý "thế nào là tốt". Bắt đầu từ file này khi người dùng muốn một tài liệu để tự hoàn thiện thay vì một bản nháp được tạo sẵn.references/success-metrics-guide.md: hướng dẫn hiệu chỉnh cho phần Chỉ số thành công: bài kiểm tra chỉ số bốn phần, bộ chỉ số chuẩn adoption/outcome/business/guardrail, và các bẫy thường gặp. Tham khảo bất cứ khi nào viết hoặc review bảng chỉ số.Mọi PRD nên có các phần sau theo đúng thứ tự:
Định dạng: "Là một [user type], tôi muốn [action] để [benefit]"
Yêu cầu chức năng:
Yêu cầu phi chức năng:
Giọng văn: Rõ ràng, súc tích, có thể hành động được Đối tượng đọc: Kỹ sư, designer, các bên liên quan Độ dài: Khoảng 3-6 trang cho tính năng, 8-12 trang cho sản phẩm
Thực hành tốt nhất:
✅ Nên:
❌ Không nên:
Chấm điểm mọi đầu ra của kỹ năng này trước khi bàn giao; từ 32 điểm trở lên là đạt chất lượng để gửi đi.
| Tiêu chí | 0 | 5 | 10 |
|---|---|---|---|
| Cơ sở của vấn đề | Vấn đề được nêu từ góc nhìn của công ty, hoặc khẳng định mà không có bằng chứng | Vấn đề được đặt theo góc nhìn người dùng, nhưng dữ liệu hỗ trợ mơ hồ ("người dùng thấy bực bội") và không dẫn nguồn nghiên cứu | Vấn đề là của người dùng, được định lượng bằng dữ liệu hiện trạng, và phần Tại sao là bây giờ giải thích điều gì đã thay đổi; các nhận định truy về được nghiên cứu có dẫn nguồn |
| Khả năng kiểm thử của yêu cầu | Yêu cầu là những phẩm chất mơ hồ ("nhanh", "trực quan") mà người review không thể kiểm chứng | Phần lớn yêu cầu cụ thể, nhưng tiêu chí chấp nhận sơ sài và yêu cầu phi chức năng chỉ là văn mẫu | Mọi mục P0/P1/P2 và NFR đều kiểm chứng được (ngưỡng, percentile, tiêu chuẩn), và mỗi mục truy về một user story hoặc phát hiện nghiên cứu |
| Độ chặt chẽ của chỉ số | Thiếu chỉ số thành công, hoặc chỉ có phần trăm mà không có baseline | Có baseline và mục tiêu, nhưng chỉ số chỉ đo adoption: không có gì phát hiện được trường hợp tính năng thành công trong khi doanh nghiệp chịu thiệt | Mọi chỉ số có baseline → mục tiêu, bộ chỉ số bao phủ cả outcome lẫn adoption, và có ít nhất một guardrail ngăn việc thắng ở chỉ số nhưng gây hại cho người dùng |
| Trung thực về phạm vi và rủi ro | MVP và các giai đoạn sau lẫn lộn; không liệt kê câu hỏi bỏ ngỏ | Các giai đoạn được tách bạch, nhưng thiếu lý do cho các đường cắt phạm vi và các bất đồng bị làm mờ đi | Mỗi ranh giới giai đoạn có lý do được nêu rõ, các yêu cầu ngoài phạm vi được ghi lại kèm điều kiện đưa trở lại, và câu hỏi bỏ ngỏ có người phụ trách, hạn chót và cái giá của từng câu trả lời |
# PRD: Dashboard hỗ trợ khách hàng đa kênh
## Tổng quan
**Phát biểu vấn đề**: Các team hỗ trợ hiện đang xử lý yêu cầu của khách hàng qua email, chat và mạng xã hội bằng ba công cụ riêng biệt, dẫn đến phản hồi chậm, công việc bị trùng lặp và trải nghiệm khách hàng không nhất quán. Trung bình, mỗi nhân viên hỗ trợ lãng phí 2.3 giờ mỗi ngày để chuyển qua lại giữa các công cụ và tự theo dõi lịch sử hội thoại.
**Giải pháp đề xuất**: Xây dựng một dashboard hợp nhất, gom yêu cầu của khách hàng từ mọi kênh vào một giao diện duy nhất, lưu giữ lịch sử hội thoại xuyên kênh và định tuyến thông minh dựa trên chuyên môn và mức độ sẵn sàng của nhân viên.
**Chỉ số thành công**:
- Giảm thời gian phản hồi trung bình từ 4 giờ xuống 1 giờ
- Giảm 80% thời gian chuyển đổi công cụ (từ 2.3 giờ xuống <0.5 giờ)
- Tăng điểm hài lòng của khách hàng từ 3.8 lên 4.5 (trên thang 5)
- Tăng năng suất của nhân viên hỗ trợ thêm 35%
## Bối cảnh và nền tảng
**Tại sao là bây giờ**: Mức độ hài lòng của khách hàng đã giảm 15% trong 6 tháng qua, chủ yếu do phản hồi chậm. Đối thủ hàng đầu của chúng ta đã ra mắt dashboard hỗ trợ hợp nhất vào quý trước, và chúng ta đang nghe khách nhắc đến nó trong các cuộc gọi bán hàng. Tỷ lệ nghỉ việc của team hỗ trợ ở mức 45% mỗi năm, với "công cụ quá phức tạp" là một trong những lý do gây bực bội hàng đầu.
**Gắn kết chiến lược**: Điều này phù hợp với mục tiêu Q1 của công ty là "Tăng tỷ lệ giữ chân khách hàng thêm 10%" và OKR của team hỗ trợ là "Giảm 25% thời gian xử lý trung bình."
**Tóm tắt nghiên cứu người dùng**: Chúng tôi đã phỏng vấn 12 nhân viên hỗ trợ và quan sát 20 giờ làm việc hỗ trợ. Các phát hiện chính:
- Nhân viên dành 35% thời gian để tìm lại bối cảnh từ các lần tương tác trước
- 65% các trường hợp escalation là do thiếu lịch sử hội thoại
- Nhân viên đánh giá việc chuyển đổi công cụ là nỗi bực bội số 1 hằng ngày (mức khó chịu 9.2/10)
- NPS hiện tại cho trải nghiệm hỗ trợ là -12
## User story và tình huống sử dụng
**US1: Hộp thư hợp nhất**
Là một nhân viên hỗ trợ, tôi muốn thấy mọi yêu cầu của khách hàng ở một nơi để không bỏ sót yêu cầu khẩn cấp và có thể sắp xếp ưu tiên hiệu quả.
Tiêu chí chấp nhận:
- Hộp thư hiển thị yêu cầu từ email, chat và mạng xã hội
- Yêu cầu được sắp xếp theo mức ưu tiên (khẩn cấp, cao, bình thường, thấp)
- Nhân viên có thể lọc theo kênh, khách hàng hoặc trạng thái
- Cập nhật theo thời gian thực khi có yêu cầu mới
**US2: Bối cảnh xuyên kênh**
Là một nhân viên hỗ trợ, tôi muốn thấy toàn bộ lịch sử hội thoại bất kể kênh nào để có thể phản hồi nhất quán, đầy đủ thông tin mà không bắt khách hàng phải nhắc lại.
Tiêu chí chấp nhận:
- Chế độ xem dòng thời gian hiển thị mọi tương tác theo thứ tự thời gian
- Mỗi tương tác hiển thị kênh, thời điểm và nội dung
- Hồ sơ khách hàng hiển thị thông tin nhân khẩu học và thông tin tài khoản
- Có thể truy cập các vấn đề và cách giải quyết trước đây
[Tiếp tục với tổng cộng 5-7 user story...]