# Superpowers: quy trình lập trình có kỷ luật cho AI coding agent — hướng dẫn cài đặt và dùng

> Superpowers là bộ skill kèm quy trình phát triển phần mềm hoàn chỉnh cho các coding agent như Claude Code, Codex, Cursor, Gemini CLI. Nó giúp agent hỏi rõ yêu cầu, lập kế hoạch, viết test trước rồi mới code, thay vì lao vào viết ngay. Cài khá dễ: thường chỉ một hai lệnh trong chính công cụ bạn đang dùng.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-04 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/superpowers-quy-trinh-lap-trinh-cho-ai-coding-agent

Superpowers là một bộ skill (kỹ năng) kèm phương pháp làm phần mềm cho các AI coding agent. Cài vào xong, agent của bạn không lao vào viết code ngay khi nghe yêu cầu nữa. Nó dừng lại, hỏi bạn thật sự muốn gì, viết thiết kế, lập kế hoạch, rồi mới làm theo từng việc nhỏ có kiểm tra.

Repo này hợp với ba nhóm người. Thứ nhất là lập trình viên mới, hay bị agent viết một đống code rồi không biết đúng hay sai. Thứ hai là người làm kinh doanh, văn phòng, tự nhờ AI dựng công cụ nhỏ cho công việc của mình. Thứ ba là dev lâu năm muốn agent làm việc có quy trình, có test, có review. Hiện repo có khoảng 316.822 sao và 28.189 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất: các skill tự kích hoạt. Bạn không cần nhớ lệnh nào hay gõ thần chú gì. README nói agent sẽ kiểm tra skill phù hợp trước mỗi việc, và đây là quy trình bắt buộc chứ không phải gợi ý. Có khi agent tự làm liền mạch cả vài giờ mà không lệch khỏi kế hoạch bạn đã duyệt.

```repo
- repo | obra/superpowers
- kind | Skill
- desc | Bộ skill và phương pháp làm phần mềm cho AI coding agent: hỏi kỹ, lập kế hoạch, viết test trước, giao subagent làm từng việc và review.
- stars | 317k
- lang | Shell
- license | MIT
```

## Superpowers làm được gì

Tác giả mô tả repo là một «agentic skills framework» và phương pháp phát triển phần mềm. Cụ thể, nó gồm các skill chia theo nhóm.

### Hỏi cho rõ trước khi làm

Skill **brainstorming** chạy trước khi xây bất cứ thứ gì. Nó đặt câu hỏi để bạn tả lại điều mình muốn và lý do, rồi nhắc lại cách nó hiểu để bạn sửa. Việc nhỏ thì chốt ngay trong khung chat. Dự án lớn thì có tài liệu thiết kế viết ra giấy. Lợi ích thực tế: bạn đỡ phải bỏ đi một sản phẩm làm xong mới thấy sai ý.

### Lập kế hoạch dễ theo

Skill **writing-plans** chia việc thành các task nhỏ, mỗi task chừng 2-5 phút. Mỗi task có đường dẫn file cụ thể, code đầy đủ và bước kiểm tra. README ví von kế hoạch phải rõ đến mức một kỹ sư trẻ nhiệt tình nhưng không có ngữ cảnh vẫn làm theo được. Nhờ vậy agent ít tự suy diễn.

### Làm từng việc, có người soát lại

Skill **subagent-driven-development** giao mỗi task cho một subagent mới, kiểm tra sau mỗi task theo hai lớp: đúng yêu cầu chưa, rồi chất lượng code ra sao. Nếu muốn rẻ hơn, **executing-plans** làm tất cả trong một phiên và review toàn nhánh một lần ở cuối. Bạn chọn giữa kỹ nhất và tiết kiệm nhất.

### Test trước, code sau

Skill **test-driven-development** ép vòng RED-GREEN-REFACTOR: viết test, xem nó fail, viết code tối thiểu, xem nó pass, rồi commit. README ghi rõ code viết trước test sẽ bị xoá. Với người mới, đây là lưới an toàn: có test thì biết ngay agent làm hỏng gì.

### Sửa lỗi có phương pháp

