obra/superpowers: nâng cấp coding agent — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về obra/superpowers — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: obra/superpowers: Chuẩn hóa quy trình lập trình cho AI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
obra/superpowers là framework phương pháp phát triển phần mềm dành cho coding agent, kết hợp các kỹ năng có thể dùng lại với quy trình bắt buộc. Nó giúp agent hỏi rõ yêu cầu, lập kế hoạch, làm việc qua subagent và kiểm tra trước khi báo hoàn tất. Cài đặt không quá khó nhưng phụ thuộc vào harness như Claude Code, Codex, Cursor, Gemini CLI hoặc các công cụ được hỗ trợ.
obra/superpowers là một framework kỹ năng giúp coding agent phát triển phần mềm theo quy trình rõ ràng, thay vì vừa nhận yêu cầu đã viết code ngay. Nó bắt đầu bằng việc làm rõ mục tiêu, thống nhất thiết kế, lập kế hoạch rồi mới triển khai và kiểm tra.
Repo phù hợp với lập trình viên, nhóm kỹ thuật và người mới dùng coding agent nhưng muốn kết quả có cấu trúc hơn. Điểm đáng giá nhất là các kỹ năng tự kích hoạt theo từng giai đoạn: brainstorming, worktree, lập kế hoạch, TDD, review và hoàn tất nhánh phát triển. Repo hiện có khoảng 317048 sao và 28223 fork, dùng giấy phép MIT.
Superpowers hỗ trợ nhiều harness khác nhau. Bạn cài riêng cho từng công cụ nếu sử dụng nhiều coding agent. Repo vẫn được cập nhật và phần lõi được viết chủ yếu bằng Shell, nhưng cách cài đặt phụ thuộc vào ứng dụng hoặc CLI bạn đang dùng.
obra/superpowers
Framework kỹ năng giúp coding agent làm rõ yêu cầu, lập kế hoạch, viết test, review và triển khai phần mềm có quy trình.
I.Superpowers làm được gì
Làm rõ yêu cầu trước khi viết code. Kỹ năng brainstorming hỏi bạn muốn xây gì, vì sao cần xây và tiêu chí thành công là gì. Với dự án lớn, agent tạo tài liệu thiết kế để dùng làm đầu vào cho kế hoạch.
Tạo kế hoạch triển khai chi tiết. Kỹ năng writing-plans chia công việc thành các nhiệm vụ nhỏ, thường chỉ mất vài phút mỗi nhiệm vụ. Kế hoạch nêu đường dẫn file, code cần viết và cách kiểm tra, giúp người mới dễ theo dõi hơn.
Tách môi trường làm việc bằng Git worktree. Sau khi thiết kế được duyệt, using-git-worktrees tạo workspace và nhánh riêng, chạy phần thiết lập dự án rồi kiểm tra trạng thái test ban đầu. Cách này giảm nguy cơ làm hỏng nhánh chính.
Áp dụng TDD theo chu trình RED-GREEN-REFACTOR. Agent được yêu cầu viết test thất bại trước, viết lượng code tối thiểu để test chạy qua, sau đó mới refactor và commit. Điều này giúp phát hiện sớm việc hiểu sai yêu cầu.
Điều phối subagent cho từng nhiệm vụ. subagent-driven-development có thể tạo agent mới cho mỗi task, kiểm tra việc tuân thủ đặc tả rồi review chất lượng code. Bạn có thể chọn executing-plans nếu muốn triển khai trong cùng một phiên và chỉ review toàn bộ ở cuối.
Debug có hệ thống. systematic-debugging tập trung vào tìm nguyên nhân gốc thay vì thử ngẫu nhiên. diagnosing-superpowers còn giúp xem một phiên làm việc gặp vấn đề ở đâu, dựa trên bằng chứng trong transcript.
Review và hoàn tất nhánh an toàn hơn. requesting-code-review kiểm tra theo kế hoạch và phân loại vấn đề theo mức độ. finishing-a-development-branch kiểm tra test rồi đưa ra lựa chọn như merge, tạo PR, giữ lại hoặc dọn worktree.
Mở rộng thành bộ kỹ năng riêng. writing-skills hướng dẫn tạo hoặc chỉnh sửa skill theo quy tắc của Superpowers. Tuy nhiên, README lưu ý dự án thường không nhận skill mới nếu chúng không tương thích với các coding agent được hỗ trợ.
Hỗ trợ nhiều công cụ. README có hướng dẫn cho 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.
Hiện bộ kỹ năng gồm các nhóm Testing, Debugging, Collaboration và Meta. Agent sẽ kiểm tra skill liên quan trước mỗi task. Đây là workflow bắt buộc trong phạm vi Superpowers, không chỉ là danh sách gợi ý.
II.Cần chuẩn bị gì
Bạn cần có một coding agent hoặc harness nằm trong danh sách được README hỗ trợ. Cách cài không giống nhau giữa các công cụ. Nếu dùng hơn một harness, bạn cần cài Superpowers riêng cho từng harness.
README không quy định một hệ điều hành cụ thể, cũng không nêu phiên bản Node.js, Python hay Shell tối thiểu. Vì vậy, bạn nên dùng môi trường mà coding agent tương ứng đã hỗ trợ và làm theo đúng lệnh của công cụ đó.
README không yêu cầu API key riêng cho Superpowers. Tài liệu cũng không nêu yêu cầu GPU, tài khoản trả phí hay cấu hình phần cứng cụ thể. Chi phí sử dụng coding agent, mô hình hoặc dịch vụ liên quan phụ thuộc vào công cụ bạn chọn.
Nếu cài từ source, bạn cần Git và một thư mục làm việc có thể chứa bản checkout của repo. Với các lựa chọn cài qua marketplace, bạn chỉ cần quyền sử dụng marketplace hoặc CLI tương ứng.
Superpowers có một tính năng visual companion tùy chọn. Theo README, telemetry mặc định chỉ tải logo Prime Radiant và phiên bản Superpowers; không gửi chi tiết dự án, prompt hay coding agent. Bạn có thể tắt bằng biến môi trường sau:
SUPERPOWERS_DISABLE_TELEMETRYREADME nói biến này nhận bất kỳ giá trị nào được xem là true. Superpowers cũng tôn trọng các biến opt-out telemetry của Claude Code.
III.Cài đặt từng bước
- Chọn harnessXác định bạn dùng coding agent nào
- Mở marketplace hoặc terminalDùng đúng cách cài của harness đó
- Cài SuperpowersChạy lệnh plugin, extension hoặc package tương ứng
- Khởi động lại phiênĐể hook SessionStart hoặc bootstrap được nạp
- Kiểm tra skillGửi một yêu cầu xây tính năng và xem brainstorming có tự kích hoạt không
A.Chọn công cụ bạn đang dùng
Superpowers không có một lệnh cài chung cho mọi nơi. Trước tiên, xác định bạn dùng Claude Code, Codex, Cursor, Gemini CLI hay một harness khác. Nếu bạn dùng nhiều công cụ, hãy lặp lại quy trình cài cho từng công cụ.
Bạn có thể lấy source về máy nếu muốn xem cấu trúc hoặc phát triển cục bộ:
git clone https://github.com/obra/superpowers.git
cd superpowersLệnh đầu tải repo về thư mục superpowers. Lệnh thứ hai chuyển terminal vào thư mục đó. README không yêu cầu chạy npm install hay một lệnh build chung, nên không nên tự thêm bước đó nếu bạn chỉ muốn cài plugin.
B.Cài cho Claude Code
Claude Code có hai marketplace được README nêu. Cách thứ nhất là marketplace chính thức:
/plugin install superpowers@claude-plugins-officialNếu muốn dùng marketplace của Superpowers, đăng ký marketplace trước rồi cài plugin:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplaceCác lệnh này được nhập trong giao diện Claude Code. Người mới thường chạy nhầm trong PowerShell hoặc Command Prompt. Hãy mở phiên Claude Code trước, sau đó nhập lệnh bắt đầu bằng dấu /.
C.Cài cho Codex App hoặc Codex CLI
Trong Codex App, mở mục Plugins ở thanh bên. Tìm Superpowers trong nhóm Coding, bấm dấu + cạnh plugin rồi làm theo hướng dẫn trên màn hình.
Với Codex CLI, mở giao diện tìm plugin:
/pluginsSau đó tìm:
superpowersChọn Install Plugin. Hai cách này không dùng lệnh git clone để kích hoạt plugin trong Codex. Cài source về máy không thay thế cho bước cài qua marketplace của Codex.
D.Cài cho Cursor, Antigravity và Devin CLI
Trong Cursor Agent chat, nhập:
/add-plugin superpowersBạn cũng có thể tìm superpowers trong plugin marketplace của Cursor.
Với Antigravity, chạy:
agy plugin install https://github.com/obra/superpowersAntigravity sẽ liệt kê mô tả từng skill. Mô tả của using-superpowers nhắc model nạp skill khi bắt đầu phiên. Dùng lại cùng lệnh để cập nhật.
Với Devin CLI, cài plugin bằng:
devin plugins install obra/superpowersCập nhật về phiên bản mới hơn bằng:
devin plugins update superpowersE.Cài cho Factory Droid, Gemini CLI và Copilot CLI
Factory Droid cần đăng ký marketplace rồi cài plugin:
droid plugin marketplace add https://github.com/obra/superpowers
droid plugin install superpowers@superpowersGemini CLI cài extension trực tiếp từ repo:
gemini extensions install https://github.com/obra/superpowersKhi cần cập nhật:
gemini extensions update superpowersGitHub Copilot CLI dùng marketplace của Superpowers:
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplaceCác lệnh marketplace phải chạy trong đúng CLI tương ứng. Nếu terminal báo không nhận diện được lệnh, trước hết kiểm tra bạn đã cài và đang dùng đúng công cụ đó.
F.Cài cho Grok Build CLI và Kimi Code
Grok Build CLI có thể cài từ marketplace chính thức của xAI:
grok plugin install superpowers@xai-official --trustHoặc mở giao diện marketplace:
/marketplaceKimi Code có plugin manager riêng. Mở bằng:
/pluginsSau đó chọn Marketplace > Superpowers để cài. Bạn cũng có thể cài trực tiếp:
/plugins install https://github.com/obra/superpowersREADME chỉ tới docs/README.kimi.md nếu cần hướng dẫn chi tiết hơn cho Kimi Code.
G.Cài cho OpenCode, Pi, Qwen Code, Hermes Agent và Muse
OpenCode yêu cầu lấy hướng dẫn cài riêng:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.mdPi cài package từ GitHub:
pi install git:github.com/obra/superpowersKhi phát triển local, có thể chạy Pi với checkout tạm thời:
pi -e /path/to/superpowersQwen Code cài extension:
qwen extensions install obra/superpowersCập nhật bằng:
qwen extensions update superpowersHermes Agent cài và bật plugin trong một lệnh:
hermes plugins install obra/superpowers --enableSau đó khởi động lại các phiên Hermes đang mở. Hermes không có post-compaction hook, nên nếu phiên rất dài bị compact ngay sau lượt đầu, hãy bắt đầu phiên mới khi skill không còn tự kích hoạt.
Muse có thể cài từ checkout local:
muse plugins install ./
muse plugins approve superpowersHoặc clone rồi cài:
git clone https://github.com/obra/superpowers.git
muse plugins install ./superpowers
muse plugins approve superpowersCập nhật bằng:
muse plugins update superpowersHãy khởi động lại phiên Muse sau khi cài. Hook cần được phê duyệt trong lần cài đầu; skill được kích hoạt ngay sau khi plugin hoạt động.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra cơ bản là bắt đầu một phiên mới với coding agent vừa cài và yêu cầu xây một thay đổi nhỏ. README dùng ví dụ:
Let's make a react todo listMột bản cài hoạt động sẽ tự kích hoạt skill brainstorming trước khi viết code. Agent phải hỏi để làm rõ mục tiêu, thay vì lập tức tạo file và code.
Trong một dự án thật, bạn có thể yêu cầu một tính năng nhỏ như tạo màn hình danh sách việc cần làm. Nếu Superpowers hoạt động, luồng thường đi qua brainstorming, thiết kế, worktree, kế hoạch, triển khai và review tùy quy mô task.
Nếu plugin đã cài nhưng skill không kích hoạt, hãy đóng phiên hiện tại và mở phiên mới. Với Muse, hook SessionStart cần phiên mới. Với Hermes, phiên mới cũng là cách xử lý khi session đã compact và mất bootstrap.
V.Dùng vào việc thật
A.Chủ shop cần một trang quản lý đơn hàng
Chủ shop có thể nhờ coding agent xây một màn hình quản lý đơn hàng bằng câu lệnh như:
Let's build a simple order management screen for a small shop. First ask me questions to clarify the workflow, then propose a design before writing code.Superpowers sẽ kích hoạt brainstorming để hỏi về trạng thái đơn, thao tác của nhân viên và thông tin cần hiển thị. Sau khi bạn duyệt thiết kế, agent lập kế hoạch có các task nhỏ, rồi mới bắt đầu code và test.
Kết quả hữu ích không chỉ là vài file giao diện. Bạn có một đặc tả rõ hơn, kế hoạch có thể kiểm tra và quy trình giúp tránh bỏ sót các trường hợp như hủy đơn hoặc cập nhật trạng thái.
B.Nhân viên văn phòng muốn tự động hóa báo cáo
Một nhân viên có thể mô tả yêu cầu cho coding agent:
Build a small script that reads the sales data in this project and produces a weekly summary. Do not code yet. Help me clarify the input, output, and error cases first.Kỹ năng brainstorming giúp biến yêu cầu còn mơ hồ thành thiết kế cụ thể. Sau đó writing-plans chia việc thành đọc dữ liệu, xử lý dữ liệu, tạo báo cáo và kiểm thử. Với một thay đổi độc lập, using-git-worktrees có thể tạo nhánh riêng để không ảnh hưởng bản đang dùng.
Kết quả nhận được là một quy trình phát triển dễ bàn giao hơn. Người không chuyên sâu về code cũng có thể đọc kế hoạch và xác nhận agent đã hiểu đúng cách tính báo cáo.
C.Dev mới muốn xây API an toàn hơn
Dev có thể yêu cầu:
Add a customer lookup endpoint. Use test-driven development, write the failing tests first, and show me the implementation plan before starting.Superpowers sẽ hướng agent qua writing-plans và test-driven-development. Agent cần viết test thất bại trước, triển khai phần tối thiểu để test chạy qua, rồi refactor. requesting-code-review kiểm tra kết quả theo kế hoạch trước khi hoàn tất.
Điểm thực tế là bạn dễ nhận ra thiếu sót ở input, quyền truy cập hoặc lỗi dữ liệu trước khi coi task là xong. Superpowers không thay thế việc bạn review yêu cầu, nhưng biến việc review thành một phần bắt buộc của quy trình.
D.Nhóm kỹ thuật cần xử lý bug khó tái hiện
Khi gặp bug, bạn có thể nói:
Figure out what went wrong with superpowers in this session.Nếu muốn xem phiên cũ, thêm mã session vào yêu cầu. diagnosing-superpowers sẽ đọc transcript, tìm bằng chứng theo dòng và báo cáo điều gì đã xảy ra. Khi cần, skill có thể đóng gói bundle đã loại bỏ thông tin nhạy cảm để báo lỗi.
Với bug phần mềm thông thường, systematic-debugging hướng agent tìm nguyên nhân gốc, dùng root-cause-tracing, defense-in-depth và condition-based-waiting thay vì sửa thử nhiều chỗ.
Quy trình tốt giúp coding agent chứng minh việc đã làm đúng, không chỉ nói rằng đã xong.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Cài plugin nhưng skill không tự chạy
Nguyên nhân thường là bạn đang ở phiên cũ, plugin chưa được bật hoặc cài cho nhầm harness. Hãy kiểm tra plugin trong đúng marketplace, bật hoặc approve nếu công cụ yêu cầu, rồi khởi động phiên mới.
B.Dùng lệnh của công cụ này trong công cụ khác
Các lệnh /plugin, gemini extensions, muse plugins và hermes plugins không thay thế cho nhau. Xác định đúng CLI hoặc app trước khi chạy lệnh. Nếu bạn dùng nhiều harness, hãy cài Superpowers riêng cho từng cái.
C.Phiên dài bị mất bootstrap
README nêu rõ Hermes không có post-compaction hook. Nếu skill ngừng kích hoạt sau khi phiên bị compact, hãy bắt đầu một phiên mới thay vì tiếp tục kỳ vọng bootstrap cũ còn hiệu lực.
D.Agent tự code trước khi hỏi
Hãy kiểm tra plugin đã được cài đúng và gửi yêu cầu trong phiên mới. Superpowers bắt đầu bằng brainstorming khi nhận thấy bạn đang xây dựng thứ gì đó, nhưng các yêu cầu không liên quan đến phát triển phần mềm có thể không kích hoạt luồng này.
E.Lo ngại về telemetry
Visual companion là tùy chọn. README nói dữ liệu này không bao gồm project, prompt hoặc coding agent. Nếu không muốn tải telemetry, đặt SUPERPOWERS_DISABLE_TELEMETRY thành giá trị true theo cách cấu hình biến môi trường của hệ điều hành hoặc harness bạn dùng.
Không dán API key, mật khẩu hoặc dữ liệu khách hàng vào prompt khi chưa hiểu chính sách của coding agent. Superpowers không nêu một API key riêng, nhưng agent và mô hình nền có thể có quy tắc dữ liệu và chi phí riêng.
VII.Có nên dùng không
Bạn nên dùng Superpowers nếu thường giao task nhiều bước cho coding agent, muốn agent hỏi rõ trước khi code, cần kế hoạch có thể review hoặc muốn áp dụng TDD và code review đều đặn. Repo đặc biệt phù hợp với nhóm nhỏ, dev mới và những dự án mà việc làm sai yêu cầu tốn nhiều thời gian hơn việc lập kế hoạch.
Điểm mạnh là bộ skill có cấu trúc, tự kích hoạt theo giai đoạn và hỗ trợ nhiều harness. Các kỹ năng như brainstorming, worktree, TDD, debugging và finishing branch nối với nhau thành một quy trình tương đối hoàn chỉnh. Giấy phép MIT cũng giúp bạn dễ xem xét và tích hợp repo trong phạm vi phù hợp.
Giới hạn là Superpowers không phải mô hình AI và không tự cung cấp coding agent, API key hay môi trường chạy. Chất lượng kết quả vẫn phụ thuộc vào harness, mô hình, quyền truy cập repo và cách bạn duyệt thiết kế. README cũng không nêu yêu cầu runtime chung, nên việc cài có thể khác đáng kể giữa các công cụ.
Nếu bạn chỉ cần một lệnh sinh nhanh vài dòng code, quy trình nhiều bước có thể khiến công việc chậm hơn. Nếu dự án có yêu cầu bảo mật cao, dữ liệu nhạy cảm hoặc quy trình kiểm soát riêng, hãy đánh giá chính sách của coding agent trước khi bật plugin. Khi cần workflow nhẹ hơn, bạn có thể dùng trực tiếp công cụ hiện tại; khi cần tính lặp lại, kiểm chứng và chia task rõ ràng, Superpowers đá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. README không nêu chi phí riêng cho Superpowers, nhưng chi phí của coding agent, mô hình hoặc dịch vụ nền có thể phụ thuộc vào công cụ bạn sử dụng.
Có cần GPU hoặc API key riêng không?
README không nêu yêu cầu GPU hay API key riêng cho Superpowers. Bạn vẫn có thể cần tài khoản, quyền truy cập hoặc cấu hình riêng theo coding agent và marketplace đã chọn.
Superpowers chạy trên Windows được không?
README không chỉ rõ hệ điều hành hoặc phiên bản hệ thống được hỗ trợ. Tài liệu chỉ hướng dẫn cài theo từng harness, nên khả năng chạy phụ thuộc vào công cụ bạn dùng.
Có phải cài riêng cho từng coding agent không?
Có. README nói nếu dùng nhiều harness thì phải cài Superpowers riêng cho từng harness. Plugin đã cài ở một công cụ không tự kích hoạt trong công cụ khác.
Superpowers có tự viết code ngay sau khi nhận yêu cầu không?
Mục tiêu của repo là làm rõ yêu cầu trước, sau đó trình bày thiết kế, lập kế hoạch rồi mới triển khai. Skill brainstorming thường kích hoạt trước khi code được viết.
Dữ liệu dự án có được gửi qua telemetry không?
README nói visual companion telemetry là tùy chọn và không bao gồm chi tiết dự án, prompt hoặc coding agent. Bạn có thể tắt bằng biến `SUPERPOWERS_DISABLE_TELEMETRY`.
Nếu skill không chạy sau khi cài thì làm gì?
Hãy kiểm tra đã cài đúng harness, bật hoặc approve plugin nếu công cụ yêu cầu, rồi mở phiên mới. Với Hermes, README lưu ý phiên mới cần thiết nếu session dài đã compact và mất bootstrap.


