Cách Bắt Đầu Một Feature Với Superpowers: Hướng Dẫn Từng Bước

Bạn đã cài Superpowers. Bây giờ thì sao?

Tin tốt: bạn không cần học lệnh đặc biệt nào hay ghi nhớ quy trình phức tạp. Chỉ cần mô tả những gì bạn muốn build — và Superpowers âm thầm tiếp quản phần còn lại, dẫn dắt AI agent qua một quy trình có cấu trúc trước khi một dòng code nào được viết.

Hướng dẫn này đi qua từng bước cụ thể, dùng ví dụ thực tế: thêm tích hợp thanh toán PayOS.

Trước Khi Bắt Đầu: Điều Duy Nhất Bạn Cần Biết

Superpowers hoạt động bằng cách inject các skills vào coding agent của bạn. Những skills này tự kích hoạt theo ngữ cảnh — bạn không gọi chúng thủ công. Khi bạn mô tả một feature, agent nhận ra và tự động kích hoạt đúng skill.

Hãy nghĩ như thuê một senior engineer có quy trình luôn tuân theo, dù bạn yêu cầu họ build gì.

Bước 1 — Mô Tả Những Gì Bạn Muốn (Chỉ Vậy Thôi)

Mở Claude Code hoặc Cursor. Gõ đại loại như:

I want to add a PayOS payment integration to our checkout flow

Hoặc thông thường hơn:

Let's build a notification system that alerts users when their timesheet is overdue

Hoặc thậm chí mơ hồ:

I need a way for admins to export reports as PDF

Tất cả đều hoạt động. Bạn không cần viết prompt hoàn hảo. Việc của agent — với Superpowers — là biến ý tưởng thô của bạn thành thứ gì đó chính xác.

Bước 2 — Agent Hỏi Ngược Lại (Đừng Bỏ Qua Bước Này)

Thay vì viết code ngay, agent kích hoạt skill brainstorming và bắt đầu hỏi các câu hỏi làm rõ:

• "Bạn cần những luồng thanh toán nào — một lần, định kỳ, hay cả hai?"
• "Thanh toán thất bại có tự động thử lại không?"
• "Ai xử lý hoàn tiền — hệ thống hay con người?"
• "Điều gì xảy ra nếu API PayOS bị down?"

Trả lời từng câu một cách trung thực. Nếu bạn không biết, cứ nói thẳng — agent sẽ gợi ý mặc định hợp lý và tiếp tục.

Sau khi nhận câu trả lời, agent tạo ra một design document — tóm tắt rõ ràng những gì nó hiểu, chia thành từng phần ngắn đủ để đọc được.

💡 Mẹo: Đây là khoảnh khắc quan trọng nhất trong toàn bộ quy trình. Lỗi phát hiện ở đây tốn 2 phút. Cùng lỗi đó phát hiện sau khi implement tốn 2 giờ.

Bước 3 — Review và Approve Design

Agent hiển thị design theo từng phần. Với mỗi phần bạn có thể:

• Nói "looks good" để tiếp tục
• Nói "đổi X thành Y" và agent cập nhật lại
• Hỏi "còn trường hợp Z thì sao?" và agent bổ sung vào

Ví dụ cuộc trò chuyện:

Agent: "Phần 1: PayOS client dùng REST API với xác thực HMAC signature.
        Timeout: 10 giây. Retry: 3 lần với exponential backoff."

Bạn:   "Đổi timeout thành 5 giây, muốn fail nhanh."

Agent: "Đã cập nhật. Phần 2: ..."

Khi bạn hài lòng với toàn bộ design, chỉ cần nói:

Approved. Let's go.

Bước 4 — Agent Tạo Workspace An Toàn

Skill using-git-worktrees kích hoạt. Agent tạo branch riêng cho feature của bạn:

git worktree add ../feature-payos-integration feature/payos-integration

Branch main của bạn không bị ảnh hưởng. Nếu có gì sai, bạn xóa branch này mà không có hậu quả gì. Agent cũng chạy test suite hiện có để xác nhận mọi thứ đang xanh trước khi bắt đầu.

💡 Mẹo: Nếu test suite của bạn đã fail từ trước, agent sẽ cảnh báo. Hãy sửa những cái đó trước — dù sao cũng là hygiene tốt.

Bước 5 — Agent Chia Công Việc Thành Các Task Nhỏ

Skill writing-plans kích hoạt. Agent chia design thành các tasks khoảng 2–5 phút mỗi cái. Không phải milestone mơ hồ — mà là tasks cụ thể với đường dẫn file chính xác, code dự kiến, và bước verify rõ ràng.

Ví dụ plan cho feature PayOS:

Task 1 — Tạo PayOSClient
  File: src/payments/PayOSClient.ts
  Code: class với constructor(apiKey, endpoint) và method createOrder()
  Verify: unit test cho createOrder() pass

Task 2 — Thêm config values
  Files: appsettings.json, appsettings.Development.json
  Code: PayOS section với ApiKey, Endpoint, TimeoutSeconds
  Verify: config load không throw exception lúc startup

Task 3 — Tạo payment endpoint
  File: src/controllers/PaymentController.ts
  Code: POST /api/payments/create → gọi PayOSClient.createOrder()
  Verify: integration test trả về 200 với order object hợp lệ

Task 4 — Xử lý webhook callback
  ...

Task 5 — Thêm luồng hoàn tiền
  ...

Agent hiển thị toàn bộ plan. Bạn có thể yêu cầu tách, gộp, hay sắp xếp lại tasks trước khi nói "go."

Bước 6 — Nói "Go" và Để Agent Làm Việc

go

Skill subagent-driven-development tiếp quản. Với mỗi task, một subagent mới:

1. Đọc spec của task
2. Viết failing test trước (ĐỎ)
3. Viết code tối thiểu để test pass (XANH)
4. Refactor nếu cần (REFACTOR)
5. Được review: có đúng spec không? → chất lượng code có chấp nhận được không?
6. Nếu cả hai review pass → commit và chuyển sang task tiếp theo

Nếu review fail, subagent tự sửa trước khi tiếp tục. Bạn không cần can thiệp.

✓ Task 1 hoàn thành — PayOSClient tạo xong, tests passing
✓ Task 2 hoàn thành — config load sạch
✓ Task 3 hoàn thành — endpoint trả về 200
⟳ Task 4 đang xử lý...

💡 Thực tế: Hoàn toàn bình thường khi bạn đứng dậy pha cà phê, quay lại 30–45 phút sau thấy 6 trong 8 tasks đã xong với tests passing. Đây chính là toàn bộ điểm mấu chốt.

Bước 7 — Chọn Cách Kết Thúc

Khi tất cả tasks hoàn thành, agent hỏi:

All tasks complete. Tests passing. What would you like to do?

  1. Merge to main
  2. Open a Pull Request
  3. Keep the branch for now, continue later
  4. Discard all changes

Chọn cái phù hợp với workflow của team. Xong.

Toàn Cảnh Quy Trình

Bạn gõ ý tưởng feature
        │
        ▼
  Agent hỏi làm rõ
  (brainstorming skill)
        │
        ▼
  Bạn approve design
        │
        ▼
  Agent tạo branch
  (git worktrees skill)
        │
        ▼
  Agent viết task plan
  (writing-plans skill)
        │
        ▼
  Bạn nói "go"
        │
        ▼
  Subagents thực thi tasks
  → viết test → viết code → review → commit
  (subagent-driven-development + TDD skills)
        │
        ▼
  Merge / PR / giữ lại / xóa

Bạn Làm Gì vs Agent Làm Gì

Việc của bạn là đưa ra quyết định. Việc của agent là thực thi chúng — chính xác, có test, theo cách lặp lại được.

Câu Hỏi Thường Gặp

Muốn bỏ qua brainstorming cho thay đổi nhỏ thì sao?

Bạn có thể nói với agent: "Bỏ qua brainstorming, đây là thay đổi nhỏ — chỉ thêm loading spinner vào nút submit." Superpowers không bắt buộc toàn bộ quy trình cho task nhỏ. Nó đủ thông minh để khớp workflow với scope.

Agent làm sai gì đó trong một task thì sao?

Two-stage review tự động bắt hầu hết vấn đề. Nhưng nếu bạn phát hiện sai gì, cứ nói với agent trong lúc đang chạy: "Task 3 thiếu error handling cho response 422." Nó sẽ sửa task hiện tại trước khi tiếp tục.

Tôi có thể thêm skills tùy chỉnh không?

Có. Skill writing-skills hướng dẫn bạn tạo custom skills cho domain cụ thể. Ví dụ, bạn có thể viết skill etm-timesheet-task luôn nhắc agent log thời gian vào đúng Azure DevOps work item sau mỗi task hoàn thành.

Kết Luận

Superpowers không làm AI agent của bạn thông minh hơn. Nó làm AI agent của bạn kỷ luật hơn — và hóa ra, kỷ luật mới là thứ còn thiếu từ trước đến nay.

Lần tới khi muốn build một feature, chỉ cần mở Claude Code hoặc Cursor và mô tả nó. Agent sẽ lo phần còn lại.

→ github.com/obra/superpowers