**systematic-debugging** đi theo quy trình 4 giai đoạn để tìm nguyên nhân gốc, thay vì đoán mò. **verification-before-completion** buộc agent kiểm chứng là đã sửa xong thật, không chỉ tuyên bố. Ngoài ra còn **diagnosing-superpowers**: khi phiên làm việc đi sai, bạn nhờ agent tìm hiểu chuyện gì đã xảy ra, nó đọc bản ghi phiên và báo lại kèm bằng chứng.

### Làm việc song song và quản lý nhánh

**using-git-worktrees** tạo không gian làm việc tách biệt trên nhánh mới. **dispatching-parallel-agents** chạy nhiều subagent cùng lúc. **requesting-code-review** và **receiving-code-review** lo chuyện nhờ review và phản hồi review. **finishing-a-development-branch** kiểm tra test rồi cho bạn chọn: merge, tạo PR, giữ lại hoặc bỏ.

## Cần chuẩn bị gì

Superpowers không chạy một mình. Nó là plugin cho một coding agent, nên bạn cần có sẵn một trong các công cụ README liệt kê: Claude Code, Antigravity, Codex (app hoặc CLI), Cursor, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Qwen Code, Hermes Agent hoặc Muse.

Về phiên bản Node, Python, hệ điều hành, phần cứng hay API key, README **chưa nói gì**. Bạn chỉ cần tài khoản và quyền dùng chính công cụ agent mình chọn, theo quy định của công cụ đó. Repo có file package.json (tên gói npm là superpowers) và thư mục .claude-plugin, nhưng README không yêu cầu bạn tự chạy npm.

Một điều README nhấn mạnh: cách cài khác nhau theo từng agent. Nếu bạn dùng nhiều agent, phải cài riêng cho từng cái.

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

```steps
- Chọn agent | Xác định bạn đang dùng Claude Code, Codex, Cursor, Gemini CLI hay công cụ khác
- Mở đúng chỗ gõ lệnh | Lệnh bắt đầu bằng dấu / gõ trong khung chat của agent, lệnh khác gõ trong terminal
- Chạy lệnh cài | Dùng đúng lệnh cho agent của bạn ở các mục bên dưới
- Khởi động lại phiên | Mở phiên mới để bộ skill được nạp
- Thử một yêu cầu nhỏ | Xem agent có hỏi lại trước khi viết code không
```

Dưới đây là các lệnh đúng như README, chia theo công cụ. Bạn chỉ cần làm mục của công cụ mình dùng.

### Claude Code

Cách đơn giản nhất là cài từ marketplace chính thức của Anthropic. Gõ lệnh này **trong khung chat của Claude Code**, không phải trong PowerShell hay Terminal thường:

```bash
/plugin install superpowers@claude-plugins-official
```

Nếu muốn dùng marketplace riêng của Superpowers (có thêm vài plugin liên quan), đăng ký marketplace rồi cài:

```bash
/plugin marketplace add obra/superpowers-marketplace
```

```bash
/plugin install superpowers@superpowers-marketplace
```

### Gemini CLI

Mở terminal, gõ lệnh cài extension. Muốn cập nhật sau này thì dùng lệnh thứ hai:

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

```bash
gemini extensions update superpowers
```

### Codex App và Codex CLI

Với Codex App, bạn không cần gõ lệnh. Bấm Plugins ở thanh bên, tìm Superpowers trong mục Coding, bấm dấu `+` cạnh nó rồi làm theo hướng dẫn.

Với Codex CLI, mở giao diện tìm plugin, tìm tên rồi chọn Install Plugin:

```bash
/plugins
```

```bash
superpowers
```

### Cursor

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

```text
/add-plugin superpowers
```

Hoặc tìm chữ superpowers trong marketplace plugin của Cursor.

### GitHub Copilot CLI

Đăng ký marketplace rồi cài plugin:

```bash
copilot plugin marketplace add obra/superpowers-marketplace
```

```bash
copilot plugin install superpowers@superpowers-marketplace
```

### Các công cụ khác

Nếu bạn dùng công cụ khác, README có lệnh riêng. Chép đúng như sau:

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

