SSkilnexa
SkillKỹ thuật phần mềmHợp với: Lập trình viênMức: Kỹ thuật

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út theo dõi đang được chuẩn bị.
Link tải đang được chuẩn bị.

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

  1. Định dạng đặc tả
  2. Các mục bắt buộc
  3. Quy tắc tự chủ có giới hạn
  4. Khi nào dừng lại để hỏi
  5. Quy trình báo cáo lên cấp trên
  6. Giai đoạn 1: Thu thập yêu cầu
  7. Giai đoạn 2: Viết đặc tả
  8. 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

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.