tdd-guide

Tổng quan về tdd-guide skill

tdd-guide dùng để làm gì

tdd-guide là một tdd-guide skill dành cho Test Driven Development, hỗ trợ tạo unit test, tìm khoảng trống coverage, xây dựng fixture và mock, cũng như dẫn dắt quy trình red-green-refactor trên các stack phổ biến. Skill này hữu ích nhất khi bạn muốn AI assistant làm nhiều hơn việc “viết vài test”: nó kéo cuộc trao đổi về đúng những yếu tố cần thiết như source code, yêu cầu, framework mục tiêu, báo cáo coverage và tiêu chí xác thực.

Người dùng và dự án phù hợp nhất

tdd-guide skill phù hợp với đội ngũ kỹ thuật, lập trình viên độc lập và các contributor thiên về QA đang làm việc với TypeScript, JavaScript, Python hoặc Java. Skill này đặc biệt phù hợp với các workflow theo kiểu Jest, Pytest, JUnit, Vitest và Mocha. Hãy dùng khi bạn đang bổ sung test cho code hiện có, bắt đầu một tính năng mới theo hướng test-first, cải thiện coverage để đạt một ngưỡng cụ thể, hoặc chuẩn hóa đầu ra test trong cả nhóm.

Điểm khác biệt so với prompt viết test thông thường

Một prompt chung chung có thể tạo ra các test trông hợp lý, nhưng thường bỏ sót convention của framework, edge case, mức độ ưu tiên coverage hoặc chính vòng lặp TDD. tdd-guide có cấu trúc workflow, ví dụ input, mẫu output kỳ vọng, công cụ phân tích coverage, tạo fixture, thích ứng theo framework và tài liệu tham chiếu cho tích hợp CI. Vì vậy, skill này phù hợp hơn cho công việc kỹ thuật lặp lại được, thay vì chỉ thử nghiệm prompt một lần.

Khi nào tdd-guide có thể chưa đủ

tdd-guide for Test Driven Development không thay thế cho việc hiểu hành vi nghiệp vụ của domain. Nếu bạn không cung cấp được kết quả mong đợi, dependency, quy tắc lỗi hoặc chi tiết framework, test được tạo ra có thể nông. Skill này cũng không tự động đảm bảo test sẽ compile trong repository của bạn; bạn vẫn cần chạy lệnh test cục bộ và điều chỉnh import, setup file, mock cũng như cấu hình theo môi trường cụ thể.

Cách sử dụng tdd-guide skill

Cài đặt tdd-guide và xem trước repository

Cài skill trong môi trường tương thích với Claude Skills bằng:

npx skills add alirezarezvani/claude-skills --skill tdd-guide

Sau đó xem thư mục skill upstream tại engineering-team/skills/tdd-guide. Bắt đầu với SKILL.md để nắm quy tắc kích hoạt và workflow, rồi đọc HOW_TO_USE.md để xem ví dụ gọi skill. Nếu cần thiết lập theo từng framework, hãy xem references/framework-guide.md; nếu mục tiêu của bạn là siết chặt build, đọc references/ci-integration.md; nếu muốn cải thiện thói quen TDD, xem references/tdd-best-practices.md.

Những input giúp dùng tdd-guide hiệu quả hơn

Skill hoạt động tốt nhất khi bạn cung cấp bốn thứ: code hoặc yêu cầu tính năng, ngôn ngữ, test framework và hành vi mong đợi. Input tốt nên bao gồm happy path, trường hợp lỗi, giá trị biên, dependency bên ngoài và mục tiêu coverage.

Một prompt yếu là: “Write tests for my auth service.”

Một prompt tốt hơn là: “Use tdd-guide to generate Jest tests for src/auth/password-validator.ts. Cover valid password, too short password, missing uppercase, missing number, missing special character, and null or empty input. Target 90% branch coverage. Use existing project style: describe, beforeEach, and expect(...).toBe(...).”

Workflow tdd-guide thực tế

Với code hiện có, hãy đi theo trình tự này:

1. Dán hoặc tham chiếu source file.
2. Chỉ định language, framework và quy ước đặt tên test file.
3. Yêu cầu test được nhóm theo mức ưu tiên: P0 behavior, P1 edge cases, P2 regressions.
4. Chạy các test được tạo ở máy local.
5. Dán lại compile error, assertion bị fail hoặc output coverage vào assistant.
6. Yêu cầu skill tinh chỉnh import, mock, fixture và các branch còn thiếu.

Với tính năng mới, hãy dùng red-green-refactor: trước tiên yêu cầu các failing test từ acceptance criteria, triển khai phần code nhỏ nhất để test pass, sau đó yêu cầu cải thiện theo hướng an toàn khi refactor trong khi vẫn giữ test xanh.

Các file và script nên xem trước

Repository có những file hỗ trợ thực tế rất đáng đọc trước khi dùng nghiêm túc:

