Viết đặc tả và tiêu chí nghiệm thu trước khi code
spec-driven-workflow
Hướng dẫn viết đặc tả tính năng, tiêu chí nghiệm thu, rồi sinh bài kiểm thử từ chính đặc tả đó trước khi bắt đầu lập trình.
Tải miễn phí. Theo dõi Skilnexa một lần là mở khoá mọi lượt tải trên web.
Nó là gì
Quy trình viết đặc tả và tiêu chí nghiệm thu bằng Given/When/Then trước khi viết code, rồi sinh test từ đặc tả. Dành cho người lập kế hoạch tính năng và lập trình viên; AI phải dừng hỏi khi đặc tả chưa rõ.
Hoạt động ra sao
AI hỏi các câu về vấn đề, người dùng và điều không làm; viết đặc tả có mã FR, AC, EC; chạy spec_validator để chấm điểm, cần đạt 80 trở lên. Sau đó sinh file test ban đầu đều đỏ, và chỉ viết code khi đặc tả đã được duyệt.
Ví dụ ứng dụng
- Tình huống
- Đội kế toán muốn thêm xuất hóa đơn ra PDF cho khách, cần tiêu chí nghiệm thu rõ trước khi code.
- Bạn đưa vào
- Mô tả: xuất hóa đơn PDF theo mẫu, người dùng là kế toán, không làm chữ ký số.
- Bạn nhận được
- File đặc tả spec.md đủ các mục, tiêu chí Given/When/Then, và file test pytest ban đầu.
Ví dụ minh họa theo quy trình trong tài liệu gốc, chưa phải kết quả thử chạy.
Dùng khi nào
Khi sắp làm tính năng mới như đặt lại mật khẩu và muốn chốt yêu cầu rõ trước khi viết mã.
Các phần chính trong hướng dẫn
- Định dạng đặc tả
- Các mục bắt buộc
- Quy tắc tự chủ có giới hạn
- Khi nào dừng lại để hỏi
- Quy trình báo cáo lên cấp trên
- Giai đoạn 1: Thu thập yêu cầu
- Giai đoạn 2: Viết đặc tả
- Giai đoạn 3: Kiểm tra đặc tả
Xem mô tả gốc của tác giả (tiếng Anh)
Use when the user asks to write specs before code, define acceptance criteria, plan features before implementation, generate tests from specifications, or follow spec-first development practices.
Ví dụ yêu cầu
- A complete worked example (Password Reset spec with extracted test cases) is available in [spec_format_guide.md](references/spec_format_guide.md#full-example-password-reset). It demonstrates all 9 sections, requirement numbering, acceptance criteria, edge cases, and the corresponding pytest stubs generated by
test_extractor.py.
Cùng nhóm Kỹ thuật phần mềm
- Kiểm tra và sửa lỗi truy cập cho người khuyết tậtQuét mã web theo WCAG 2.2 mức A và AA, tự sửa lỗi, kiểm độ tương phản màu, lập báo cáo; chạy được cho React, Vue, Angular, Svelte, HTML.
- Rà soát mã khắt khe qua ba góc nhìnXem lại thay đổi mã bằng ba nhân vật khó tính: kẻ phá hoại, người mới vào và kiểm toán bảo mật; mỗi người phải tìm ra lỗi, kết luận BLOCK, CONCERNS hoặc CLEAN.
- Điều quân đoàn agent làm việc lớn song songTriển khai hai lớp agent song song cho việc lớn như viết lại nhiều tệp, di chuyển hàng loạt, kiểm tra toàn mã nguồn, có an toàn git và kiểm tra trước khi chạy.
- Thiết kế hệ nhiều agent phối hợpChọn kiểu điều phối (giám sát, bầy đàn, dây chuyền), tạo khai báo công cụ cho agent và phân tích nhật ký chạy về chi phí, độ trễ, lỗi.
- Chạy bầy agent xử lý dữ liệu hàng loạtTriển khai nhiều agent phụ xử lý song song các việc dữ liệu như 1000 tài liệu, phân tích bộ dữ liệu, tạo nội dung số lượng lớn; có theo dõi tiến độ và khắc phục lỗi.
- Dựng đội agent cho quy trình kinh doanhHỏi về quy trình công việc rồi tạo cấu hình đội agent gồm vai trò, quyền dùng công cụ, cách liên lạc và quy tắc bàn giao.
Phần giải thích do Skilnexa viết sau khi đọc toàn bộ tài liệu gốc của tác giả và đã đối chiếu lại với nội dung gốc. Chưa phải kết quả thử chạy, nên hãy thử bằng dữ liệu giả trước khi dùng cho việc thật.