Skills cho AI coding agent
Skill là các file hướng dẫn cài thẳng vào repo, giúp AI coding agent (Claude Code, Cursor, GitHub Copilot, Windsurf…) tích hợp đúng các sản phẩm Cas — bằng chính ngôn ngữ và kiến trúc mà codebase của bạn đang dùng.
Mọi dữ kiện trong skill (luồng tích hợp, endpoint, scopes, checklist) được sinh
tự động từ tài liệu này tại thời điểm build, nên skill không bao giờ lệch với trang
tài liệu gốc.
Nhấn nút Copy ở đầu trang bất kỳ rồi dán vào agent của bạn, hoặc mở bản Markdown
tại cas.so/skills/README.md.
Bắt đầu ở đây
Mỗi skill mô tả một phần của tích hợp:
cas-core— nền tảng: môi trường, xác thực, vòng đời grant (token→ Cas Link →exchange→ gọi API), webhook và xử lý lỗi. Luôn cài trước tiên.- Một skill cho mỗi sản phẩm bạn tích hợp — QR Pay, Payout, Transactions, eKYC… Xem danh mục bên dưới.
Thêm một sản phẩm Cas về sau chỉ là cài thêm một file skill.
Cài nhanh bằng nút Copy (khuyến nghị)
Mọi trang tài liệu và trang API đều có nút Copy ở đầu trang. Trên trang của một sản phẩm, mở menu cạnh nút Copy và chọn:
| Tùy chọn | Làm gì |
|---|---|
| Sao chép prompt tích hợp | Prompt ngắn: yêu cầu agent tải skill Cas về repo rồi tích hợp sản phẩm theo checklist. Dán thẳng vào agent. |
| Sao chép prompt đầy đủ | Bản tự chứa: nội dung skill, tài liệu API và production checklist được nhúng sẵn — dùng cho agent không có truy cập mạng. |
| Mở prompt tích hợp | Xem trước prompt trong tab mới trước khi dùng. |
Agent nhận prompt sẽ tự tải các file skill và đặt vào đúng thư mục của công cụ.
Cài thủ công
- Luôn cài
cas-coretrước, sau đó thêm skill cho từng sản phẩm bạn tích hợp. - Tải mỗi file
SKILL.mdtừ danh mục và lưu vào nơi công cụ AI của bạn đọc hướng dẫn:
| Công cụ | Đường dẫn |
|---|---|
| Claude Code | .claude/skills/<id>/SKILL.md |
| Cursor | .cursor/rules/<id>.mdc |
| GitHub Copilot | .github/instructions/<id>.instructions.md |
| Windsurf | .windsurf/rules/<id>.md |
| Công cụ khác | docs/ai/<id>.md, trỏ tới từ AGENTS.md |
- Thêm một đoạn trỏ đường trong
AGENTS.md(hoặc file hướng dẫn gốc của agent):
## Tích hợp Cas
Skill của Cas nằm trong `.claude/skills/`. Đọc `cas-core` trước, rồi tới skill của sản phẩm.
Không đoán cấu trúc API — luôn mở các liên kết `.md` được ghi trong skill.
Skill cài thủ công không tự cập nhật. Thỉnh thoảng tải lại từ danh mục để lấy bản mới nhất.
Danh mục skill
| Sản phẩm | Skill id | Tải |
|---|---|---|
| Core (bắt buộc) | cas-core | SKILL.md |
| QR Pay | cas-qr-pay | SKILL.md |
| Pay Out | cas-pay-out | SKILL.md |
| Payment Initiation | cas-payment-initiation | SKILL.md |
| Auto Debit | cas-auto-debit | SKILL.md |
| Transactions | cas-transactions | SKILL.md |
| Virtual Account | cas-virtual-account | SKILL.md |
| Balance Hook | cas-balance-hook | SKILL.md |
| Invoice Hub | cas-invoice-hub | SKILL.md |
| TVAN | cas-tvan | SKILL.md |
| eKYC | cas-ekyc | SKILL.md |
| IDKit | cas-idkit | SKILL.md |
| Deeplink | cas-deeplink | SKILL.md |
Hướng dẫn cài dạng Markdown: cas.so/skills/README.md ·
Bản cho máy đọc: cas.so/skills/index.json
Thêm sản phẩm về sau
Tải cas.so/skills/index.json, chọn skill của
sản phẩm mới và lưu cạnh các skill hiện có. Không cần sửa gì thêm — mỗi skill đã tự
mang luồng tích hợp, danh sách API và checklist của nó.