Superpowers: Quy Trình Dạy Agents AI Thành Người Kỉ Luật

Tóm tắt (TL;DR)

Hộp Trả Lời Nhanh (Quick Answer Box cho Google Search):

• Superpowers là gì? Bộ extension và khung quy trình mã nguồn mở dành cho Claude Code, Cursor và các coding agent, buộc agent phải làm việc có kỷ luật: phỏng vấn yêu cầu, viết bài test trước (TDD), cô lập git worktree và xin phê duyệt trước khi sửa code.
• Vì sao AI coding agent hay phá hoại codebase? Do tính bốc đồng (“eager coding”) - agent nhảy vào sinh code ngay lập tức trước khi hiểu rõ kiến trúc, dẫn đến sinh code rác và phá vỡ các chức năng hiện có.
• Hiệu quả thực tế: Mất thêm 2 phút ban đầu để lập kế hoạch và viết test, nhưng giảm 80% thời gian gỡ lỗi và sửa chữa sai lầm về sau.
• Kho mã nguồn: obra/superpowers trên GitHub.

• Vấn đề giải quyết: Các AI coding agent thường vội vã viết code trước khi hiểu rõ bài toán: Superpowers buộc agent phải chậm lại và suy nghĩ.
• Tại sao quan trọng: Chậm hơn ở những phút đầu tiên, nhưng tiết kiệm hàng giờ gỡ lỗi về sau nhờ agent lập kế hoạch, viết test và review bài bản.
• Phù hợp nhất: Lập trình viên dùng Claude Code, Cursor, Codex, OpenCode hoặc Gemini muốn AI hỗ trợ mà không làm bừa bãi codebase.
• Khác biệt cốt lõi: Không phải là một bộ prompt suông, mà là một quy trình làm việc kỷ luật với các chốt kiểm định bắt buộc.

---

Bản đồ Tư duy (Beginner Map)

Lối Tắt 3 Phút: Kích Hoạt Kỷ Luật Cho Coding Agent (The Fast Path)

Nếu bạn muốn ngăn agent tự ý sửa code lung tung ngay trong phiên làm việc tiếp theo:

1. Cài đặt: Cài đặt extension Superpowers vào môi trường Claude Code hoặc Cursor CLI của bạn.
2. Kích hoạt TDD: Bật skill test-driven-development để buộc agent phải tạo fail test và chạy kiểm thử trước khi được phép viết mã nguồn tính năng.
3. Cô lập Worktree: Bật skill using-git-worktrees để agent tự động tạo một nhánh git riêng biệt trong thư mục tách rời, không ảnh hưởng đến cây thư mục bạn đang làm việc.
4. Kiểm duyệt chốt chặn: Yêu cầu agent xuất bảng kế hoạch từng bước và chỉ gõ y đồng ý sau khi bạn đã duyệt kỹ logic.

Nếu bạn đang trao quyền tự trị cho coding agent trong dự án của mình, hãy kiểm soát kỷ luật qua 4 chặng:

1. Nền tảng: Hiểu vì sao sự bốc đồng của AI nguy hiểm và vì sao TDD là chiếc dây xích an toàn nhất cho agent.
2. Mổ xẻ: Phân tích các skill cốt lõi trong Superpowers (brainstorming, cô lập worktree, lập kế hoạch từng bước).
3. Chẩn đoán: Nhận diện bẫy vòng lặp vô tận, ngân sách token và cách ngăn chặn tiến trình treo tài nguyên máy.
4. Giải pháp: Cài đặt extension, thiết lập quyền tối thiểu và thực hành quy trình test-driven đầu tiên.

Phần 1: Nền Tảng - Mô Hình Tư Duy

Lần đầu tiên tôi để cho một AI agent làm việc tự do, nó cảm thấy như phép thuật.

Tôi yêu cầu một tính năng. Nó cho tôi năm cái. Code nó compile. Tests pass. Lúc đó tôi cảm thấy mình thông minh.

Rồi hóa đơn đến. Code là để cả những trường hợp tôi không bao giờ yêu cầu, abstractions mà không ai cần, tests làm ra cho bận rộn. Mọi thứ có ở đó. Chỉ có cái judgment bị thiếu.

Điều nguy hiểm của AI tools là khi chúng sai, chúng sai ở tốc độ cao độ. Chúng không chỉ hiểu lầm bạn. Chúng hiểu lầm bạn với tấc độ nhanh hơn bạn kịp nói “không”.

Mấy lần sau, tôi nhận ra vấn đề không phải trí thông minh. Vấn đề là sự vội vàng.

