Superpowers: bộ skill buộc Claude Code lên kế hoạch, viết test rồi mới code
Tóm tắt
Superpowers (obra/superpowers) là thư viện quy trình cho Claude Code. Các skill được nạp tự động và buộc agent đi qua những bước mà lập trình viên giỏi vẫn làm: làm rõ yêu cầu, viết kế hoạch, code theo TDD, debug có hệ thống và kiểm chứng trước khi tuyên bố hoàn thành.
Cách phổ biến nhất để dùng AI viết code là gõ “xây cho tôi app X” rồi hy vọng. Với việc nhỏ thì ổn; với tính năng nhiều file thì thường dẫn đến code chạy được nhưng sai hướng, thiếu test và khó review. Superpowers (obra/superpowers) là thư viện quy trình cho Claude Code: các skill được nạp tự động và buộc agent đi qua những bước mà lập trình viên giỏi vẫn làm — làm rõ yêu cầu, lập kế hoạch, code theo TDD, debug có hệ thống và kiểm chứng trước khi báo xong.
Các skill chính
| Skill | Làm gì |
|---|---|
| Brainstorming | Hỏi lại để làm rõ ý tưởng trước khi viết dòng code nào |
| Writing plans | Viết kế hoạch chi tiết: các giai đoạn, lệnh kiểm chứng, tiêu chí thành công, phương án rollback |
| Executing plans | Thực thi theo từng đợt, có điểm dừng để review |
| Test-driven development | RED → GREEN → REFACTOR: test thất bại trước, code sau |
| Systematic debugging | Tìm nguyên nhân gốc → tìm pattern → kiểm giả thuyết → sửa |
| Verification before completion | Phải chạy lệnh kiểm chứng và xem kết quả trước khi báo “xong” |
Vì sao quy trình này hiệu quả?
- Sai sớm thì rẻ: sửa một đoạn plan rẻ hơn nhiều so với viết lại ba mươi file.
- Test trước làm rõ yêu cầu: khi agent phải viết test thất bại trước, “thế nào là đúng” được định nghĩa bằng thứ chạy được.
- Điểm dừng review: thực thi theo đợt cho người có chỗ chen vào trước khi sai lan rộng.
- Không tự tuyên bố hoàn thành: bước kiểm chứng bắt agent chứng minh bằng kết quả lệnh.
Cài đặt
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
Một luồng làm việc điển hình
- Bạn mô tả tính năng ở mức ý tưởng.
- Agent đặt câu hỏi làm rõ (brainstorming) và tóm tắt thiết kế để bạn xác nhận.
- Agent viết file plan: giai đoạn, lệnh kiểm chứng, tiêu chí thành công, rollback.
- Bạn review plan — điểm kiểm soát quan trọng nhất.
- Agent thực thi từng đợt theo TDD, dừng để bạn xem sau mỗi đợt.
- Trước khi báo xong, agent chạy kiểm chứng và trình kết quả.
Khi nào không nên dùng đầy đủ?
- Sửa một dòng, đổi tên biến, chỉnh câu chữ: quy trình đầy đủ tốn thời gian và token hơn giá trị mang lại.
- Khám phá, prototype vứt đi: kế hoạch chi tiết là thừa.
- Khi bạn chưa biết mình muốn gì: dùng brainstorming để làm rõ, chưa vội vào plan.
Áp dụng thế nào?
- Dev: dùng cho tính năng nhiều file, migration, refactor — nơi thiếu kế hoạch là trả giá đắt.
- Tech Lead: coi file plan như một tài liệu thiết kế nhỏ; review nó như review design doc trước khi agent đụng vào code.
- PM: plan và tiêu chí thành công do agent viết có thể dùng làm acceptance criteria, rồi đối chiếu khi nghiệm thu.