```bash
devin plugins install obra/superpowers
```

```bash
droid plugin marketplace add https://github.com/obra/superpowers
droid plugin install superpowers@superpowers
```

```bash
grok plugin install superpowers@xai-official --trust
```

```bash
pi install git:github.com/obra/superpowers
```

```bash
qwen extensions install obra/superpowers
```

```bash
hermes plugins install obra/superpowers --enable
```

Lần lượt là: Antigravity, Devin CLI, Factory Droid, Grok Build CLI, Pi, Qwen Code, Hermes Agent. Riêng Qwen Code, README dặn chọn `superpowers` khi được hỏi. Với Kimi Code, gõ `/plugins` rồi vào Marketplace > Superpowers, hoặc cài thẳng bằng `/plugins install https://github.com/obra/superpowers`. Chi tiết xem docs/README.kimi.md trong repo.

Với OpenCode, bạn nói với chính OpenCode câu sau (README ghi cách này, chi tiết ở docs/README.opencode.md):

```text
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
```

Với Muse, nếu cài từ bản tải về máy:

```bash
git clone https://github.com/obra/superpowers.git
muse plugins install ./superpowers
muse plugins approve superpowers
```

Lệnh `git clone` tải mã nguồn về một thư mục tên superpowers ngay tại nơi bạn đang đứng trong terminal. Lệnh thứ hai cài từ thư mục đó, lệnh thứ ba duyệt plugin. Bước duyệt này dễ bị quên: README nói hook cần được duyệt ở lần cài đầu.

```note
Khi cài plugin, bạn đang cho agent nạp thêm chỉ dẫn và hook chạy cùng phiên làm việc. Hãy cài từ marketplace chính thức hoặc từ đúng địa chỉ obra/superpowers như README ghi, và để ý agent của bạn hỏi quyền gì khi cài.
```

Cập nhật: README chỉ nói việc cập nhật phụ thuộc vào từng coding agent và thường tự động. Một số công cụ (Gemini CLI, Devin CLI, Qwen Code, Muse, Antigravity) có lệnh cập nhật riêng như đã nêu ở trên.

## Kiểm tra đã chạy được chưa

Cách thử mà README gợi ý (ở phần Muse, nhưng áp dụng được cho ý tưởng chung): mở một phiên mới và gửi câu sau.

```text
Let's make a react todo list
```

Nếu cài đúng, skill **brainstorming** sẽ tự kích hoạt **trước khi** có bất kỳ dòng code nào được viết. Tức là agent hỏi lại bạn về ý định, thay vì xuất ngay một ứng dụng. Nếu agent lao vào code luôn, có thể bạn chưa khởi động lại phiên, chưa duyệt plugin (với Muse) hoặc cài nhầm cho công cụ khác.

Với Pi và Hermes, README cho biết skill `using-superpowers` được nạp khi bắt đầu phiên. Với Hermes, nếu một phiên rất dài bị nén lại và skill ngừng kích hoạt, hãy mở phiên mới.

## Dùng vào việc thật

Phần này là ví dụ minh hoạ dựa trên khả năng README mô tả. Bạn không cần gõ tên skill, chỉ cần nói việc cần làm bằng ngôn ngữ thường.

### Chủ shop nhờ làm công cụ nhỏ

Bạn bán hàng online, muốn một trang nhỏ tính giá sỉ theo số lượng. Bạn nói với agent: «Mình cần một công cụ tính giá sỉ cho shop». Thay vì code ngay, agent sẽ hỏi: bán sản phẩm gì, mốc số lượng nào, ai dùng, làm trên điện thoại hay máy tính. Sau đó nó đưa thiết kế theo từng đoạn ngắn đủ để bạn đọc. Bạn duyệt xong mới đến bước làm. Kết quả: thứ làm ra đúng ý hơn, và bạn hiểu mình sắp nhận được gì.

> Cái hay nhất của Superpowers là nó bắt AI hỏi trước, làm sau.
>
> — Ông T

### Nhân viên văn phòng tự động hoá việc lặp lại

