Agentic TDD (trên ứng dụng đang chạy)
Skill áp dụng vòng lặp red-green-refactor lên ứng dụng thật để phát triển hành vi UI/full-stack mà unit test không diễn tả được.
Skill này làm gì
Nó đưa TDD lên một tầng cao hơn: thay vì test unit, bạn khai báo hệ quả mong đợi trên ứng dụng đang chạy thật (ví dụ "bấm Deploy thì POST /api/deploy trả 200, store chuyển sang deploying, banner hiện ra"). Nhờ reticle_act_and_wait({ ref, action, until }), kỳ vọng được nêu trước khi hành động chạy, nên agent không thể sửa assertion cho vừa với code vừa viết.
- RED: khai báo kỳ vọng, phải thấy
verified: "no";unknownkhông phải là red - GREEN: viết thay đổi nhỏ nhất rồi chạy lại đúng lệnh cũ, không sửa
- REFACTOR: predicate gắn với hành vi (request, signal, state) nên đổi markup không làm test đỏ oan
- Lưu lại bằng
reticle_flow_save/reticle_flow_verifythành bộ test hồi quy
Có cả thang độ mạnh của assertion (signal > state > network > element > vắng console error) và quy tắc trung thực: không bao giờ nới lỏng kiểm tra để lấy màu xanh.
Phù hợp với ai
- Dev web/full-stack dùng Claude Code muốn kiểm chứng trên app thật thay vì mock
- Người muốn chặn thói quen "viết code rồi hy vọng đúng" của agent
- Người không muốn viết tay bộ test E2E hồi quy
Ví dụ sử dụng
- Làm nút Deploy: khai báo trước POST /api/deploy 200 + signal
deploy:started+ banner + không có lỗi console, xem nó đỏ, rồi mới code. - Khi verdict là
unknown/unsettled: dùngreticle_assertđể xác nhận lại thay vì lặp lại hành động gây side effect. - Refactor component: chạy lại đúng predicate cũ để chứng minh hành vi không đổi.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/reticlehq/reticle/HEAD/skills/agentic-tdd/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/agentic-tdd từ repo GitHub reticlehq/reticle vào ~/.claude/skills/agentic-tdd/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/reticlehq/reticle.git /tmp/reticle && mkdir -p ~/.claude/skills && cp -r /tmp/reticle/skills/agentic-tdd ~/.claude/skills/agentic-tdd⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Clone repo và sao chép skill:
git clone https://github.com/reticlehq/reticle.git /tmp/reticle && mkdir -p ~/.claude/skills && cp -r /tmp/reticle/skills/agentic-tdd ~/.claude/skills/agentic-tdd - Khởi tạo Reticle:
RETICLE_INSTALL_SOURCE=npx_skill npx @reticlehq/server@latest init - Làm theo skill
install-and-verifytrong cùng repo để kiểm tra kết nối MCP. - Khởi động lại Claude Code và kiểm tra
agentic-tddxuất hiện trong danh sách skill. - Chạy dev server, rồi yêu cầu "làm tính năng này theo TDD" để kích hoạt skill.