Superpowers của obra là gì và dùng sao để code với AI tốt hơn

Thay vì để AI "tự tung tự tác", framework này ép agent vào một bộ khung quy trình nghiêm ngặt: dừng lại để nghĩ, lập kế hoạch rồi mới thực thi.

Vấn đề lớn nhất của các công cụ AI coding hiện nay là chúng quá "yolo" và thiếu kỷ luật. Agent thường nhảy ngay vào viết code trước khi thực sự hiểu bạn muốn gì, hoặc sửa triệu chứng thay vì tìm gốc rễ. Superpowers giải quyết bài toán này bằng cách cung cấp một bộ 14 kỹ năng định hình hành vi, ép AI phải tuân thủ các quy tắc kỹ thuật khắt khe như TDD và nghiên cứu nguyên nhân gốc rễ (root cause investigation).

Superpowers là gì và vì sao nó khác biệt?

Superpowers được Jesse Vincent phát triển và đạt mốc hơn 257.000 star trên GitHub chỉ trong thời gian ngắn. Đây không phải là một SDK phức tạp hay một mô hình ngôn ngữ mới. Bản chất của nó là một bộ 14 kỹ năng (định dạng .md) được thiết kế để thay đổi cách AI tiếp cận công việc. Thay vì để AI vội vàng phản hồi, framework này buộc nó phải "dừng lại và suy nghĩ" trước mọi yêu cầu.

Sự khác biệt nằm ở triết lý: AI không thiếu thông minh, nó thiếu kỷ luật. Superpowers đóng vai trò như một kỹ sư trưởng khó tính, ép agent phải đặt câu hỏi kiểu Socrates để làm rõ yêu cầu, lập kế hoạch chi tiết và chỉ được viết code sau khi đã có test. Bạn không còn phải đi săn các "prompt thần thánh" nữa, bạn đang trang bị (equipping) cho AI một phương pháp làm việc có hệ thống, giúp giảm thiểu tình trạng AI viết hàng nghìn dòng code "nhìn có vẻ đúng" nhưng thực tế lại giải quyết sai vấn đề.

Cách Superpowers hoạt động: kỹ năng và progressive disclosure

Mỗi kỹ năng (skill) trong Superpowers là một file Markdown chứa tên, mô tả ngắn và các bước thực thi chi tiết. Một số kỹ năng thậm chí sử dụng sơ đồ Graphviz DOT để mô tả workflow, giúp AI hiểu quy trình logic một cách trực quan. Framework sử dụng session-start hook để nạp một tài liệu bootstrap (dưới 2.000 token). Bootstrap này dạy AI rằng nó đang sở hữu các kỹ năng và phải tìm kiếm chúng trước khi hành động.

Điểm đắt giá về mặt kỹ thuật là cơ chế "progressive disclosure" (tiết lộ dần dần). Để tiết kiệm context window, agent không đọc hết 14 file kỹ năng cùng lúc. Thay vào đó, nó chạy một shell script để tìm kiếm kỹ năng phù hợp dựa trên tiêu đề và mô tả. Chỉ khi thực sự cần thực hiện một tác vụ cụ thể (như gỡ lỗi), agent mới nạp toàn bộ hướng dẫn từ file .md tương ứng. Cách này giúp giữ cho phiên làm việc luôn tinh gọn nhưng vẫn đảm bảo agent có đủ "know-how" khi cần thiết.

14 kỹ năng trong bộ Superpowers

Toàn bộ framework chỉ gồm 14 file SKILL.md, mỗi file là một kỹ năng agent nạp khi cần. Dưới đây là danh sách đầy đủ, nhóm theo vai trò trong quy trình:

Vì mỗi kỹ năng chỉ là văn bản Markdown, bạn mở ra đọc được, sửa lại theo chuẩn của nhóm mình, hay bỏ bớt cái không cần. Các kỹ năng này ăn khớp thành một quy trình khép kín — phần tiếp theo đi qua đúng trình tự đó.

Quy trình làm việc: từ brainstorm đến verify

Làm việc với Superpowers là tuân theo một chu kỳ khắt khe: Brainstorming (làm rõ yêu cầu) → Viết kế hoạch (chia nhỏ task thành các đoạn 2-5 phút) → Thực thi bằng subagent → TDD → Review → Verify. Framework này áp dụng các "Luật sắt" (Iron Laws) không thể thương lượng. Ví dụ, trong TDD, luật là: NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST. Nếu AI lỡ viết code trước khi có test, framework sẽ yêu cầu xóa sạch chỗ code đó để làm lại đúng quy trình.

Trong quá trình gỡ lỗi (systematic-debugging), luật sắt là: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. AI phải chạy qua 4 giai đoạn: điều tra nguyên nhân gốc, phân tích pattern, kiểm tra giả thuyết và cuối cùng mới là thực thi fix. Đặc biệt, framework có cơ chế "stop sign": nếu sau 3 lần thử mà không fix được, AI bắt buộc phải dừng lại để thực hiện review kiến trúc (architectural review) thay vì tiếp tục vá víu lung tung. Sự khắt khe này giúp bạn tránh được những lỗi sơ đẳng mà AI thường mắc phải khi làm việc tự do.