Hình dung hai người thợ xây. Cái thứ nhất nghe bạn nói “tôi cần một cái kệ,” rồi lập tức lấy cưa. Cái thứ hai hỏi kệ này sẽ đặt ở đâu, chịu trọng lượng bao nhiêu, tường có bê tông hay không, bạn còn cần kệ hay chỉ cần cái hộp có cửa.

Người thợ thứ nhất cảm thấy nhanh. Người thợ thứ hai cảm thấy bàn tán. Cho đến sáu tháng sau, khi cái kệ vẫn còn trên tường.

Đó là cái tôi gọi là mô hình tư duy của Superpowers. Nó không phải một cái búa lớn hơn cho agent của bạn. Nó là thói quen hỏi mấy câu hơi chán trước khi tạo ra một mớ hỗn độn.

Superpowers biến agent thành người thợ thứ hai. Tưởng tượng trước. Lập kế hoạch sau. Test trước khi code. Review trước khi vui mừng. Không có ý tưởng nào mới ở đây. Chính vì vậy mà nó quan trọng.

---

Phần 2: Mổ Xẻ - Bên Trong Thực Ra Có Gì

Khi tôi nhìn vào repository, cái đầu tiên gây chú ý là nó chẳng cố gắng để ấn tượng ai cả.

Không có lý thuyết lớn nào ẩn dưới sàn nhà. Ý tưởng cơ bản rất đơn giản: nếu agent sắp làm công việc thực sự, nó phải tự động gọi đúng skill và tuân theo một quy trình. Không phải “có thể”. Không phải “nếu nó cảm thấy vậy”. Tự động.

Ở mức cao nhất, quy trình trông như thế này:

Yêu Cầu Từ Developer
    ↓
1. Brainstorming
   └─ làm rõ bạn thực sự muốn gì
   └─ so sánh các lựa chọn khác
   └─ được duyệt thiết kế
    ↓
2. Git worktrees
   └─ tách công việc thành nhánh riêng
   └─ xác minh baseline sạch
    ↓
3. Viết kế hoạch
   └─ chia thành các task cụ thể nhỏ
   └─ định nghĩa đúng các files và cách xác minh
    ↓
4. Subagent-driven development
   └─ context mới cho mỗi task
   └─ review so với spec và code quality
    ↓
5. Test-Driven Development
   └─ red, green, refactor
   └─ không code trước khi test fail
    ↓
6. Code review
   └─ chặn khi công việc bị sai
    ↓
7. Kết thúc nhánh
   └─ xác minh tests
   └─ merge, PR, giữ, hoặc loại bỏ

Nghe có vẻ sáo rỗng. Nó sáo rỗng thực sự. Hầu hết những thói quen kỹ thuật tốt đều sáo rỗng.

Repository được tổ chức xung quanh những thói quen đó. Có skills cho brainstorming, viết kế hoạch, thực thi kế hoạch, TDD, code review, debugging, worktrees, và kết thúc nhánh. Cũng có đường cài đặt cho các hệ thống agents khác nhau: Claude Code, Cursor, Codex, OpenCode, Gemini CLI. Chi tiết triển khai khác nhau từng platform, nhưng thái độ cơ bản vẫn như vậy.

Cái tôi thích nhất là không có lãng mạn. Superpowers không bán cho bạn cái tưởng tượng. Nó giả định agent sẽ trôi nếu để một mình, nên nó đặt ray trên đường.

Điều này hiếm hơn nó nên là. Thế giới phần mềm yêu thích những tool hứa làm cho ta cảm thấy mạnh. Hiếm hơn nhiều là những tool lịch sự bắt ta hành động đúng đắn.

---

Phần 3: Thực Tế - Khác Gì Không Có Nó

Cách dễ nhất để hiểu Superpowers không phải đọc phần triết học của nó. Nó là so sánh những gì xảy ra trước và sau khi kỉ luật bước vào phòng.

1. Yêu cầu không rõ ràng trở thành yêu cầu nhỏ hơn, rõ ràng hơn

Không có Superpowers:

User: "Thêm user authentication"
Agent: bắt đầu code ngay

Một giờ sau bạn có login, password reset, token rotation,
ba abstractions, và một helper lạ mà không ai yêu cầu.

Với Superpowers:

User: "Thêm user authentication"
Agent hỏi trước:
  - mật khẩu cục bộ hay OAuth?
  - sessions hay tokens?
  - bạn cần flow reset ngay, hay sau?
  - có rate limit trên login attempts không?

Chỉ sau đó nó mới viết design và tiếp tục.

