Chuyển đến nội dung

obra / superpowers

Superpowers

Bộ kỹ năng biến trợ lý AI thành người làm phần mềm bài bản: hỏi ý, lập kế hoạch, viết test, rồi mới code

Superpowers là một phương pháp làm phần mềm đóng gói thành các skill (gói chỉ dẫn mà AI tự nạp khi cần) cho agent lập trình như Claude Code, Codex, Cursor, Gemini CLI. Khi bạn bắt đầu một việc, agent không lao vào viết code mà hỏi lại bạn muốn gì, trình bày thiết kế, lập kế hoạch từng bước rồi mới thực hiện kèm kiểm thử. Dự án do Jesse Vincent và nhóm Prime Radiant phát triển.

  • 318.068 sao
  • 28.340 fork
  • Shell
  • Cập nhật 13 ngày trước
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Plugin / mở rộng, Tài liệu & khoá học
Chạy trên
Windows, macOS, Linux
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Superpowers

Bạn cài Superpowers như một plugin, thường chỉ một lệnh trong agent đang dùng. Sau đó không cần học lệnh mới: các skill tự kích hoạt. Khi bạn nói muốn làm một ứng dụng danh sách việc cần làm bằng React chẳng hạn, agent sẽ dừng lại hỏi bạn thực sự cần gì thay vì viết code ngay.

Sau vài lượt hỏi đáp, agent trình bày bản thiết kế thành từng đoạn ngắn đủ để bạn đọc và duyệt. Khi bạn đồng ý, nó lập một kế hoạch gồm các đầu việc nhỏ, mỗi việc có đường dẫn file, đoạn code và cách kiểm tra. Bạn bảo go thì agent chia việc cho các subagent (agent phụ), mỗi việc xong được rà soát trước khi sang việc tiếp theo.

README cho biết agent có thể tự làm việc cả vài giờ mà không đi chệch kế hoạch đã duyệt. Tất nhiên bạn nên đọc lại kết quả, nhất là khi dự án quan trọng, và sẽ tốn nhiều lượt gọi mô hình hơn so với việc nhờ AI viết một đoạn code nhanh.

Tính năng nổi bật

Hỏi ý trước khi làm

Skill brainstorming khiến agent làm rõ mục tiêu và lý do, nhắc lại cách hiểu để bạn sửa, rồi mới đi tới thiết kế.

Kế hoạch từng bước nhỏ

Skill writing-plans chia công việc thành các đầu việc vài phút, mỗi việc ghi rõ file, code và cách kiểm tra.

Giao việc cho nhiều agent phụ

Chế độ subagent-driven-development cho mỗi đầu việc một agent riêng, có bước rà soát sau từng việc.

Ép làm theo test trước

Skill test-driven-development yêu cầu viết test thất bại trước, rồi mới viết code vừa đủ để qua test.

Gỡ lỗi có hệ thống

Skill systematic-debugging đi theo quy trình bốn giai đoạn tìm nguyên nhân gốc, thay vì thử sửa mò.

Chạy trên nhiều công cụ

README có hướng dẫn cài cho Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI, OpenCode và nhiều agent khác.

Tận dụng Superpowers vào việc gì?

Lập trình viên cá nhân, freelancer

Dựng một tính năng mới có kế hoạch rõ ràng

Thay vì nhờ AI viết một mạch, để nó hỏi, thiết kế, lập kế hoạch rồi làm từng bước, dễ kiểm soát hơn.

Nhóm sản phẩm nhỏ

Tăng độ tin cậy khi AI viết nhiều code

Bắt buộc có test và có bước review giữa các đầu việc để lỗi lộ ra sớm.

Người dùng Git thường xuyên

Làm việc trên nhánh riêng, an toàn

Skill dùng git worktree tạo không gian làm việc tách biệt trên nhánh mới, không đụng vào bản đang chạy.

Sinh viên công nghệ thông tin

Học quy trình phát triển phần mềm

Đọc các skill như bản mô tả quy trình chuẩn: đặc tả, kế hoạch, TDD, review, hoàn tất nhánh.

Cần chuẩn bị gì?

  • Một agent lập trình được hỗ trợ, ví dụ Claude Code, Codex, Cursor hoặc Gemini CLI (README liệt kê từng loại).
  • Một dự án code, nên dùng Git để các bước làm việc trên nhánh hoạt động trơn tru.
  • Gói hoặc API của agent bạn chọn, vì Superpowers không kèm mô hình AI.
  • Nên có sẵn công cụ chạy test của dự án để vòng viết test hoạt động đúng.

Hướng dẫn cài đặt chi tiết

Cài trên Claude Code

  1. Cách khuyến nghị: cài từ kho plugin chính thức của Claude. Gõ lệnh sau trong Claude Code.

    Văn bản
    /plugin install superpowers@claude-plugins-official
  2. Hoặc thêm kho plugin riêng của Superpowers rồi cài từ đó.

    Văn bản
    /plugin marketplace add obra/superpowers-marketplace
    /plugin install superpowers@superpowers-marketplace
  3. Mở phiên mới và thử nói muốn làm một ứng dụng nhỏ. Nếu cài đúng, agent sẽ bắt đầu bằng bước brainstorming trước khi viết code.

Cài trên Codex / Cursor

  1. Trong Codex App, mở mục Plugins ở thanh bên, tìm Superpowers trong nhóm Coding và làm theo các bước hiện ra. Với Codex CLI, gõ lệnh mở giao diện tìm plugin.

    Văn bản
    /plugins
  2. Trong Cursor, ở khung chat agent chạy lệnh dưới, hoặc tìm superpowers trong kho plugin.

    Văn bản
    /add-plugin superpowers

