obra/superpowers: bộ kỹ năng giúp AI viết code theo quy trình bài bản — 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à bộ kỹ năng (skills) kèm phương pháp làm phần mềm dành cho các coding agent như Claude Code, Codex, Cursor, Gemini CLI. Nó buộc AI hỏi rõ yêu cầu, lập kế hoạch, viết test trước rồi mới code. Cài chỉ cần một hai lệnh trong công cụ bạn đang dùng, không cần cấu hình thêm.
Superpowers là một bộ kỹ năng (skills) cộng với quy trình làm phần mềm hoàn chỉnh dành cho các coding agent, tức những trợ lý AI viết code như Claude Code hay Codex. Bạn cài nó như một plugin. Từ đó, mỗi khi bạn nhờ AI làm một việc, nó sẽ tự động theo một quy trình có đầu có cuối thay vì lao vào gõ code ngay.
Vấn đề repo giải quyết rất quen thuộc. AI hay hiểu sai ý, làm thiếu, làm thừa, quên viết test, rồi báo "xong rồi" khi chưa kiểm tra gì. Superpowers chặn từ đầu: AI phải hỏi bạn muốn gì, đưa bản thiết kế cho bạn duyệt, lập kế hoạch từng việc nhỏ, rồi mới làm và tự kiểm tra. Repo hiện có khoảng 316.822 sao và 28.189 fork, giấy phép MIT.
Ai nên dùng? Lập trình viên mới muốn AI làm việc có kỷ luật, người làm sản phẩm hay chủ doanh nghiệp nhỏ tự dựng công cụ bằng AI, và dev lâu năm muốn giao việc dài cho agent mà vẫn yên tâm. Điểm đáng giá nhất: bạn không phải học lệnh gì mới. Các kỹ năng tự kích hoạt, nên bạn cứ trò chuyện với AI như bình thường.
obra/superpowers
Bộ kỹ năng và quy trình phát triển phần mềm cho coding agent: hỏi kỹ yêu cầu, lập kế hoạch, viết test trước, giao subagent làm và review.
I.Superpowers làm được gì
Theo README, cốt lõi của Superpowers là một chuỗi bước mà AI đi qua khi bạn bắt đầu xây thứ gì đó. Mình tóm lại theo lợi ích thực tế.
Hỏi trước khi làm (brainstorming). Khi thấy bạn định xây cái gì đó, AI không viết code ngay. Nó hỏi bạn thật sự muốn gì, vì sao, rồi nói lại cách nó hiểu để bạn sửa. Việc nhỏ thì chốt ngay trong chat. Dự án lớn thì có tài liệu thiết kế viết ra giấy. Lợi ích: bớt cảnh làm xong mới phát hiện AI hiểu lệch.
Thiết kế được trình bày từng đoạn ngắn. Bản spec được chia thành các đoạn đủ ngắn để bạn đọc và duyệt, không phải đọc một bức tường chữ.
Làm việc trên nhánh riêng (using-git-worktrees). Sau khi bạn duyệt thiết kế, AI tạo một không gian làm việc tách biệt trên nhánh mới, chạy phần thiết lập dự án và kiểm tra bộ test ban đầu đang sạch. Code đang chạy tốt của bạn không bị đụng vào.
Kế hoạch chia nhỏ (writing-plans). Công việc được cắt thành các task 2-5 phút. Mỗi task có đường dẫn file cụ thể, code đầy đủ và bước kiểm tra. README mô tả kế hoạch này đủ rõ để một kỹ sư junior nhiệt tình nhưng thiếu kinh nghiệm cũng làm theo được.
Giao việc cho nhiều agent con (subagent-driven-development). Mỗi task được giao cho một subagent mới, làm xong có bước review. Có hai bước kiểm tra: đúng yêu cầu chưa, rồi chất lượng code. README nói agent có thể tự làm liền một vài giờ mà không lệch kế hoạch bạn đã duyệt. Nếu muốn rẻ hơn, có chế độ executing-plans: làm hết trong một phiên rồi review cả nhánh một lần cuối.
Viết test trước (test-driven-development). Quy trình RED-GREEN-REFACTOR: viết test, thấy nó fail, viết code tối thiểu cho nó pass, rồi commit. README ghi là code viết trước test sẽ bị xoá.
Review và kết thúc nhánh. Giữa các task có requesting-code-review, báo lỗi theo mức độ, lỗi nghiêm trọng thì chặn tiến độ. Cuối cùng finishing-a-development-branch kiểm tra test và cho bạn chọn: merge, tạo PR, giữ lại hoặc bỏ.
Gỡ lỗi có hệ thống. Thư viện còn có systematic-debugging (quy trình 4 giai đoạn tìm nguyên nhân gốc) và verification-before-completion (phải kiểm chứng rồi mới được tuyên bố đã sửa xong).
Tự chẩn đoán khi AI làm sai. Skill diagnosing-superpowers đọc nhật ký phiên làm việc, chỉ ra chuyện gì đã xảy ra kèm bằng chứng, và nếu bạn muốn thì đóng gói bản đã lược thông tin nhạy cảm để báo lỗi.
II.Cần chuẩn bị gì
Tư liệu của repo không nêu yêu cầu về hệ điều hành, phiên bản Node hay Python, cũng không đòi GPU hay API key riêng của Superpowers. Những gì README thực sự nói là:
- Bạn cần một coding agent mà Superpowers hỗ trợ. Danh sách trong README gồm 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.
- Bạn cần dùng được công cụ đó, tức là đã có tài khoản và đăng nhập theo cách của chính công cụ. Phần này tuỳ từng hãng, README Superpowers không hướng dẫn.
- Nếu dùng nhiều công cụ, README nhắc: cài Superpowers riêng cho từng công cụ.
Vì Git và Node không được nêu là điều kiện chung, mình không khẳng định bạn cần cài chúng. Riêng cách cài trên Muse có dùng git clone, và quy trình làm việc của Superpowers dựa trên Git (nhánh, worktree), nên dự án của bạn nên nằm trong một repo Git.
III.Cài đặt từng bước
Vì mỗi công cụ cài một kiểu, mình hướng dẫn kỹ phần Claude Code (phổ biến nhất) rồi liệt kê lệnh cho các công cụ khác theo đúng README.
- Mở coding agentMở Claude Code (hoặc công cụ bạn dùng) trong thư mục dự án
- Chọn đường càiMarketplace chính thức hoặc marketplace của Superpowers
- Chạy lệnh càiGõ lệnh /plugin install ngay trong khung chat của agent
- Khởi động phiên mớiMở phiên làm việc mới để bộ kỹ năng được nạp
- Thử một yêu cầu nhỏNhờ AI làm một việc và xem nó có hỏi lại trước khi code không
A.Cài trên Claude Code qua marketplace chính thức
Mở Claude Code, rồi gõ lệnh sau ngay trong khung chat. Chỗ người mới hay vấp: lệnh bắt đầu bằng dấu / là lệnh của Claude Code, không gõ vào PowerShell hay Terminal thường.
/plugin install superpowers@claude-plugins-officialLệnh này cài plugin Superpowers từ marketplace chính thức của Anthropic. README ghi đây là đường cài chính.
B.Cài trên Claude Code qua marketplace của Superpowers
Đây là đường thay thế. Marketplace này chứa Superpowers và một số plugin liên quan. Bạn đăng ký marketplace trước, rồi cài plugin.
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplaceLệnh đầu thêm nguồn plugin, lệnh sau cài plugin từ nguồn đó. Làm đúng thứ tự, không đảo.
C.Cài trên các công cụ khác
Mỗi công cụ có lệnh riêng. Mình chép đúng từ README, bạn chỉ chọn công cụ mình đang dùng.
Antigravity:
agy plugin install https://github.com/obra/superpowersCodex CLI: gõ /plugins, tìm superpowers, chọn Install Plugin. Codex App thì bấm Plugins ở thanh bên, tìm Superpowers trong mục Coding, bấm dấu + rồi làm theo hướng dẫn.
/pluginsCursor, gõ trong khung chat của Cursor Agent:
/add-plugin superpowersDevin CLI:
devin plugins install obra/superpowersFactory Droid:
droid plugin marketplace add https://github.com/obra/superpowers
droid plugin install superpowers@superpowersGemini CLI:
gemini extensions install https://github.com/obra/superpowersGitHub Copilot CLI:
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplaceGrok Build CLI:
grok plugin install superpowers@xai-official --trustKimi Code (gõ trong giao diện của Kimi Code):
/plugins install https://github.com/obra/superpowersPi:
pi install git:github.com/obra/superpowersQwen Code (chọn superpowers khi được hỏi):
qwen extensions install obra/superpowersHermes Agent (cài xong nhớ khởi động lại các phiên đang mở):
hermes plugins install obra/superpowers --enableMuse:
git clone https://github.com/obra/superpowers.git
muse plugins install ./superpowers
muse plugins approve superpowersOpenCode không có lệnh gõ ở terminal. README bảo bạn nói thẳng với OpenCode câu sau, và có tài liệu chi tiết ở docs/README.opencode.md:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.mdMột số lệnh cài (Grok có cờ --trust, Muse có bước approve) cho plugin quyền chạy hook trong máy bạn. Chỉ cài từ nguồn bạn tin, và đọc kỹ câu hỏi xác nhận trước khi đồng ý.
D.Cập nhật về sau
README nói việc cập nhật phụ thuộc từng công cụ và thường tự động. Một số công cụ có lệnh riêng, ví dụ gemini extensions update superpowers, devin plugins update superpowers, qwen extensions update superpowers, muse plugins update superpowers. Với Antigravity, cài lại bằng đúng lệnh cũ là được.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra rõ nhất trong README nằm ở phần Muse, nhưng ý tưởng dùng được cho mọi công cụ: mở một phiên mới và gửi câu Let's make a react todo list. Nếu cài đúng, AI sẽ tự kích hoạt kỹ năng brainstorming trước khi viết bất kỳ dòng code nào. Nghĩa là nó hỏi bạn muốn gì chứ không bắt tay vào code.
Hãy chú ý mấy dấu hiệu sau:
- AI đặt câu hỏi làm rõ mục tiêu, không im lặng rồi đưa ra cả đống file.
- AI nói lại cách nó hiểu và chờ bạn xác nhận.
- Sau khi bạn đồng ý thiết kế, nó nói tới việc lập kế hoạch và tạo nhánh làm việc riêng.
Nếu AI lao vào code ngay, rất có thể bộ kỹ năng chưa được nạp. Hãy khởi động lại phiên (README đặc biệt nhắc điều này với Hermes và Muse) hoặc xem phần lỗi bên dưới. Với Antigravity, README giải thích: mô tả của kỹ năng using-superpowers nhắc mô hình nạp nó ngay từ đầu cuộc trò chuyện.
V.Dùng vào việc thật
Superpowers không có "lệnh" để học. Bạn nói chuyện bình thường, quy trình tự chạy. Dưới đây là các tình huống bám đúng khả năng trong README.
A.Chủ shop muốn có công cụ nhỏ cho riêng mình
Bạn bán hàng online và muốn một trang đơn giản để ghi đơn hàng. Bạn không rành code, nên chỉ nói với AI mục tiêu:
Mình muốn làm một trang web nhỏ để ghi lại đơn hàng mỗi ngày.Thay vì dựng đại một giao diện, AI (qua brainstorming) sẽ hỏi: ai dùng, cần lưu thông tin gì, xem lại theo cách nào. Nó đưa bản thiết kế từng đoạn ngắn cho bạn đọc. Bạn chỉ cần trả lời như nói chuyện và sửa chỗ hiểu sai. Kết quả: bạn có một bản thiết kế bằng lời mình đã đồng ý trước khi có dòng code đầu tiên.
Với AI, hỏi đúng trước khi làm rẻ hơn rất nhiều so với sửa lại sau khi làm.
Ông T
B.Dev mới thêm tính năng vào dự án đang chạy
Bạn có một dự án và cần thêm tính năng. Sau khi bạn duyệt thiết kế, Superpowers dùng using-git-worktrees tạo nhánh riêng và kiểm tra test ban đầu có sạch không. Rồi writing-plans cắt việc thành task nhỏ có đường dẫn file và bước kiểm tra. Đến lúc thực thi, bạn chọn: subagent-driven-development (mỗi task một agent con, review sau mỗi task, kỹ nhất) hoặc executing-plans (làm trong một phiên, review cả nhánh một lần, rẻ nhất). Kết quả là nhánh code có test đi kèm, và bạn có thể xem từng bước thay vì nhận một cục thay đổi khổng lồ.
C.Sửa lỗi khó tìm nguyên nhân
Trang của bạn lúc chạy lúc không. Bạn mô tả hiện tượng và nhờ AI sửa. Kỹ năng systematic-debugging đi theo quy trình 4 giai đoạn để tìm nguyên nhân gốc, thay vì đoán mò rồi vá đại. Verification-before-completion buộc AI kiểm chứng là lỗi đã hết trước khi tuyên bố xong. Kết quả: lời giải thích nguyên nhân kèm bằng chứng, không chỉ một câu "đã sửa".
D.Phiên làm việc đi lệch, tốn token
AI lặp lại việc cũ, bỏ qua kế hoạch hoặc có vẻ tiêu tốn nhiều hơn bình thường. Bạn nhờ thẳng:
figure out what went wrong with superpowers in this sessionSkill diagnosing-superpowers sẽ đọc bản ghi phiên làm việc và báo lại chuyện gì đã xảy ra, kèm bằng chứng theo từng dòng. Nếu bạn muốn báo lỗi cho tác giả, nó có thể đóng gói một bộ dữ liệu đã lược thông tin nhạy cảm. Muốn xem phiên cũ thì nêu mã phiên: figure out what went wrong with superpowers in session <id>.
VI.Lỗi hay gặp và cách xử lý
Gõ lệnh /plugin trong PowerShell hay Terminal báo không nhận. Các lệnh bắt đầu bằng / như /plugin install ... là lệnh trong khung chat của Claude Code (hoặc công cụ tương ứng), không phải lệnh của hệ điều hành. Mở Claude Code trước rồi gõ vào đó.
Cài xong nhưng AI vẫn lao vào code. Thoát phiên cũ và mở phiên mới. README nhắc khởi động lại phiên đang mở sau khi cài với Hermes và Muse. Nếu vẫn không được, nhờ AI chạy chẩn đoán như ở trên.
Dùng nhiều công cụ nhưng chỉ cài một chỗ. README nói rõ: mỗi công cụ cài riêng. Cài trên Claude Code không tự có mặt trong Codex hay Cursor.
Với Muse, plugin cài rồi mà hook không chạy. Hook cần được duyệt ở lần cài đầu. Chạy muse plugins approve superpowers rồi khởi động lại phiên.
Phiên quá dài thì kỹ năng ngừng kích hoạt (Hermes). README giải thích Hermes không có hook sau khi nén ngữ cảnh, nên phiên rất dài có thể mất phần khởi động. Khi thấy kỹ năng không còn kích hoạt, mở phiên mới.
Agent chạy tự động nhiều giờ có thể dùng nhiều token hoặc tính phí theo gói của công cụ bạn đang dùng. Chế độ executing-plans được README mô tả là rẻ nhất. Hãy theo dõi chi phí khi giao việc dài.
VII.Có nên dùng không
Điểm mạnh. Quy trình rõ ràng, tự kích hoạt, không cần học lệnh mới. Nó hợp với người muốn AI làm có kỷ luật: hỏi trước, có kế hoạch, có test, có review. Hỗ trợ nhiều công cụ nên bạn không bị khoá vào một hãng. Giấy phép MIT, repo còn được cập nhật trong 3 tháng gần đây.
Giới hạn. Các quy trình này là bắt buộc chứ không phải gợi ý. Với việc nhỏ như đổi một dòng chữ, quy trình đầy đủ có thể hơi nặng, dù README nói việc nhỏ thì chốt ngay trong chat. Làm theo kế hoạch nhiều bước, nhất là với subagent, sẽ tốn nhiều thời gian và token hơn gõ một câu lệnh đơn giản. Cách cài và cập nhật phụ thuộc vào công cụ bạn dùng, nên trải nghiệm có thể khác nhau giữa các nơi.
Về dữ liệu. README có một phần về telemetry: logo Prime Radiant trong tính năng visual companion (tuỳ chọn) của brainstorming được tải từ website của tác giả, kèm phiên bản Superpowers đang dùng. Theo README, nó không gửi chi tiết dự án, prompt hay công cụ AI của bạn. Muốn tắt, đặt biến môi trường SUPERPOWERS_DISABLE_TELEMETRY thành giá trị true. Superpowers cũng tôn trọng DISABLE_TELEMETRY và CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC của Claude Code.
Khi nên chọn cách khác. Nếu bạn chỉ cần AI sửa nhanh một đoạn code nhỏ, hoặc không dùng Git, hoặc thích tự điều khiển từng bước, có thể bạn không cần cả bộ quy trình. Còn nếu bạn hay gặp cảnh AI làm xong mà không dùng được, Superpowers đáng để thử một lần trên một dự án nhỏ trước.
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 bản thân Superpowers là mã nguồn mở. Tuy nhiên bạn vẫn cần một coding agent như Claude Code hay Codex, và chi phí của các công cụ đó tuỳ gói bạn dùng. README Superpowers không nói về giá của chúng.
Superpowers chạy được trên 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ì cài riêng từng nơi.
Có cần GPU hay máy cấu hình mạnh không?
Tư liệu không nêu yêu cầu phần cứng nào. Superpowers là bộ kỹ năng và hướng dẫn cho agent, phần xử lý AI do công cụ bạn dùng đảm nhiệm.
Chạy được trên Windows không?
README không nêu giới hạn hệ điều hành và không có phần riêng cho Windows. Các lệnh cài là lệnh của từng công cụ agent, nên nếu công cụ đó chạy trên Windows thì bạn cài theo lệnh của nó. Nếu gặp lỗi riêng của Windows, chưa có thông tin trong tư liệu để khẳng định thêm.
Dữ liệu của tôi có bị gửi đi đâu không?
README chỉ nêu một loại telemetry: logo trong tính năng visual companion tuỳ chọn được tải từ website của tác giả, kèm số phiên bản Superpowers. Theo README, nó không gồm thông tin về dự án, prompt hay công cụ AI của bạn. Bạn có thể tắt bằng biến môi trường SUPERPOWERS_DISABLE_TELEMETRY.
Superpowers khác gì việc cứ nhờ AI viết code bình thường?
AI thường bắt tay viết code ngay. Với Superpowers, AI phải hỏi rõ yêu cầu, trình bày thiết kế cho bạn duyệt, lập kế hoạch từng task nhỏ, viết test trước và có review trong lúc làm. README gọi đây là quy trình bắt buộc, không phải gợi ý.
Tôi có thể thêm kỹ năng của riêng mình không?
Có skill writing-skills để hướng dẫn tạo kỹ năng mới. Tuy nhiên phần đóng góp trong README nói tác giả nhìn chung không nhận kỹ năng mới vào repo, và mọi thay đổi phải chạy được trên tất cả các coding agent được hỗ trợ.