• assets/sample_input_python.json và assets/sample_input_typescript.json cho thấy mức độ input có cấu trúc giúp cải thiện chất lượng output.
• assets/expected_output.json cho thấy kiểu tổng hợp về test, coverage và chất lượng mà skill được thiết kế để tạo ra.
• scripts/test_generator.py hỗ trợ các pattern tạo test.
• scripts/coverage_analyzer.py liên quan khi bạn có dữ liệu coverage ở dạng LCOV, JSON hoặc XML.
• scripts/fixture_generator.py, framework_adapter.py và tdd_workflow.py cho biết skill suy nghĩ như thế nào về mock, convention của framework và các pha TDD.

FAQ về tdd-guide skill

tdd-guide có phù hợp với người mới không?

Có, nếu người mới có một tính năng hoặc function cụ thể cần test. tdd-guide skill có thể giúp học nhịp red, green và refactor, đồng thời tạo ra ví dụ dùng được. Tuy vậy, người mới vẫn nên chạy mọi test được tạo và đọc kỹ lỗi. Giá trị học được đến từ việc so sánh hành vi kỳ vọng, assertion được tạo và implementation thực tế.

tdd-guide hỗ trợ framework nào tốt nhất?

Phù hợp nhất là Jest, Pytest, JUnit và Vitest, đồng thời Mocha cũng được nhắc đến trong mô tả skill. Tài liệu framework đi kèm bao quát các pattern cho TypeScript/JavaScript, Python và Java. Nếu bạn dùng một framework ít phổ biến hơn, hãy cung cấp một test file mẫu từ repository để skill có thể khớp import, cách đặt tên, setup hook và style assertion.

tdd-guide có phân tích báo cáo coverage không?

Có. tdd-guide được thiết kế để làm việc với các báo cáo coverage như LCOV, JSON và XML. Để có kết quả tốt nhất, hãy dán các file và branch chưa được cover có liên quan, thay vì chỉ đưa một con số phần trăm. Một prompt như “coverage is 65%” kém hữu ích hơn so với việc chia sẻ coverage/lcov.info, khoảng dòng chưa được cover và các source file gắn với những khoảng trống đó.

Khi nào không nên dùng tdd-guide?

Không nên dùng skill này như cổng kiểm soát chất lượng duy nhất cho các hành vi liên quan đến bảo mật trọng yếu, tài chính, y tế hoặc tuân thủ quy định. Nó có thể giúp phác thảo test và chỉ ra khoảng trống, nhưng không thể xác nhận tính đúng đắn nghiệp vụ nếu không có quy tắc có thẩm quyền. Skill này cũng không phù hợp khi codebase không thể chia sẻ, hành vi public chưa được định nghĩa, hoặc dự án phụ thuộc nhiều vào các môi trường tích hợp ẩn.

Cách cải thiện tdd-guide skill

Cải thiện kết quả tdd-guide bằng prompt tốt hơn

Cách nhanh nhất để cải thiện output của tdd-guide là cung cấp hành vi, không chỉ code. Hãy đưa vào ví dụ input hợp lệ, input không hợp lệ, exception mong đợi, giá trị biên và mọi convention test hiện có. Nếu cần mock, hãy nêu tên dependency và xác định phần nào nên stub, phần nào nên chạy thật.

Các bổ sung hữu ích cho prompt gồm:

• “Do not mock the pure calculation function.”
• “Mock the payment gateway and assert it is called once.”
• “Use parameterized Pytest cases for boundary values.”
• “Prefer behavior-focused test names over implementation names.”

Sửa các lỗi thường gặp sau output đầu tiên

Các vấn đề thường gặp gồm sai import, mock quá mức, assertion bám chặt vào implementation, thiếu xử lý async và test làm tăng line coverage nhưng không tăng độ tin cậy. Sau kết quả đầu tiên, hãy dán lỗi test hoặc compile error và yêu cầu sửa có mục tiêu. Ví dụ: “These Jest tests fail because the service constructor requires a repository dependency. Revise using a typed mock and keep the same behavioral coverage.”

Dùng dữ liệu coverage để ưu tiên công việc

Nếu mục tiêu của bạn là cải thiện coverage, hãy yêu cầu skill xếp hạng các khoảng trống theo rủi ro thay vì tạo test cho mọi dòng chưa được cover. Ưu tiên các conditional chưa được test, error branch, public method và business rule trước các getter đơn giản hoặc nhánh phòng thủ ít giá trị. Workflow coverage của repository hỗ trợ phân mức P0/P1/P2, hữu ích hơn nhiều so với chỉ chạy theo một con số phần trăm thô.

Lặp lại để xây dựng thực hành TDD dễ bảo trì

Cách dùng tdd-guide tốt nhất là theo vòng lặp. Trước tiên yêu cầu failing test từ requirements, sau đó hỏi về hình dạng implementation tối thiểu, rồi yêu cầu gợi ý refactor mà vẫn giữ test ổn định. Hãy giữ assistant tập trung vào hành vi quan sát được: input, output, side effect, exception và ranh giới tích hợp. Cách này tạo ra các test vẫn hữu ích sau khi implementation thay đổi.