← Về trang Blog

🦸 Superpowers — Quy Trình Giúp AI Code Đúng Từ Lần Đầu

Bộ 14 skill giúp AI assistant không viết code lung tung, không sót bước, và không claim "xong" khi chưa xong — giống như checklist bay của phi công.


Bạn có bao giờ gặp tình huống này:

Thân quen quá đúng không?

Superpowers là bộ 14 skill được thiết kế để ngăn AI làm những sai lầm trên. Nó biến AI từ "coder bốc đồng" thành "kỹ sư có kỷ luật" — làm việc theo quy trình, có bằng chứng, có checkpoint, không skip bước.

❌ Trước — AI Code "Tự Do"

  • Đọc yêu cầu sơ sơ → code ngay
  • Code xong mới nghĩ đến test
  • Fix bug bằng cách đoán → thử may
  • Claim "xong" dựa trên cảm giác
  • Regression liên tục, phải sửa đi sửa lại

✅ Sau — AI Code Có Kỷ Luật

  • Thiết kế → duyệt → rồi mới code
  • Test trước, code sau (TDD)
  • Debug có hệ thống, tìm root cause
  • Chỉ claim "xong" khi có bằng chứng
  • Ít regression, code chất lượng hơn

🎯 Tại Sao Cần Superpowers?

AI assistant rất thông minh, nhưng nó có một "lỗi thiết kế": nó muốn làm ngay. Bạn nói "làm tính năng X" → nó code ngay. Bạn nói "fix bug Y" → nó sửa ngay. Vấn đề là: code ngay ≠ code đúng.

Superpowers giải quyết vấn đề này bằng cách cài đặt quy trình bắt buộc: mỗi skill là một bước trong quy trình phát triển, và các "hard gate" (cửa khóa cứng) đảm bảo AI không thể skip bước.

Quy tắc nền: Process skill chạy trước implementation skill. Thiết kế chưa duyệt → không code. Test chưa đỏ → không xanh. Chưa có bằng chứng → không claim "xong". Không ngoại lệ.

📋 14 Skills — Quy Trình Từ A Đến Z

Mỗi skill trong Superpowers đảm nhận một vai trò cụ thể. Dưới đây là toàn bộ 14 skills, chia theo từng giai đoạn:

🏗️ Giai Đoạn 1: Thiết Lập & Khám Phá

Nền Tảng

1. using-superpowers

Kiểm tra skill phù hợp trước khi làm bất cứ điều gì. Giống như phi công check checklist trước khi cất cánh — không skip.

Thiết Kế

2. brainstorming

Biến ý tưởng thành thiết kế chi tiết trước khi code. Hỏi rõ yêu cầu, đưa 2-3 phương án, ghi spec, chờ duyệt rồi mới triển khai.

📐 Giai Đoạn 2: Lập Kế Hoạch

Kế Hoạch

3. writing-plans

Chuyển spec thành implementation plan với từng bước nhỏ cụ thể. Mỗi task có test rõ ràng, lệnh rõ ràng, kết quả mong đợi rõ ràng. Không placeholder, không "tương tự task trước".

Workspace

4. using-git-worktrees

Tách feature work khỏi nhánh chính bằng git worktree — tránh làm rối codebase, dễ rollback khi sai.

⚡ Giai Đoạn 3: Thực Thi

Thực Thi

5. executing-plans

Chạy plan tuần tự, từng task một, có checkpoint và bằng chứng. Dừng ngay khi gặp blocker, test lỗi, hoặc instruction mơ hồ.

Kiểm Thử

6. test-driven-development

RED → GREEN → REFACTOR. Viết test trước (phải fail), code tối thiểu để pass, rồi dọn code. Code có trước test phải xóa làm lại — test viết sau không chứng minh được gì.

Điều Phối

7. subagent-driven-development

Giao từng task cho subagent riêng, có reviewer độc lập. Giống như một trưởng nhóm điều phối đội — mỗi người làm việc của mình, có người review.

Song Song

8. dispatching-parallel-agents

Chạy nhiều agent cùng lúc cho các việc độc lập — tiết kiệm thời gian khi có nhiều task không phụ thuộc nhau.

🔍 Giai Đoạn 4: Debug & Review

Debug

9. systematic-debugging

Tìm root cause trước khi sửa. Thu thập bằng chứng → giả thuyết → test → sửa. Sau 3 lần fix thất bại → dừng lại, xem lại kiến trúc.

Review

10. requesting-code-review

Nhờ reviewer độc lập (một AI khác) đọc code trước khi merge — bắt lỗi mà người viết không thấy.

Review

11. receiving-code-review

Đánh giá feedback review bằng kỹ thuật, không đồng ý theo phản xạ. Phản biện bằng bằng chứng khi cần.

✅ Giai Đoạn 5: Xác Minh & Hoàn Tất

Bằng Chứng

12. verification-before-completion

Skill quan trọng nhất. Trước khi nói "xong", phải IDENTIFY → RUN → READ → VERIFY. Run test mới, đọc output mới, xác minh bằng bằng chứng mới. Không dùng kết quả cũ, không dùng cảm giác.

Hoàn Tất

13. finishing-a-development-branch

Đưa công việc đã kiểm chứng tới quyết định tích hợp: chạy test cuối, xác định base, trình bày lựa chọn (merge/squash/rebase), chờ người dùng quyết định. Không tự merge.

Authoring

14. writing-skills

Áp dụng TDD để tạo và sửa skill — viết failing test trước, rồi mới viết skill. Đảm bảo skill thực sự hoạt động, không phải "paper skill".

🔑 Các Hard Gate — Không Được Bỏ Qua

Điều làm Superpowers mạnh không phải là 14 skill — mà là các hard gate (cửa khóa cứng) ngăn AI skip bước:

Hard Gate Ý Nghĩa
Thiết kế chưa duyệt → không code Ngăn AI code sai yêu cầu từ đầu
RED trước GREEN Test phải fail trước → code mới pass → chứng minh test có giá trị
Chưa verify → không claim "xong" Ngăn AI nói "done" khi chưa thực sự done
3 lần fix thất bại → dừng Ngăn AI fix mù quáng, phải xem lại kiến trúc
Không tự merge Luôn chờ người dùng quyết định cuối
⚠️ Lưu ý: Superpowers không phải "gợi ý" — nó là quy tắc bắt buộc. Nếu AI skip hard gate, nó đang vi phạm protocol và cần được reset về đúng quy trình.

💡 Cách Sử Dụng

Để AI sử dụng Superpowers, chỉ cần gọi tên skill cụ thể trong yêu cầu:

# Để thiết kế tính năng mới
"superpowers:brainstorming — thiết kế tính năng export PDF"

# Để debug bug
"superpowers:systematic-debugging — test login đang fail"

# Để đảm bảo code đúng trước khi merge
"superpowers:verification-before-completion"

AI sẽ tự động đọc SKILL.md tương ứng và làm theo quy trình đã định nghĩa.

🏁 Kết Luận

Superpowers không làm AI thông minh hơn — nó làm AI chuyên nghiệp hơn. Giống như:

Nếu bạn đang dùng AI assistant để code, Superpowers là bộ quy trình mà bạn nên áp dụng. Nó không phức tạp, không chậm — ngược lại, nó giúp bạn tiết kiệm thời gian bằng cách ngăn AI làm sai từ đầu.

🎯 TL;DR: Superpowers = checklist cho AI. Thiết kế → lập kế hoạch → TDD → debug có hệ thống → review → verify bằng bằng chứng → hoàn tất. Không skip bước. Không claim khi chưa xong. Code đúng từ lần đầu.