Cài "Superpowers" cho Claude Code, phong cách phát triển AI thay đổi hoàn toàn
Gần đây, thuật ngữ "Vibe Coding" (lập trình theo cảm hứng) đang trở nên phổ biến, nhưng thành thật mà nói, nó khá nguy hiểm. Claude Code quả thực rất xuất sắc. Nhưng có phải vì quá xuất sắc mà nó đang trở thành một kẻ "gọi dạ bảo vâng" (Yes Man) không?
Khi bạn bảo "làm cái này đi", nó sẽ phun ra code trong tích tắc. Nhưng khi chạy thử thì lỗi ngập tràn. Nếu chỉ cần code "chạy được là được" thì không sao, nhưng để xây dựng một hệ thống vững chắc, nó vẫn chỉ giống như một "cậu lính mới" (Junior) mà thôi.
Trong bối cảnh đó, tôi đã tìm thấy một dự án quái vật đạt 39k sao trên GitHub. Đó là "Superpowers". Thứ này thực sự sẽ thay đổi hoàn toàn cách bạn sử dụng Claude Code.
Đây không chỉ là một tập hợp các câu lệnh (prompt) đơn thuần. Đây là bộ kỹ năng tối thượng giúp rèn giũa "kỷ luật kỹ thuật" cho Claude Code. Thay vì "triển khai ngay", nó buộc AI phải tuân theo quy trình mà các kỹ sư bình thường chúng ta vẫn làm: "Tư duy trước, sau đó thiết kế, và cuối cùng mới viết code".
1. Sức mạnh thực sự nằm ở chế độ "Sub-agent" (Tác nhân phụ)
Tại sao Superpowers lại hữu dụng hơn hẳn so với Claude mặc định? Bí mật nằm ở cơ chế Sub-agent.
Ở chế độ chat thông thường, Claude là một "chiến binh đơn độc" chịu trách nhiệm cho tất cả. Cuộc hội thoại càng dài, nó càng dễ quên ngữ cảnh trước đó và trở nên kém hiệu quả. Đây được gọi là sự "phân mảnh".
Nhưng khi cài đặt Superpowers, Claude sẽ tiến hóa thành "PM (Quản lý dự án) cực ngầu + Biệt đội thuê ngoài tinh nhuệ".
- Main Agent (PM): Có cái nhìn tổng quan, nắm giữ bản thiết kế và đưa ra chỉ thị. Tuyệt đối không trực tiếp động tay vào code.
- Sub-agent (Đội thực thi): Đối với từng tác vụ nhỏ như "viết module mã hóa", "tạo validation", nó sẽ triệu hồi các agent dùng một lần ngay tại chỗ.
- Tách biệt hoàn toàn: Các sub-agent này không hề biết về log lỗi của các tác vụ trước đó. Chúng làm việc ở trạng thái hoàn toàn mới và biến mất sau khi hoàn thành. Do đó, hiện tượng "ảo giác" (hallucination) rất khó xảy ra.
Người nghĩ ra cơ chế này thực sự là một thiên tài.
2. Thực chiến: Thử tạo một "Dịch vụ xác thực Email" nghiêm túc
Nói thì dễ. Tôi đã thử yêu cầu nó tạo một dịch vụ xác thực email bằng Python với các yêu cầu hơi phức tạp một chút.
Prompt: I want to develop an enterprise-grade 'email validation service' in Python. It needs to support RFC standards (including sub-addressing user+tag), Internationalized Domain Names (IDN), and perform DNS MX record checks to prevent invalid emails. Please design the architecture.
Step 1. Brainstorm: Không cho phép viết code ngay
Khi đưa ra yêu cầu, Superpowers sẽ tự động kích hoạt /brainstorm. Nó không trả lời kiểu "Ok, tôi viết code ngay đây!" đâu.
Nó sẽ hỏi ngược lại như một kiến trúc sư lão luyện: "Kịch bản sử dụng là gì?", "Mức độ xác minh DNS?", "Môi trường triển khai?". Sau khi trao đổi, khi bản vẽ thiết kế ASCII tuyệt đẹp được vẽ ra trên terminal, thú thật là tôi đã rùng mình.
Step 2. Write Plan: Cấu trúc dự án chuyên nghiệp
Khi thiết kế đã được chốt, Claude không đưa ra những "đoạn code rời rạc", mà đề xuất một cấu trúc dự án hoàn chỉnh. validators/ (logic), middleware/ (giới hạn), cache/ (tăng tốc)... Đây là "cấu trúc chuyên nghiệp" mà nếu con người tự nghĩ từ con số 0 sẽ mất vài tiếng đồng hồ. Superpowers định nghĩa các phần này là "tác vụ nguyên tử" (atomic tasks), giúp loại bỏ hoàn toàn sự do dự khi triển khai.
Step 3. Triển khai và TDD: Code có kỷ luật
Sau đó chỉ cần chạy /execute-plan. Superpowers rất coi trọng TDD (Phát triển hướng kiểm thử). Đầu tiên, nó chuẩn bị các "bài test thất bại" trong thư mục tests/, sau đó viết code để vượt qua các bài test đó.
Nó ngăn chặn tận gốc việc sản sinh ra những đoạn code rác kiểu AI thường thấy: "chạy thì chạy được đấy nhưng không có test nào cả".
3. API đó có thực sự "chuẩn Prof" không? Hoàn thiện với Apidog
Nhờ Superpowers, logic bản thân nó đã khá vững chắc. Nhưng để công khai như một dịch vụ, cần thêm một bước nữa. Đó là tiêu chuẩn hóa giao diện.
Đừng vội hài lòng chỉ vì nó chạy được ở local (cục bộ). Tôi thường trích xuất định nghĩa API từ code đã tạo và ném vào Apidog.
- Kiểm thử chấp nhận tự động: Sử dụng tính năng kiểm thử tự động của Apidog để quét sạch lỗi trong logic do AI viết. "Chạy được" và "chịu được vận hành thực tế" là hai chuyện khác nhau.
- Tạo tài liệu tức thì: Dù AI viết code tốt đến đâu mà tài liệu như rác thì chẳng ai dùng. Với Apidog, tài liệu API đẹp mắt sẽ được tự động tạo từ code. Chia sẻ cái này cho team, đảm bảo ai cũng phải thốt lên "Ồ, chỉn chu đấy".
- Phân chia trách nhiệm: Superpowers đảm bảo "tính chính xác của logic", còn Apidog đảm bảo "chất lượng dịch vụ". Sự kết hợp này là vô địch.
4. Cài đặt chỉ với 2 dòng lệnh
Nếu bạn đã có môi trường Claude Code, việc cài đặt chỉ mất một tích tắc.
-
Thêm Marketplace:
/plugin marketplace add obra/superpowers-marketplace -
Cài đặt:
/plugin install superpowers@superpowers-marketplace
Kiểm chứng: Gõ /sup, nếu thấy execute-plan, brainstorm hay write-plan hiện ra là OK.
Tổng kết: Dục tốc bất đạt
Xu hướng AI hiện nay chỉ đua nhau về "tốc độ tạo content". Nhưng Superpowers thì ngược lại. Nó bắt phải "nghĩ đi", "test đi", cố tình làm chậm tốc độ lại.
Nhưng kết quả thì sao? Không còn phải quay lại sửa lỗi (rework), tổng thời gian phát triển được rút ngắn đáng kể. Đó là chân lý của kỹ thuật phần mềm. "Chất lượng hơn số lượng". Không ngờ tôi lại được AI dạy cho điều đó.
All rights reserved