Bạn muốn một đoạn script gộp nhiều file báo cáo hằng tuần. Bạn mô tả việc, agent hỏi lại về định dạng file đầu vào và đầu ra, rồi viết kế hoạch gồm các task nhỏ. Khi bạn nói «làm đi», nó thực hiện từng task, có test kèm theo. Kết quả: bạn nhận script đã được kiểm tra từng phần, và nếu hỏng ở đâu, test chỉ ra chỗ đó.

### Lập trình viên mới thêm tính năng vào dự án có sẵn

Bạn có một dự án và muốn thêm trang đăng nhập. Agent dùng **using-git-worktrees** tạo nhánh làm việc riêng, kiểm tra bộ test hiện tại đang xanh, rồi mới làm từng task theo kế hoạch. Giữa các task nó tự review theo kế hoạch và báo lỗi theo mức độ nghiêm trọng; lỗi nghiêm trọng chặn tiến trình. Cuối cùng **finishing-a-development-branch** cho bạn chọn merge, tạo PR, giữ hoặc bỏ. Kết quả: code của agent nằm trên nhánh riêng, không làm rối nhánh chính.

### Sửa một lỗi cứng đầu

Bạn gặp lỗi mà sửa mãi không hết. Bạn mô tả triệu chứng, agent đi theo **systematic-debugging**: tìm nguyên nhân gốc theo các giai đoạn, rồi **verification-before-completion** buộc nó chứng minh lỗi đã hết. Nếu cả phiên làm việc có vẻ lạc đường, bạn nói: «figure out what went wrong with superpowers in this session». Agent sẽ dùng skill chẩn đoán, đọc bản ghi phiên và báo lại kèm bằng chứng.

## Lỗi hay gặp và cách xử lý

### Cài xong mà agent vẫn lao vào code ngay

Thường do phiên cũ chưa được nạp lại. Khởi động lại agent hoặc mở phiên mới, rồi thử lại câu kiểm tra ở trên. Với Muse, nhớ chạy bước `muse plugins approve superpowers`. Với Hermes, README dặn khởi động lại mọi phiên đang chạy sau khi cài.

### Gõ lệnh `/plugin ...` trong terminal báo lỗi không nhận lệnh

Lệnh bắt đầu bằng dấu `/` là lệnh trong khung chat của agent (Claude Code, Codex, Cursor, Kimi Code), không phải lệnh của PowerShell hay Terminal. Hãy mở agent trước, rồi gõ lệnh vào đó. Ngược lại, các lệnh như `gemini extensions install` hay `qwen extensions install` thì gõ trong terminal thường.

### Cài cho một agent nhưng dùng agent khác

README nói rõ phải cài riêng cho từng công cụ. Nếu bạn cài vào Claude Code mà lại mở Cursor, skill sẽ không có ở đó. Hãy cài lại bằng lệnh của đúng công cụ.

### Phiên rất dài, skill ngừng kích hoạt

README nêu trường hợp này với Hermes: phiên bị nén lại có thể làm mất phần khởi tạo ban đầu. Cách xử lý an toàn là mở một phiên mới. Nếu bạn nghi skill kích hoạt sai, im lặng hoặc agent bỏ qua kế hoạch, dùng skill chẩn đoán như đã nói ở trên.

### Tốn nhiều token hơn dự kiến

Quy trình đầy đủ, nhất là chế độ subagent cho mỗi task, chạy nhiều bước và nhiều lần review nên tốn nhiều hơn. README mô tả executing-plans là cách rẻ nhất, subagent-driven-development là kỹ nhất. Việc nhỏ thì bạn có thể chọn cách nhẹ. Chi phí cụ thể phụ thuộc gói và cách tính tiền của agent bạn dùng, README chưa có số liệu.

## Có nên dùng không

**Điểm mạnh:** Superpowers biến agent từ kiểu «viết ngay» thành kiểu «hỏi, lên kế hoạch, kiểm tra». Nó dùng được trên rất nhiều công cụ, giấy phép MIT, và triết lý rõ: test trước, quy trình hơn đoán mò, giảm độ phức tạp, bằng chứng hơn lời tuyên bố.