Nghe chậm chỉ nếu bạn chưa bao giờ phải xóa code. Xóa code thường là phần đắt nhất.

2. Những task lớn sợ hãi trở thành những task nhỏ chán

Không có Superpowers:

Kế hoạch: "Thực hiện user authentication"
Agent code cho đến khi cảm thấy xong.

Nay tests, schema, routes, và middleware đều vướng víu,
cái là một cách nói khác là ngày mai sẽ khó chịu.

Với Superpowers:

Task 1: tạo User model
  files: danh sách đúng các files
  verify: lệnh đúng để xác minh

Task 2: tạo POST /auth/login
  files: danh sách đúng các files
  verify: lệnh đúng để xác minh

Task 3: đặt JWT trong httpOnly cookie
  files: danh sách đúng các files
  verify: lệnh đúng để xác minh

Lúc đầu cái này thấy khó chịu. Rồi bạn nhận ra khó chịu là tốt. Kế hoạch nên nhạt dị đến mức hầu hết mọi người có thể thực hiện nó mà không cần improvise. Improvisation là nơi nhiều AI agents trở thành nghệ sĩ, và codebases hiếm khi cần thêm nghệ sĩ.

3. Tests từ trang trí trở thành công cụ thực sự

Không có Superpowers:

Agent viết code trước:
  function validateEmail(email) {
    return email.includes("@");
  }

Email xấu thoát qua.
Sau này ai đó phát hiện nó trong production,
đó là nơi đắt nhất để học gì cũng được.

Với Superpowers (TDD enforcement):

Agent viết test trước:
  test("rejects emails with multiple @", () => {
    expect(validateEmail("foo@bar@baz.com")).toBe(false);
  })

Rồi mới viết đủ code để pass:
  function validateEmail(email) {
    const parts = email.split("@");
    return parts.length === 2 && parts[0].length > 0 && parts[1].length > 0;
  }

Không có điều này hoa lệ. Cũng như bảo hiểm. Cả hai trở thành thú vị ngay sau khi có chuyện đó xảy ra.

Thread chung xuyên suốt ba tình huống là đơn giản: Superpowers giảm lượng giả vờ. Agent giả vờ ít hơn rằng nó hiểu. Giả vờ ít hơn rằng task mù mờ là rõ ràng. Giả vờ ít hơn rằng code chưa test là an toàn.

---

Phần 4: Bắt Đầu Như Thế Nào

Superpowers là cho những người đã bị ấn tượng bởi AI coding tools, và bây giờ sẵn sàng cho một tham vọng nhạt dị hơn: họ muốn code mà họ có thể sống chung.

Cài đặt: 2 Phút

Chọn platform của bạn:

# Claude Code (Official Marketplace - Dễ nhất)
/plugin install superpowers@claude-plugins-official

# Cursor Agent
/add-plugin superpowers

# Codex
Lấy và tuân theo: https://raw.githubusercontent.com/obra/superpowers/main/.codex/INSTALL.md

# OpenCode
Lấy và tuân theo: https://raw.githubusercontent.com/obra/superpowers/main/.opencode/INSTALL.md

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

Lần Đầu Làm Việc Thực

Đừng bắt đầu với “hello world.” Cho nó một cái gì đó hơi khó chịu. Đó là nơi workflows tiết lộ chính mình.

1. Yêu cầu một tính năng nhỏ nhưng thực, cái gì như user registration với password validation.
2. Để ý agent không nhảy ngay vào code.
3. Để nó hỏi câu hỏi, tạo design, tạo worktree, viết kế hoạch, rồi execute thành từng phần nhỏ.
4. Đọc kế hoạch trước khi đọc code.

Phần cuối cùng quan trọng. Với Superpowers, kế hoạch thường là sản phẩm thực sự. Một khi kế hoạch rõ ràng, việc triển khai trở nên ít bí ẩn hơn nhiều.

Một Điều Cần Biết

Superpowers chậm lúc đầu. Đó không phải lỗi. Câu hỏi mất thời gian. Kế hoạch mất thời gian. Tests mất thời gian. Review mất thời gian. Nếu bạn chỉ quan tâm đến mười lăm phút đầu, cái này sẽ làm phiền bạn.

Nhưng tốc độ là một thứ lạ lùng trong phần mềm. Nhiều quyết định nhanh chỉ là những khoản nợ chuyển động với vận tốc cao vào tương lai. Nếu quy trình giúp bạn tránh một cái cuối tuần dọn dẹp, nó đã trả hết chi phí của mình.

Thử thách thực hành (Student First Assignment)