Cài trên Gemini CLI

  1. Cài như một extension từ repo.

    Terminal
    gemini extensions install https://github.com/obra/superpowers
  2. Cập nhật sau này bằng lệnh dưới.

    Terminal
    gemini extensions update superpowers
  3. Với agent khác (Copilot CLI, OpenCode, Pi, Qwen Code...), mở phần Installation trong README để lấy đúng lệnh, vì mỗi agent cài theo cách riêng.

Dùng thử lần đầu

  1. Khởi động lại hoặc mở phiên mới của agent trong một thư mục dự án trống để các skill được nạp.

  2. Gõ một yêu cầu mơ hồ như: Làm cho mình một ứng dụng todo list bằng React. Quan sát agent hỏi lại thay vì viết code ngay.

  3. Trả lời các câu hỏi, đọc từng đoạn thiết kế và duyệt hoặc sửa. Khi hài lòng, yêu cầu agent lập kế hoạch thực hiện.

  4. Nói go để agent bắt đầu thực hiện theo kế hoạch, xem nó viết test trước, làm từng đầu việc và báo cáo sau mỗi bước.

  5. Nếu có điều gì lạ (skill không kích hoạt, agent bỏ qua kế hoạch), nhờ agent tìm hiểu xem Superpowers đã xảy ra sự cố gì trong phiên này, theo phần When Something Goes Wrong của README.

Mẹo dùng hay

  • Cài Superpowers riêng cho từng agent bạn dùng, vì mỗi nơi cài theo cách khác nhau.
  • Với việc nhỏ như sửa lỗi chính tả, bạn có thể nói rõ làm nhanh để đỡ phải đi qua cả quy trình dài.
  • Đọc kỹ bản thiết kế agent đưa ra, vì đây là lúc rẻ nhất để chỉnh hướng đi.
  • Nếu skill ngừng kích hoạt giữa chừng, README gợi ý mở phiên mới.

Lưu ý và hạn chế

  • Quy trình đầy đủ dùng nhiều lượt gọi mô hình và nhiều agent phụ, nên có thể tốn token hoặc hạn mức gói của bạn hơn nhiều so với cách hỏi thông thường.
  • Phương pháp mang tính áp đặt (các workflow mang tính bắt buộc); nếu bạn muốn tự do thì có thể thấy nó nặng nề.
  • README có nhắc đến telemetry của phần visual companion; hãy đọc mục đó nếu bạn quan tâm đến dữ liệu gửi đi.

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

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

Mã nguồn dùng giấy phép MIT và miễn phí. Chi phí nằm ở agent hoặc gói mô hình AI bạn dùng cùng với nó. Nhóm tác giả cũng có dịch vụ hỗ trợ thương mại cho doanh nghiệp.

Người không biết code dùng được không?

Khá khó. Công cụ dành cho người đã làm việc với agent lập trình và Git. Người mới nên làm quen với Claude Code hoặc Cursor trước.

Khác gì các bộ skill khác?

Superpowers đi theo một phương pháp trọn vẹn từ thiết kế tới hoàn tất nhánh, và các skill tự kích hoạt. Một số bộ khác nhỏ hơn và để bạn tự chọn skill nào dùng.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/obra/superpowers.git

Repo tương tự nên xem

AI hỗ trợ lập trình325K

Matt Pocock Skills

mattpocock / skills

Bộ skill nhỏ gọn giúp trợ lý AI viết code hỏi kỹ yêu cầu, viết test trước và giữ code gọn gàng

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình150K

Spec Kit

github / spec-kit

Bộ công cụ của GitHub giúp trợ lý AI code theo đặc tả: viết spec rõ ràng, lập kế hoạch, chia việc rồi mới làm

KhóWindowsmacOSLinuxPython
AI hỗ trợ lập trình195K

Anthropic Agent Skills

anthropics / skills

Kho skill mẫu chính thức của Anthropic: dạy Claude làm Word, Excel, PDF, PowerPoint và việc chuyên biệt

DễWindowsmacOSLinuxWeb+1

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: AI hỗ trợ lập trình

AI hỗ trợ lập trình304K

ECC (Everything Claude Code)

affaan-m / ECC

Kho agent, skill, hook và quy tắc dựng sẵn để trợ lý AI lập trình làm việc có quy trình và có kiểm tra

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình233K

Karpathy-Inspired Claude Code Guidelines

multica-ai / andrej-karpathy-skills

Một file CLAUDE.md gồm bốn nguyên tắc giúp Claude Code bớt đoán mò, bớt làm phức tạp và sửa đúng chỗ cần sửa

DễWindowsmacOSLinux
AI hỗ trợ lập trình227K

OpenCode

anomalyco / opencode

Trợ lý AI viết code mã nguồn mở, chạy trong Terminal hoặc app desktop, nối được nhiều nhà cung cấp mô hình

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình156K

Claude Code

anthropics / claude-code

Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường

VừaWindowsmacOSLinux
AI hỗ trợ lập trình135K

Codex CLI

openai / codex

Trợ lý AI viết code của OpenAI chạy nhẹ trong Terminal, đăng nhập bằng tài khoản ChatGPT hoặc khoá API

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình109K

Gemini CLI

google-gemini / gemini-cli

Agent AI mã nguồn mở của Google chạy trong Terminal, nay chủ yếu dành cho khách hàng Code Assist doanh nghiệp

VừaWindowsmacOSLinuxNode.js

Xem cả 30 repo AI hỗ trợ lập trình Về Kho Repo