Checklist chất lượng

Trước khi bắt đầu

Cần biết: nội dung spec.md và plan.md của tính năng đang làm
Cần có: kế hoạch (plan) đã hoàn thành ở bước lập kế hoạch
Cần đang ở: thư mục gốc của dự án, sau /speckit-plan và trước /speckit-tasks

1. Checklist là unit test cho yêu cầu

Hãy nghĩ về checklist này như unit test cho chính các yêu cầu của bạn. Nó không kiểm thử mã nguồn. Nó kiểm tra xem bản đặc tả (specification) đã đầy đủ, rõ ràng, không mơ hồ và nhất quán hay chưa.

Ví dụ một tiêu chí chất lượng: "Quy tắc kéo thả đã được định nghĩa cho mọi cột chưa?" hay "Hành vi khi người được gán việc bị xoá đã được nêu chưa?". Đây là câu hỏi về yêu cầu, không phải về code.

2. Sinh checklist cho tính năng

Gõ trong khung chat của công cụ AI:

text

/speckit-checklist

Kết quả mong đợi: công cụ tạo tệp checklist trong specs/NNN-*/checklists/ với các tiêu chí chất lượng cho tính năng của bạn.

3. Hoặc tập trung vào một khía cạnh

text

/speckit-checklist Tập trung vào tương tác bảng Kanban và quyền bình luận.

Kết quả mong đợi: checklist chỉ chứa tiêu chí xoay quanh hai khía cạnh bạn nêu.

4. Xem checklist vừa sinh

bash

ls specs/001-*/checklists/

Kết quả mong đợi: bạn thấy một hoặc nhiều tệp .md trong thư mục checklists/.

5. Đánh dấu `[x]` nghĩa là gì

Mỗi mục trong checklist có một ô đánh dấu. Cách hiểu đúng:

[x] nghĩa là người duyệt đã xác nhận tiêu chí chất lượng của yêu cầu đã đạt.
[x] KHÔNG có nghĩa là công việc cài đặt đã code xong.

Checklist này thuộc quyền người duyệt. Công cụ AI có thể hỗ trợ đánh giá khi bạn yêu cầu rõ, nhưng không được tự đánh dấu thay bạn. Đây là lý do /speckit-implement chỉ đọc trạng thái ô đánh dấu và không bao giờ tự sửa chúng.

6. Nếu checklist chỉ ra lỗ hổng

Khi checklist phát hiện yêu cầu còn thiếu hoặc mơ hồ, đừng đánh dấu cho xong. Quay lại bước làm rõ /speckit-clarify hoặc bước tạo đặc tả /speckit-specify để siết lại spec.md, rồi mới chuyển sang chia việc.

7. Phân biệt với checklist có sẵn của đặc tả

Bước tạo đặc tả có thể duy trì một tệp checklists/requirements.md riêng — đó là checklist chất lượng đặc tả do /speckit-specify tạo và /speckit-clarify đánh giá lại. Vòng đời đó tách biệt với checklist tùy chỉnh do /speckit-checklist sinh ra.

Kết quả

Sau khi hoàn thành trang này, bạn đã:

Sinh được checklist chất lượng yêu cầu cho tính năng
Hiểu [x] là xác nhận của người duyệt về chất lượng yêu cầu, không phải xác nhận đã code xong

Cách tự xác nhận: thư mục specs/NNN-*/checklists/ tồn tại và mỗi tiêu chí trong đó là một câu hỏi về yêu cầu, không phải về mã nguồn.

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách khắc phục
Không có thư mục `checklists/` nào được tạo	Chưa có `plan.md` hoặc chạy sai thư mục	Hoàn thành `/speckit-plan` rồi gọi lại lệnh từ thư mục gốc dự án
Checklist toàn câu hỏi về code	Hiểu sai mục đích của lệnh	Đọc lại mục 1 và gọi lại lệnh với vùng tập trung vào yêu cầu
Công cụ tự đánh dấu `[x]` hộ bạn	Không nêu rõ ai là người duyệt	Tự rà lại từng mục và chỉ giữ `[x]` ở mục bạn đã thật sự xác nhận
Đánh dấu hết `[x]` để `/speckit-implement` chạy cho nhanh	Hiểu sai ý nghĩa ô đánh dấu	Bỏ đánh dấu ở mục chưa duyệt; sửa đặc tả trước rồi mới duyệt

Nguồn tham chiếu: Agentic SDDPhiên bản kiểm chứng: Spec Kit 1.1.3

Checklist chất lượng ​

1. Checklist là unit test cho yêu cầu ​

2. Sinh checklist cho tính năng ​

3. Hoặc tập trung vào một khía cạnh ​

4. Xem checklist vừa sinh ​

5. Đánh dấu [x] nghĩa là gì ​

6. Nếu checklist chỉ ra lỗ hổng ​

7. Phân biệt với checklist có sẵn của đặc tả ​

Kết quả ​

Lỗi thường gặp ​