1. Cài đặt extension Superpowers cho agent CLI bạn đang dùng (Claude Code, Cursor hoặc Gemini).
2. Chọn một bug nhỏ nhưng cụ thể trong codebase (ví dụ: validate email hoặc một case biên khi format ngày tháng).
3. Ra lệnh cho agent ở chế độ Superpowers và bắt buộc nó phải viết test tái hiện lỗi trước khi đụng vào code logic.
4. Quan sát test báo đỏ (Red), theo dõi agent viết code sửa lỗi tối thiểu để test xanh (Green), và soi kỹ git diff trước khi commit.

---

---

Các Câu Hỏi Thường Gặp (FAQ Cho Google Search)

Superpowers có làm chậm tốc độ làm việc của AI coding agent không?

Có, ở những bước đầu tiên. Thay vì nhảy xổ vào viết code trong 10 giây, agent sẽ mất từ 1 đến 2 phút để đặt câu hỏi làm rõ yêu cầu, phác thảo kế hoạch và viết test case. Tuy nhiên, trên quy mô toàn bộ tính năng, nó giúp bạn tiết kiệm hàng giờ đồng hồ vì không phải ngồi gỡ đống lỗi logic ngớ ngẩn do AI tự biên tự diễn.

Superpowers hỗ trợ những công cụ AI coding agent nào?

Quy trình Superpowers hoạt động tốt nhất trên Claude Code, Cursor, Codex, OpenCode và các CLI agent hỗ trợ giao thức Model Context Protocol (MCP). Bất kỳ agent nào cho phép inject system prompt và tool skills đều có thể áp dụng khung kỷ luật này.

Làm sao để ngăn agent tự ý chạy các lệnh nguy hiểm như xóa database?

Superpowers thiết lập cơ chế chốt kiểm định hai chiều (two-way gate checkpoint). Mọi thao tác ghi đè tệp quan trọng, chạy lệnh bash có tham số phá hoại (rm -rf, drop table, git push --force) đều bị chặn lại ở tầng sandbox và bắt buộc phải có xác nhận rõ ràng bằng tay của lập trình viên.

Có nên dùng Superpowers cho các tác vụ script nhỏ vài dòng không?

Không cần thiết. Nếu bạn chỉ cần viết một script Python 10 dòng để chuyển đổi file CSV hoặc regex nhanh một chuỗi văn bản, quy trình kiểm định của Superpowers sẽ trở nên thừa thãi. Superpowers được thiết kế chuyên biệt cho các dự án phần mềm production nhiều module phức tạp.

Lời khuyên cuối (Final Take)

Superpowers là cho khoảnh khắc khó chịu đó khi code do AI tạo trông xong rồi, nhưng bạn không hoàn toàn tin tưởng nó. Có thể bạn không giải thích được tại sao. Thường là bản năng của bạn đúng.

Thay vì hỏi, “Làm sao để agent nhanh hơn nữa?” nó hỏi một câu yên tĩnh hơn: nếu agent phải theo những thói quen nhạt dị mà những kỹ sư tốt đã làm rồi thì sao?

Câu trả lời không phải danh vọng. Câu trả lời là ít hối tiếc hơn.

Bạn sẽ không đánh giá cao kỉ luật khi mọi thứ diễn ra tốt. Bạn đánh giá cao nó khi bạn quay lại code một tháng sau và, đến sự ngạc nhiên, nó vẫn còn có ý nghĩa.

---

Pro Tips

Tip 1: Đừng vội vàng bước brainstorming Cách code lãng phí nhất được sinh ra từ chắc chắn sớm.

Tip 2: Đọc kế hoạch trước khi ngưỡng mộ code Tư duy nhập nhằng thường ẩn dưới cú pháp đẹp.

Tip 3: TDD cảm thấy chậm chỉ trước bug đầu tiên Sau bug thực sự đầu tiên, nó cảm thấy gần như từ thiện.

Tip 4: Commits nhỏ là một hình thức tốt bụng với người tương lai của bạn Tương lai của bạn thường mệt và hơi bực bội. Cố gắng giúp đó là người.

---

Sẵn sàng thử? Cài đặt tại đây: github.com/obra/superpowers | Tham gia cộng đồng: Discord

---

Đọc Thêm

• Phương pháp: Superpowers for Claude Code của Jesse Vincent
• Đóng góp Skills: Fork repo và tuân theo skill writing-skills để tạo workflows riêng của bạn
• Triết học: Test-Driven Development, YAGNI (You Aren’t Gonna Need It), systematic debugging, complexity reduction