Bắt đầu tại đây

Quickstart

Từ máy trắng đến lệnh /cpt: đầu tiên — mục tiêu dưới 10 phút.

Đọc hết trang này là đủ để bắt đầu. Chi tiết từng lệnh nằm ở các trang tra cứu.

Cài một lần, rẽ nhánh một lần, rồi lặp plan → cook → ship mãi mãi.

00 Cần có sẵn

Thứ	Kiểm tra	Nếu thiếu
Node.js ≥ 18	`node --version`	`nvm install 18`
Git	`git --version`	Cài Git cho hệ điều hành của bạn
Claude Code	`claude --version`	Cài từ claude.ai/code
SSH tới Backlog	`ssh -T hopee@hopee.git.backlog.com`	Thêm SSH key vào Backlog — CLI clone template qua SSH

01 Cài CPT

$ npx @tam-hopee/cpt-cli@latest init

CLI sẽ: xác nhận nhánh cài → clone template vào ~/.claude → chuyển path cho bản cài toàn cục → copy CLAUDE.md → hỏi API key (Gemini cho skill ai-multimodal; tuỳ chọn thêm Discord webhook, Telegram token) → hỏi cài dependency của skills. Có thể bỏ qua mọi bước hỏi.

◇  Install templates from the main branch? (use --dev for the dev branch)
Target: /Users/you/.claude
Fresh installation
✓ Clone completed
✓ Transformed 287 path(s) in 70 file(s)
✓ Copied 705 file(s), skipped 9 protected
✓ Copied CLAUDE.md
◇  Set up API keys now? (Gemini API for ai-multimodal skill)
◇  Install skills dependencies? (runs install.sh)
└  Done!

Chạy lại đúng lệnh trên bất cứ lúc nào để cập nhật. CLI chỉ ghi vào ~/.claude/ — không đụng tới file trong dự án của bạn — và trong ~/.claude/ nó bỏ qua các file được bảo vệ (.env*, key, CLAUDE.md…).

Lệnh trên đã lấy bản mới nhất — không cần thêm flag nào. Toàn bộ flag của cpt init xem ở CLI Reference.

Kiểm tra nhanh

$ ls ~/.claude/agents   # 13 agent
$ ls ~/.claude/skills   # nguồn của mọi lệnh /cpt:

Không còn thư mục commands/. Từ 2.0, lệnh /cpt:* do các skill trong ~/.claude/skills/ cung cấp. Nếu bạn quen bản 1.x, đây là thay đổi lớn nhất.

02 Lệnh đầu tiên

Mở terminal tại thư mục dự án, chạy claude, rồi gõ 1 trong 2 lệnh dưới.

Dự án đã có sẵn (brownfield)
```
/cpt:docs init
```
Quét codebase và sinh tài liệu nền trong docs/: codebase-summary.md, code-standards.md, system-architecture.md… Các lệnh sau (plan, cook) đọc những file này để hiểu dự án — nên chạy nó trước tiên.
Dự án mới (greenfield)
```
/cpt:bootstrap "API đơn hàng, Node + Postgres"
```
Từ mô tả → research → chọn stack → thiết kế → plan → dựng code khởi tạo. Mặc định có hỏi-duyệt từng bước; thêm --fast để bỏ research.

Rồi thử một vòng làm việc thật

# 1. lập kế hoạch (không viết code)
/cpt:plan Thêm đăng nhập bằng email + reset mật khẩu

# 2. đọc plan.md sinh ra, sửa nếu cần, rồi triển khai
/cpt:cook plans/<thư-mục-plan>/plan.md

# 3. commit
/cpt:git cp

Chỉ cần 3 lệnh đó là bạn đã dùng được CPT cho việc hằng ngày. Xem thêm ở bảng lệnh.

03 CPT hoạt động thế nào

Ba điều cần nhớ, không hơn.

1 · `/cpt:<tên>` = một skill

Mỗi thư mục trong ~/.claude/skills/ sinh ra một lệnh. Gõ /cpt: trong Claude Code để xem danh sách gợi ý — không cần thuộc lòng.

2 · Mode là flags, không phải lệnh con

đúng  /cpt:cook "thêm auth" --fast
đúng  /cpt:plan "migrate DB" --hard
sai   /cook:auto:fast

Flag hay dùng: --fast (nhanh, bỏ research) · --auto (ít hỏi lại) · --parallel (nhiều agent) · --tdd (test trước).

3 · 13 agent tự điều phối — bạn không gọi tay

Bạn gõ một lệnh; workflow tự chọn và xâu chuỗi agent phù hợp. Ví dụ /cpt:cook:

/cpt:cook "thêm xác thực người dùng"
   │
   ├─ planner              → khảo sát + lập kế hoạch
   ├─ fullstack-developer  → viết code theo kế hoạch
   ├─ tester               → chạy test, kiểm coverage
   ├─ code-reviewer        → soát chất lượng + edge case
   └─ project-manager      → cập nhật plan, báo cáo tiến độ

Đủ 13: researcher, planner, brainstormer, fullstack-developer, code-reviewer, code-simplifier, tester, debugger, docs-manager, project-manager, journal-writer, git-manager, ui-ux-designer.

04 Chọn lệnh nào?

Bạn muốn	Gõ
Hiểu dự án lạ / tạo tài liệu nền	`/cpt:docs init`
Tìm chỗ code xử lý việc X	`/cpt:scout "…"`
Chưa chắc nên làm cách nào	`/cpt:brainstorm …`
Đã chốt hướng, cần kế hoạch	`/cpt:plan …`
Triển khai (có/không có plan)	`/cpt:cook …`
Có bug, biết triệu chứng	`/cpt:fix …`
Bug khó, chưa rõ nguyên nhân	`/cpt:debug …` rồi mới `/cpt:fix`
Xong việc, muốn ra PR	`/cpt:ship`
Quay lại sau vài ngày, quên đang làm gì	`/cpt:watzup`

05 Kẹt ở đâu?

Triệu chứng	Xử lý
`/cpt:*` không hiện	Kiểm tra `ls ~/.claude/skills`; gõ `/cpt:` xem gợi ý; khởi động lại Claude Code
Clone thất bại khi `init`	Kiểm SSH tới Backlog và quyền truy cập repo
Skill `ai-multimodal` lỗi	Thiếu `GEMINI_API_KEY` trong `~/.claude/skills/.env`
File template cũ vẫn còn sau khi cập nhật	`cpt init --dry-run` để xem file cũ nào sẽ bị dọn, rồi `cpt init`
Muốn cài lại sạch	`cpt uninstall --force` rồi `cpt init`. Nếu `uninstall` báo thiếu manifest, chạy `cpt init` trước để tạo lại

06 Tiếp theo

Lệnh /cpt: — 20 lệnh hay dùng, flag và ví dụ.
Catalog · Lập trình — 36 lệnh: frontend, backend, chất lượng, hiểu code, test.
Catalog · Công cụ — 27 lệnh: media, tài liệu, mở rộng, tư duy, song song.
CLI Reference — cpt init / uninstall / plan.