Cài đặt và phiên làm việc đầu tiên

Bạn có thể trang bị Superpowers cho Claude Code trực tiếp qua marketplace hoặc cài bản dev từ GitHub. Framework này cũng hỗ trợ đa nền tảng như Cursor, Codex, hay OpenCode:

# Cài đặt qua Claude marketplace
/plugin install superpowers
 
# Hoặc cài đặt thủ công cho các harness khác
git clone https://github.com/obra/superpowers.git
claude plugin add ./superpowers

Sau khi cài đặt, bạn sẽ thấy phong cách của AI thay đổi hẳn. Thay vì vồ vập viết code, nó sẽ bắt đầu bằng những câu hỏi làm rõ về kiến trúc và yêu cầu. Bạn đang chuyển từ việc "prompt" (ra lệnh) sang "equipping" (trang bị công cụ). AI lúc này đã có ý thức về quy trình và sẽ từ chối làm việc nếu kế hoạch chưa được bạn phê duyệt hoặc thiếu bằng chứng xác minh thực tế.

Superpowers 6 có gì mới?

Bản v6 là một bước tiến lớn về hiệu suất, nhờ được mô hình Fable tối ưu hóa. Các con số thống kê thực tế cho thấy tốc độ build nhanh hơn 50% và tiết kiệm tới 60% chi phí token so với các bản cũ. Điều này giải quyết đúng nỗi lo lớn nhất của người dùng: quy trình càng khắt khe thường càng tốn kém tài nguyên.

Về kỹ thuật, Fable đã tối ưu hóa luồng bằng cách gộp hai bước review (tuân thủ spec và chất lượng code) thành một luồng xử lý thông minh hơn. Ngoài ra, thay vì bắt agent chạy hàng loạt lệnh git lẻ tẻ để kiểm tra code, Superpowers 6 sử dụng shell script để tiền tạo (pre-generate) một "review package" chứa đầy đủ diff (so sánh mã cũ và mới) đã định dạng và metadata. Điều này giúp các subagent reviewer nắm bắt vấn đề ngay lập tức, giảm thiểu đáng kể số lần truy vấn hệ thống và tiết kiệm token context.

Khi nào nên dùng, khi nào nên bỏ qua?

Đừng dùng Superpowers cho mọi thứ. Đây là bộ khung quy trình cho các project lớn, phức tạp, yêu cầu bảo trì lâu dài và độ phủ test cao. Nó giúp bạn quản lý các task kéo dài hàng giờ mà không bị lạc hướng. Nếu bạn đang refactor một module core hay xây dựng tính năng SaaS mới, sự kỷ luật này chính là thứ giúp bạn tránh technical debt (nợ kỹ thuật).

Ngược lại, nó sẽ là "overkill" (quá mức cần thiết) cho các script ngắn 20 dòng, các lỗi hiển nhiên hoặc khi bạn chỉ muốn prototype nhanh. Việc ép AI phải brainstorm và lập kế hoạch cho một task 5 phút sẽ gây ra chi phí chìm (sunk cost) về cả thời gian lẫn token. Bạn cần biết khi nào nên bảo agent "quick task, skip planning" để tận dụng tốc độ của AI khi độ rủi ro thấp.

Đầu tư vào kỷ luật thay vì chỉ tìm prompt

Nhiều người vẫn mải mê tìm kiếm các "phép thuật" từ prompt, nhưng thực tế kỷ luật mới là thứ tạo ra sản phẩm chất lượng. Superpowers biến AI từ một chatbot thành một cộng sự kỹ thuật có nguyên tắc. Khi AI biết dừng lại để hỏi, biết viết test trước khi code, và biết lùi lại một bước khi gặp bế tắc, đó là lúc bạn thực sự khai thác được sức mạnh của nó.

Lợi thế của bạn khi đó không nằm ở việc nhớ được prompt nào, mà ở chỗ sở hữu một bộ thư viện kỹ năng (skills library) riêng, được tinh chỉnh theo chuẩn mực của bạn hoặc đội ngũ của bạn. Với những dự án cần bảo trì lâu dài, đầu tư vào quy trình và kỷ luật thường đáng giá hơn nhiều so với việc đi săn prompt.

Tài liệu tham khảo

• GitHub - obra/superpowers: An agentic skills framework & software development methodology that works
• Superpowers: How I'm using coding agents in October 2025 — Jesse Vincent
• Superpowers 6 — Massively Parallel Procrastination
• Superpowers — Simon Willison
• Superpowers: The Claude Code Skills Framework Shipped as Markdown — Marc Nuri
• Claude Code Superpowers: Structured AI Development Plugin — DataCamp
• Superpowers Plugin Claude Code: An Honest Review — Mejba Ahmed
• Claude Skills, Explained: The 200K-Star Repo Everyone's Installing (Superpowers) — YouTube