Superpowers

1. Superpowers là gì?

Superpowers là một bộ "kỹ năng" (skill: các bản hướng dẫn quy trình viết thành văn bản) gắn thêm vào trợ lý lập trình AI như Claude Code, Codex, Cursor hay Gemini CLI. Sau khi cài, AI không lao vào viết code ngay nữa mà làm theo một quy trình cố định: hỏi rõ bạn muốn gì, viết thiết kế, chia việc thành kế hoạch nhỏ, viết kiểm thử trước rồi mới viết code, và tự rà soát trước khi báo xong.

Dự án do Jesse Vincent và nhóm Prime Radiant làm, mã nguồn mở theo giấy phép MIT, miễn phí. Bản mới nhất lúc viết bài là v7.0.1, phát hành ngày 21/10/2026.

Nói thẳng: đây là công cụ cho người đang dùng AI để viết phần mềm. Superpowers không phải ứng dụng riêng, không có cửa sổ để mở. Nó chỉ chạy bên trong một trợ lý lập trình AI mà bạn đã có.

Hợp với bạn nếu:

• Bạn đã dùng Claude Code, Codex, Cursor, Gemini CLI hoặc một trợ lý lập trình tương tự.
• AI hay hiểu sai ý bạn, viết một mạch rồi báo "xong" nhưng code chạy không được.
• Bạn muốn AI làm những việc dài (vài giờ) theo kế hoạch rõ ràng thay vì đoán từng bước.

Chưa hợp nếu:

• Bạn chưa dùng trợ lý lập trình AI nào. Hãy cài một công cụ như vậy trước.
• Bạn chỉ cần hỏi đáp nhanh vài câu. Quy trình hỏi kỹ và lập kế hoạch sẽ thấy thừa với việc rất nhỏ (dù Superpowers có tự rút gọn với việc nhỏ).
• Bạn cần tiết kiệm token tối đa. Chế độ chạy nhiều subagent (trợ lý con) tốn token hơn đáng kể.

2. Cần chuẩn bị gì?