**Giới hạn:** Quy trình khá nghiêm. Nếu bạn chỉ cần sửa một dòng hay hỏi một câu nhanh, các bước hỏi han và kế hoạch có thể thừa. Bộ skill cũng không thay được việc bạn đọc và duyệt thiết kế, đó là phần tác giả dành cho con người. Về đóng góp, README nói nhóm tác giả nhìn chung không nhận skill mới, và mọi thay đổi skill phải chạy được trên tất cả agent được hỗ trợ.

**Về dữ liệu:** README có phần «Visual companion telemetry». Mặc định, logo Prime Radiant trong tính năng tuỳ chọn visual companion của brainstorming được tải từ website của họ, kèm phiên bản Superpowers đang dùng. README khẳng định không gửi chi tiết dự án, prompt hay agent của bạn. Muốn tắt, đặt biến môi trường `SUPERPOWERS_DISABLE_TELEMETRY` thành giá trị đúng. Nó cũng tôn trọng `DISABLE_TELEMETRY` và `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` của Claude Code.

**Khi nào chọn cách khác:** nếu bạn chỉ làm việc vặt, hoặc muốn agent tự do hơn, hãy dùng agent không kèm quy trình. Nếu cần hỗ trợ thương mại cho doanh nghiệp, README có nêu một địa chỉ liên hệ bán hàng của nhóm tác giả. Còn nếu bạn muốn AI làm phần mềm có kỷ luật như một đồng nghiệp cẩn thận, Superpowers là lựa chọn rất đáng thử.

## Câu hỏi thường gặp

### Superpowers có miễn phí không?

Repo dùng giấy phép MIT, nên mã nguồn dùng tự do. Tuy nhiên bạn vẫn cần có coding agent như Claude Code hay Codex, và chi phí của các công cụ đó thuộc về gói của bạn. README có nhắc đến dịch vụ thương mại cho doanh nghiệp nhưng chưa nêu giá.

### Superpowers chạy với những công cụ nào?

README liệt kê Claude Code, Antigravity, Codex App và CLI, Cursor, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Qwen Code, Hermes Agent và Muse. Mỗi công cụ có cách cài riêng, và nếu dùng nhiều công cụ thì phải cài riêng cho từng cái.

### Có cần GPU hay máy mạnh không?

README không nêu yêu cầu phần cứng nào. Bản thân Superpowers là bộ skill và chỉ dẫn cho agent, nên yêu cầu máy chủ yếu phụ thuộc vào công cụ agent bạn đang dùng.

### Chạy được trên Windows không?

README không ghi rõ hệ điều hành nào được hỗ trợ hay không. Các lệnh cài là lệnh của từng agent, nên việc có chạy trên Windows hay không phụ thuộc vào chính agent đó. Hãy xem hướng dẫn của công cụ bạn chọn.

### Superpowers có gửi dữ liệu dự án của tôi đi đâu không?

README nói có một khoản telemetry tuỳ chọn: logo trong tính năng visual companion tải từ website của tác giả, kèm số phiên bản. Họ khẳng định không gửi chi tiết dự án, prompt hay tên agent, và bạn có thể tắt bằng biến môi trường SUPERPOWERS_DISABLE_TELEMETRY. Các chuyện khác về dữ liệu còn tuỳ vào agent bạn dùng, README chưa có thông tin.

### Tôi phải gõ lệnh để gọi skill không?

Không cần. README nhấn mạnh các skill kích hoạt tự động, agent sẽ kiểm tra skill phù hợp trước mỗi việc. Bạn chỉ cần mô tả việc cần làm, ví dụ nói muốn làm một ứng dụng, thì skill brainstorming sẽ chạy trước.

### Khi agent làm sai hoặc bỏ qua kế hoạch thì làm sao?

README hướng dẫn nhờ agent «figure out what went wrong with superpowers in this session». Skill diagnosing-superpowers sẽ đọc bản ghi phiên, báo lại kèm bằng chứng theo dòng, và nếu bạn muốn thì đóng gói một bản đã lược thông tin nhạy cảm để gửi báo lỗi.
