Trong bất kỳ môi trường phát triển linh hoạt hay phát triển theo từng giai đoạn nào, chất lượng sản phẩm cuối cùng trực tiếp liên quan đến độ rõ ràng của các yêu cầu. Các câu chuyện người dùng đóng vai trò là đơn vị cơ bản trong việc cung cấp giá trị. Chúng hoạt động như cây cầu nối giữa kỳ vọng của các bên liên quan và việc thực thi kỹ thuật. Tuy nhiên, một thẻ câu chuyện mơ hồ hoặc không nhất quán sẽ tạo ra sự cản trở. Điều này dẫn đến sự mơ hồ trong quá trình phát triển, sự thiếu đồng thuận trong kiểm thử và làm chậm tiến độ giao hàng.
Sự nhất quán trong việc tạo thẻ câu chuyện không chỉ đơn thuần là tuân theo một mẫu. Đó là việc thiết lập một ngôn ngữ chung và một quy trình làm việc có thể dự đoán được. Khi mọi thành viên trong nhóm đều hiểu rõ cấu trúc và mục đích của một câu chuyện, khối lượng nhận thức sẽ giảm đi. Điều này giúp nhóm tập trung vào việc giải quyết vấn đề thay vì phải suy luận các yêu cầu. Các quy tắc sau đây cung cấp một khung để duy trì tiêu chuẩn cao trong danh sách công việc của bạn.
1️⃣ Quy tắc Một: Rõ ràng và Súc tích trong Tiêu đề
Tiêu đề của thẻ câu chuyện là điểm tiếp xúc đầu tiên. Nó phải mô tả rõ ràng nhưng ngắn gọn. Một tiêu đề tốt sẽ cho bạn biết tính năng là gì mà không cần phải đọc toàn bộ phần mô tả. Tránh sử dụng thuật ngữ kỹ thuật trong tiêu đề. Tiêu đề phải dễ hiểu đối với một bên liên quan không chuyên về kỹ thuật.
- Tập trung vào Giá trị: Tiêu đề phải phản ánh giá trị dành cho người dùng hoặc mục tiêu kinh doanh.
- Giữ ngắn gọn: Mục tiêu là ít hơn 10 từ nếu có thể.
- Sử dụng thể chủ động: Bắt đầu bằng động từ hoặc một chủ thể rõ ràng.
Hãy xem sự khác biệt giữa hai tiêu đề sau:
- Xấu: “Sửa lỗi trong mô-đun đăng nhập liên quan đến thời gian hết phiên”
- Tốt: “Cho phép đăng nhập duy trì phiên cho người dùng quay lại”
Tiêu đề đầu tiên nghe như một nhiệm vụ kỹ thuật. Tiêu đề thứ hai mô tả kết quả dành cho người dùng. Sự nhất quán ở đây đảm bảo rằng mọi người đang duyệt danh sách công việc đều hiểu ngay lập tức phạm vi của câu chuyện.
2️⃣ Quy tắc Hai: Định dạng Câu chuyện Người dùng
Để duy trì sự nhất quán, mỗi thẻ câu chuyện phải tuân theo định dạng chuẩn “Là một… Tôi muốn… Vì…” . Định dạng này buộc người viết phải cân nhắc đến nhân vật đại diện, hành động và giá trị. Điều này ngăn ngừa việc nhóm phát triển tính năng mà không hiểu được lý do tại sao.
- Nhân vật đại diện (Là một): Ai đang sử dụng tính năng này? Hãy cụ thể về vai trò.
- Hành động (Tôi muốn): Người dùng cần làm gì? Giữ cho phần này mang tính chức năng.
- Giá trị (Vì): Tại sao điều này quan trọng? Liên kết nó với mục tiêu kinh doanh hoặc nhu cầu của người dùng.
Ví dụ về định dạng nhất quán:
Là một người mua hàng đã đăng ký, Tôi muốn lọc sản phẩm theo kích cỡ, để tôi có thể nhanh chóng tìm thấy những món đồ phù hợp với mình.
Khi các đội đi lệch khỏi điều này, họ thường viết các nhiệm vụ thay vì các câu chuyện. Một nhiệm vụ có thể nói: “Thêm điểm cuối API lọc”. Một câu chuyện nói: “Lọc sản phẩm”. Câu chuyện tập trung vào trải nghiệm người dùng. Nhiệm vụ tập trung vào mã nguồn. Tính nhất quán đòi hỏi phải tuân theo định dạng câu chuyện cho tất cả các mục công việc nhằm mục đích đưa vào danh sách công việc sản phẩm.
3️⃣ Quy tắc ba: Tiêu chí chấp nhận chi tiết
Tiêu chí chấp nhận xác định ranh giới của câu chuyện. Chúng là những điều kiện phải được đáp ứng để câu chuyện được coi là hoàn thành. Không có những tiêu chí này, việc kiểm thử trở nên mang tính chủ quan. Các kiểm thử viên khác nhau có thể hiểu yêu cầu theo cách khác nhau, dẫn đến chất lượng không nhất quán.
- Sử dụng cú pháp Gherkin:Nếu có thể, hãy sử dụng các bước Given/When/Then.
- Hãy cụ thể:Tránh dùng những từ như “nhanh”, “dễ”, hoặc “an toàn”. Hãy dùng con số hoặc trạng thái cụ thể.
- Bao gồm các trường hợp biên:Bao gồm các tình huống lỗi hoặc trạng thái rỗng.
Dưới đây là một ví dụ về tiêu chí chấp nhận mạnh mẽ:
- Cho người dùng đang ở trang sản phẩm, khi họ chọn kích cỡ, thì số lượng tồn kho khả dụng được cập nhật ngay lập tức.
- Cho người dùng không có món hàng nào trong giỏ hàng, khi họ thử thanh toán, thì họ được chuyển hướng đến trang giỏ hàng kèm theo một thông báo.
- Cho người dùng nhập địa chỉ email không hợp lệ, khi họ gửi biểu mẫu, thì một thông báo lỗi xuất hiện ngay dưới trường đó.
Mức độ chi tiết này loại bỏ sự mơ hồ. Nó cho phép nhà phát triển viết các bài kiểm thử tự động và người kiểm thử xác minh hành vi một cách hệ thống.
4️⃣ Quy tắc bốn: Hướng dẫn về kích thước và ước lượng
Tính nhất quán trong việc xác định kích thước giúp lập kế hoạch năng lực hiệu quả. Nếu một số câu chuyện nhỏ và một số khác lại rất lớn, việc lập kế hoạch cho các vòng lặp sẽ trở nên không thể dự đoán được. Một quy tắc phổ biến là đảm bảo không có thẻ câu chuyện nào vượt quá ngưỡng nỗ lực nhất định. Điều này thường phù hợp với mô hình INVEST, cụ thể là tiêu chí “Nhỏ”.
Nếu một câu chuyện quá lớn, nó nên được chia nhỏ. Các tiêu chí chia nhỏ bao gồm:
- Theo vai trò người dùng:Quyền hạn khác nhau giữa quản trị viên và khách truy cập.
- Theo luồng công việc:Đường đi bình thường so với xử lý lỗi.
- Theo trạng thái dữ liệu:Trạng thái rỗng so với trạng thái đã điền dữ liệu.
- Theo mức độ ưu tiên:Chức năng cốt lõi so với các tính năng mong muốn.
| Kích thước câu chuyện | Đặc điểm | Hành động cần thiết |
|---|---|---|
| Nhỏ | Có thể hoàn thành trong 1-2 ngày. | Sẵn sàng cho phát triển. |
| Trung bình | Yêu cầu 3-5 ngày công sức. | Có thể cần chia nhỏ hoặc phân tích thêm. |
| Lớn (Kỷ nguyên) | Yêu cầu nhiều đợt phát triển. | Phải được chia nhỏ thành các câu chuyện nhỏ hơn. |
Thực thi các quy tắc về kích thước này đảm bảo đội duy trì tốc độ ổn định. Nó ngăn chặn tình trạng một câu chuyện khổng lồ duy nhất gây tắc nghẽn, làm chậm việc phát hành giá trị.
5️⃣ Quy tắc năm: Thuật ngữ và từ vựng nhất quán
Sử dụng các từ khác nhau cho cùng một khái niệm sẽ gây nhầm lẫn. Nếu một thành viên đội gọi nó là “Giỏ hàng” và người khác gọi là “Giỏ mua sắm”, lược đồ cơ sở dữ liệu và nhãn giao diện người dùng có thể trở nên không nhất quán. Một từ điển thuật ngữ hoặc một bộ từ ngữ được thống nhất là điều cần thiết.
- Xác định các thuật ngữ chính:Thiết lập một tài liệu trung tâm cho ngôn ngữ lĩnh vực.
- Xem xét trước khi viết:Kiểm tra các thẻ hiện có để đảm bảo khớp thuật ngữ.
- Sử dụng nhãn chuẩn:Tuân theo quy ước đặt tên được sử dụng trong cơ sở mã nguồn nếu có thể.
Quy tắc này cũng áp dụng cho các nhãn trạng thái. Sử dụng các thuật ngữ nhất quán cho các trạng thái như “Đang thực hiện”, “Sẵn sàng kiểm tra” và “Đã xong”. Tránh dùng lẫn lộn “Cần làm”, “Mở” và “Mới” cho cùng một trạng thái. Sự nhất quán trong từ vựng giúp giảm thời gian tìm kiếm thông tin và làm rõ giao tiếp.
6️⃣ Quy tắc sáu: Xử lý các phụ thuộc
Các câu chuyện hiếm khi tồn tại độc lập. Các phụ thuộc có thể làm chậm tiến độ. Một cách tiếp cận nhất quán trong việc ghi chép các phụ thuộc này là điều cần thiết cho quản lý rủi ro. Mỗi thẻ câu chuyện phải nêu rõ ràng nếu nó phụ thuộc vào một câu chuyện khác hoặc một hệ thống bên ngoài.
- Liên kết rõ ràng:Sử dụng tính năng liên kết trong hệ thống để kết nối các câu chuyện liên quan.
- Nguyên nhân cản trở:Rõ ràng đánh dấu nếu một câu chuyện không thể bắt đầu cho đến khi câu chuyện khác hoàn thành.
- Hệ thống bên ngoài:Ghi chú nếu cần một API hoặc dịch vụ bên thứ ba.
Ví dụ về ghi chú phụ thuộc:
Phụ thuộc: Câu chuyện này phụ thuộc vào Câu chuyện #102 (Tích hợp Cổng Thanh Toán). Không được bắt đầu cho đến khi #102 ở trạng thái “Hoàn thành”.
Tính minh bạch này giúp các quản lý dự án hình dung được đường đi then chốt. Nó ngăn cản các nhà phát triển bắt đầu công việc không thể hoàn thành do thiếu các tính năng thượng nguồn.
7️⃣ Quy tắc thứ bảy: Tính nhất quán và định dạng hình ảnh
Bố cục và cảm giác của thẻ câu chuyện ảnh hưởng đến khả năng đọc hiểu. Dù nội dung là vua, thì cách trình bày sẽ giúp não bộ xử lý thông tin nhanh hơn. Sử dụng in đậm để nhấn mạnh, dấu gạch đầu dòng cho danh sách, và tiêu đề cho các phần.
- Các phần chuẩn:Luôn sử dụng các tiêu đề như “Bối cảnh,” “Yêu cầu,” và “Ghi chú” nếu có thể áp dụng.
- Đoạn mã:Sử dụng khối mã cho dữ liệu kỹ thuật hoặc phản hồi API.
- Tài liệu đính kèm:Liên kết đến các bản mô phỏng hoặc sơ đồ thay vì nhúng các hình ảnh lớn làm chậm quá trình tải.
Một bố cục sạch sẽ giúp giảm mệt mỏi nhận thức. Khi một thành viên nhóm mở thẻ, họ nên có thể quét nhanh và hiểu cấu trúc trong vài giây. Sự kỷ luật thị giác này hỗ trợ sự kỷ luật nhận thức cần thiết cho việc giải quyết các vấn đề phức tạp.
8️⃣ Quy tắc thứ tám: Quy trình xem xét và tinh chỉnh
Việc tạo ra không phải là điểm kết thúc của quy trình. Các câu chuyện cần được xem xét trước khi bước vào chu kỳ phát triển. Bước này, thường được gọi là “Tinh chỉnh” hoặc “Chuẩn bị,” đảm bảo rằng các quy tắc chất lượng thực sự được đáp ứng.
Danh sách kiểm tra cho việc xem xét bao gồm:
- Liệu định dạng “Là một / Tôi muốn / Vì vậy” có hiện diện không?
- Các tiêu chí chấp nhận có thể kiểm thử được không?
- Câu chuyện có đủ nhỏ để phù hợp với một vòng phát triển không?
- Tất cả các phụ thuộc đã được xác định chưa?
- Ngôn ngữ sử dụng có nhất quán với các thẻ hiện có không?
| Mục trong danh sách kiểm tra | Tiêu chí vượt qua | Hành động khi thất bại |
|---|---|---|
| Định dạng | Tuân thủ mẫu chuẩn | Trả lại cho người viết để chỉnh sửa |
| Tiêu chí | Tất cả các tình huống đã được bao quát | Thêm các trường hợp kiểm thử còn thiếu |
| Kích thước | Trong phạm vi khả năng của vòng phát triển | Chia thành các thẻ nhỏ hơn |
| Các phụ thuộc | Không có hoặc đã được ghi chép | Xác định nguồn cản trở |
Việc triển khai một cổng xem xét chính thức đảm bảo danh sách công việc vẫn được dọn dẹp. Nó ngăn chặn tình huống ‘rác vào, rác ra’ khi các yêu cầu kém chất lượng dẫn đến phần mềm kém chất lượng.
9️⃣ Quy tắc thứ chín: Liên kết với mục tiêu kinh doanh
Mỗi câu chuyện cần phải truy xuất về một mục tiêu lớn hơn. Điều này đảm bảo rằng đội ngũ đang xây dựng sản phẩm đúng, chứ không chỉ xây dựng sản phẩm một cách đúng đắn. Việc liên kết các câu chuyện với các truyện lớn hoặc các sáng kiến sẽ cung cấp bối cảnh.
- Khả năng truy xuất:Đảm bảo mỗi câu chuyện đều được liên kết với một Truyện lớn hoặc Sáng kiến.
- Đề xuất giá trị:Xem lại phần ‘Để mà’ trong quá trình xem xét để đảm bảo nó vẫn phù hợp với mục tiêu kinh doanh.
- Ưu tiên:Sử dụng liên kết để lý giải tại sao một câu chuyện có mức độ ưu tiên cao.
Khi một câu chuyện được liên kết với mục tiêu kinh doanh, sẽ dễ dàng hơn để loại bỏ hoặc hoãn lại nếu nguồn lực trở nên khan hiếm. Điều này cung cấp lý do rõ ràng cho việc ra quyết định. Sự đồng bộ này giúp đội ngũ tập trung vào việc mang lại giá trị thay vì chỉ hoàn thành các nhiệm vụ.
🔟 Quy tắc thứ mười: Kiểm tra định kỳ và bảo trì
Tính nhất quán sẽ suy giảm theo thời gian. Các quy trình có thể lệch hướng, và các thành viên mới có thể đưa vào sự khác biệt. Việc kiểm tra định kỳ danh sách công việc sẽ giúp duy trì tiêu chuẩn.
- Đánh giá theo quý:Lên lịch thời gian để kiểm tra danh sách công việc về các bất nhất về định dạng.
- Vòng phản hồi:Cho phép các nhà phát triển và kiểm thử đánh dấu các câu chuyện không rõ ràng.
- Cập nhật hướng dẫn:Cập nhật các quy tắc khi đội ngũ trưởng thành hơn hoặc khi các công cụ mới được áp dụng.
Cách tiếp cận chủ động này ngăn ngừa nợ kỹ thuật trong chính tài liệu. Một danh sách công việc được duy trì tốt là tài sản chiến lược giúp đẩy nhanh tiến độ giao hàng theo thời gian.
Những cân nhắc cuối cùng cho thành công
Việc áp dụng các quy tắc này đòi hỏi sự kỷ luật. Nó có thể làm chậm quá trình viết ban đầu. Tuy nhiên, thời gian tiết kiệm được trong quá trình phát triển, kiểm thử và bảo trì vượt xa đầu tư ban đầu. Tính nhất quán tạo nên nhịp điệu. Nó giúp đội ngũ hoạt động ở mức độ hiệu quả cao hơn.
Bằng cách coi việc tạo thẻ câu chuyện như một nghệ thuật, đội ngũ nâng cao chất lượng toàn bộ vòng đời sản phẩm. Trọng tâm chuyển từ quản lý hỗn loạn sang quản lý dòng chảy. Sự ổn định này là nền tảng cho các thực hành phát triển bền vững. Tuân thủ các quy tắc, xem xét công việc và không ngừng cải tiến quy trình.
Hãy nhớ, mục tiêu không phải là sự hoàn hảo trong mỗi thẻ. Mục tiêu là tính dự đoán được. Khi đội ngũ biết trước điều gì sẽ xuất hiện từ một thẻ câu chuyện, họ có thể lập kế hoạch tốt hơn, ước lượng chính xác hơn và giao hàng với sự tự tin. Đây chính là giá trị thực sự của việc tạo thẻ câu chuyện nhất quán.