• Một trợ lý lập trình AI đã cài và đăng nhập được. Superpowers hỗ trợ 16 nơi cài: Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Qwen Code, Hermes Agent và Muse. Tài khoản và chi phí là của công cụ đó, xem trang chính thức của từng công cụ.
• Một thư mục dự án, tốt nhất đã là kho Git (Git: phần mềm lưu lịch sử thay đổi code, tải ở https://git-scm.com). Superpowers dùng Git để tạo nhánh làm việc riêng cho mỗi tính năng.
• Không cần khóa API riêng cho Superpowers. Bản thân Superpowers không mất tiền.

Lưu ý: Nếu bạn dùng nhiều công cụ (ví dụ cả Claude Code và Cursor), phải cài Superpowers riêng cho từng công cụ.

3. Cài đặt từng bước

Chọn đúng mục ứng với công cụ bạn đang dùng. Ba cách đầu dễ nhất vì cài qua chợ plugin (plugin marketplace: nơi chọn và cài tiện ích trong công cụ).

Bước 1 (Claude Code): cài từ chợ plugin chính thức

Mở Claude Code trong thư mục dự án, gõ lệnh sau vào ô chat rồi Enter:

/plugin install superpowers@claude-plugins-official

Thấy gì là đúng: Claude Code báo đã cài plugin superpowers. Thoát Claude Code rồi mở lại để plugin được nạp.

Cách khác là dùng chợ riêng của Superpowers (có thêm vài plugin liên quan):

/plugin marketplace add obra/superpowers-marketplace

/plugin install superpowers@superpowers-marketplace

Bước 1 (Codex App): bấm cài trong mục Plugins

1. Trong ứng dụng Codex, bấm Plugins ở thanh bên trái.
2. Trong nhóm Coding, tìm Superpowers.
3. Bấm dấu + cạnh Superpowers và làm theo hướng dẫn trên màn hình.

Thấy gì là đúng: Superpowers hiện trong danh sách plugin đã cài.

Bước 1 (Cursor): cài từ marketplace

Trong khung chat Agent của Cursor, gõ:

/add-plugin superpowers

Hoặc mở chợ plugin của Cursor và tìm "superpowers".

Bước 1 (Codex CLI)

Gõ /plugins trong Codex CLI để mở giao diện tìm plugin, tìm superpowers, rồi chọn Install Plugin.

Bước 1 (Gemini CLI)

gemini extensions install https://github.com/obra/superpowers

Bước 1 (GitHub Copilot CLI)

copilot plugin marketplace add obra/superpowers-marketplace

copilot plugin install superpowers@superpowers-marketplace

Bước 1 (Antigravity)

agy plugin install https://github.com/obra/superpowers

Bước 1 (các công cụ khác)

• Devin CLI: devin plugins install obra/superpowers
• Qwen Code: qwen extensions install obra/superpowers, chọn superpowers khi được hỏi.
• Hermes Agent: hermes plugins install obra/superpowers --enable, rồi khởi động lại các phiên Hermes đang mở.
• Pi: pi install git:github.com/obra/superpowers
• OpenCode: nhắn cho OpenCode: "Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md". OpenCode V2 cần bản 2.0.4 trở lên.
• Factory Droid, Grok Build CLI, Kimi Code, Muse: xem mục cài tương ứng trong README chính thức: https://github.com/obra/superpowers

Bước 2: Mở một phiên mới

Sau khi cài, đóng phiên đang mở và bắt đầu một phiên mới. Superpowers nạp phần khởi động (bootstrap) lúc phiên bắt đầu, nên phiên cũ không nhận được.

Thấy gì là đúng: ở phiên mới, khi bạn nhờ làm một việc, AI nhắc tới việc dùng skill (ví dụ "brainstorming") thay vì viết code ngay.

4. Dùng lần đầu

Thử nhanh: nhờ làm một ứng dụng nhỏ

Tài liệu chính thức gợi ý câu thử này. Gõ vào phiên mới:

Let's make a react todo list

Bạn cũng có thể viết bằng tiếng Việt, ví dụ "Làm cho mình một ứng dụng danh sách việc cần làm bằng React".

Thấy gì là đúng: AI chưa viết code. Skill brainstorming tự bật lên, AI đọc dự án hiện có rồi hỏi bạn những điều còn chưa rõ, mỗi lần một ý, và nhắc lại cách nó hiểu để bạn sửa.

Quy trình bạn sẽ đi qua

1. Brainstorming: trả lời câu hỏi. AI đưa ra 2–3 hướng làm, đề xuất một hướng và chờ bạn chọn. Việc nhỏ thì chốt trong chat; dự án lớn thì AI viết tài liệu thiết kế và không làm gì cho tới khi bạn duyệt.
2. Tạo nhánh làm việc riêng: AI tạo worktree (một bản sao thư mục dự án trên nhánh Git mới) và chạy kiểm thử để chắc nền đang sạch.
3. Viết kế hoạch: công việc được chia thành các task 2–5 phút, mỗi task ghi rõ file nào, code gì, kiểm tra thế nào.
4. Thực hiện: bạn chọn một trong hai chế độ. subagent-driven-development giao mỗi task cho một trợ lý con mới và rà soát sau mỗi task (kỹ nhất). executing-plans làm hết trong phiên hiện tại và rà soát một lần ở cuối (rẻ nhất).
5. Kiểm thử trước (TDD): AI viết bài kiểm thử, thấy nó thất bại, viết code tối thiểu cho nó qua, rồi lưu lại.
6. Kết thúc nhánh: AI chạy lại kiểm thử và hỏi bạn muốn gộp, mở Pull Request, giữ lại hay bỏ nhánh.

Lưu ý: Hãy đọc kỹ thiết kế và kế hoạch trước khi bảo AI chạy. Đây là chỗ bạn kiểm soát được kết quả.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Cài xong nhưng AI vẫn viết code ngay, không hỏi gì	Phiên đang mở được tạo trước khi cài, chưa nạp phần khởi động	Thoát hẳn công cụ, mở phiên mới rồi thử lại câu ở mục 4
Skill không bật ở công cụ thứ hai	Mỗi công cụ cần cài riêng	Cài lại theo đúng mục của công cụ đó ở phần 3
Phiên rất dài thì skill ngừng bật (Hermes Agent)	Hermes không có hook sau khi nén hội thoại, phần khởi động bị mất	Bắt đầu một phiên mới
Trên Windows, hook không chạy hoặc lỗi đường dẫn Git Bash	Lỗi đã được sửa trong v7.0.0	Cập nhật lên bản mới nhất (mục 6)
AI bỏ qua kế hoạch, lặp việc hoặc tốn token bất thường	Skill bật sai lúc hoặc phiên gặp sự cố	Nhắn "figure out what went wrong with superpowers in this session" để skill diagnosing-superpowers đọc lại phiên và chỉ ra chỗ sai
Tốn token nhiều hơn mong đợi	Đang dùng chế độ subagent cho mọi task	Khi được hỏi chế độ thực hiện, chọn executing-plans

Nếu vẫn lỗi, xem hoặc báo lỗi tại https://github.com/obra/superpowers/issues . Nhóm phát triển không nhận Pull Request do AI viết để sửa lỗi người khác đã báo; hãy bổ sung thông tin vào issue có sẵn.

6. Gỡ cài đặt / cập nhật

Cập nhật: tài liệu ghi việc cập nhật tùy công cụ và thường diễn ra tự động. Một số công cụ có lệnh riêng:

gemini extensions update superpowers

devin plugins update superpowers

qwen extensions update superpowers

Với Antigravity, chạy lại đúng lệnh cài để cập nhật. Với Claude Code, Codex và Cursor, dùng trình quản lý plugin của chính công cụ đó.

Gỡ cài đặt: mở trình quản lý plugin hoặc extension của công cụ bạn dùng (ví dụ /plugin trong Claude Code), chọn Superpowers rồi gỡ hoặc tắt. Mở phiên mới để chắc chắn skill không còn được nạp.

7. Câu hỏi hay gặp

Có mất tiền không? Superpowers miễn phí (giấy phép MIT). Bạn chỉ trả chi phí của trợ lý AI đang dùng. Quy trình nhiều bước và chế độ subagent làm tốn token hơn so với nhờ AI viết thẳng.

Có gửi dữ liệu của tôi đi đâu không? Theo tài liệu, tính năng tùy chọn "visual companion" trong brainstorming tải logo từ trang của Prime Radiant kèm số phiên bản Superpowers, không kèm nội dung dự án hay câu lệnh của bạn. Muốn tắt, đặt biến môi trường SUPERPOWERS_DISABLE_TELEMETRY thành một giá trị đúng (ví dụ 1). Superpowers cũng tôn trọng DISABLE_TELEMETRY và CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC của Claude Code.

Tôi không biết lập trình thì có dùng được không? Superpowers giúp AI làm việc có quy trình hơn, nhưng bạn vẫn cần đọc và duyệt thiết kế, kế hoạch. Nó phù hợp nhất với người đã quen dùng trợ lý lập trình AI.

Việc nhỏ có bị hỏi han rườm rà không? Từ v7.0.0, brainstorming tự đánh giá độ lớn công việc: việc nhanh và rõ thì làm luôn, việc nhỏ chốt trong chat, dự án mới viết tài liệu thiết kế. Bạn có thể yêu cầu nó làm khác.

Doanh nghiệp có hỗ trợ không? Prime Radiant có dịch vụ thương mại cho doanh nghiệp, liên hệ qua địa chỉ ghi trong README chính thức.