Dev Workflow — ClaudeKit Engineer
ClaudeKit Engineer cung cấp 86 skills và 17 agents tự động phối hợp, giúp dev từ ý tưởng đến ship code production.
ClaudeKit Engineer chỉ chạy trên Claude Code CLI. Không hỗ trợ web app, desktop app, hay IDE extension.
Luồng phát triển tổng thể
Cây quyết định: Dùng lệnh nào?
Dùng sơ đồ dưới đây để chọn đúng lệnh cho tình huống của bạn:
Bạn muốn làm gì?
│
├─ Tạo tính năng mới?
│ ├─ Phức tạp, cần thiết kế kỹ → /plan → review → /cook
│ ├─ Trung bình, rõ requirements → /cook "mô tả"
│ ├─ Nhỏ, fix nhanh → /cook:auto:fast "mô tả"
│ └─ Nhiều modules độc lập → /cook:auto:parallel "mô tả"
│
├─ Sửa bug?
│ ├─ Không rõ nguyên nhân → /fix "mô tả bug"
│ ├─ Bug đơn giản, biết chỗ → /fix:fast
│ ├─ Bug phức tạp, nhiều files → /fix:hard
│ ├─ Tests đang fail → /fix:test
│ ├─ CI/CD bị lỗi → /fix:ci
│ ├─ TypeScript errors → /fix:types
│ └─ UI/CSS bị vỡ → /fix:ui
│
├─ Review code?
│ ├─ Review changes hiện tại → /code-review
│ ├─ Review 1 PR cụ thể → /code-review #123
│ ├─ Review 1 commit → /code-review abc1234
│ └─ Pre-landing review → /review
│
├─ Chạy tests?
│ ├─ Chạy test suite → /test
│ └─ Generate tests mới → /test-gen
│
├─ Khám phá codebase?
│ ├─ Tìm files, hiểu cấu trúc → /scout
│ └─ Debug error có hệ thống → /debug "error"
│
└─ Tạo dự án mới?
└─ /bootstrap
3 Cách implement tính năng
/plan "mô tả ý tưởng" # Tạo plan chi tiết
# Review plan...
/cook # Implement theo plan
/cook "mô tả feature" # Tự plan + implement luôn
/cook:auto:fast "task" # Minimal planning, code ngay
Các nhóm lệnh chính
Plan
/plan, /plan:fast, /plan:hard — Lập kế hoạch từ ý tưởng. Có research agents chạy song song.
Cook
/cook, /cook:auto, /cook:auto:fast — Implement tính năng end-to-end: plan, code, test, review.
Fix
/fix, /fix:fast, /fix:hard, /fix:test — 8 sub-commands sửa bug theo loại.
Code Review
/code-review, /review — Review 3 stage: spec compliance, quality, adversarial.
Test
/test, /test-gen — Chạy tests, đo coverage, generate tests tự động.
Skill Mechanism
4 layers: SKILL.md, command.md, agent.md, hooks — cách chúng phối hợp.
Research
/research — Nghiên cứu giải pháp kỹ thuật, trade-off analysis.
Understand
/understand — Knowledge graph, code analysis, onboarding guide.
Thinking Tools
/sequential-thinking, /brainstorm, /problem-solving — Tư duy có hệ thống.
Docs
/docs, /llms — Tự động tạo và cập nhật documentation.
MCP
/mcp-builder, /mcp-management — Xây dựng MCP servers.
Git & Ship
/git, /worktree, /ship — Git workflow và deploy.
Advanced Skills
ck-debug, ck-predict, ck-scenario, ck-security — Skills nâng cao.
Tiện ích
/watzup, /retro, /journal, /context-engineering — Hỗ trợ hàng ngày.
Workflow đầy đủ: Từ ý tưởng đến production
Lập kế hoạch
ClaudeKit spawn research agents song song để tìm hiểu codebase, sau đó planner tạo plan chi tiết với file list, steps, dependencies. Review plan
Đọc plan trong ./plans/, kiểm tra:
- Đúng requirements?
- Architecture hợp lý?
- Steps đúng thứ tự?
Implement
/cook # Implement theo plan đã tạo
QA kiểm tra
/qa-full:check # Kiểm tra tests
/qa-full:accept docs/prd/F05.md # Nghiệm thu theo PRD
Ship
/ship # Merge main, test, bump version, push
Danh sách lệnh đầy đủ — ClaudeKit Engineer
Nhóm Plan — Lập kế hoạch
| Lệnh | Mô tả |
|---|
/plan "task" | Lập kế hoạch thông minh (có research agents chạy song song) |
/plan:fast "task" | Lập kế hoạch nhanh (không research, chỉ phân tích) |
/plan:hard "task" | Lập kế hoạch sâu (research nhiều, phân tích kỹ) |
/plan:two "task" | Tạo 2 phương án so sánh (research + 2 approaches) |
/plan:parallel "task" | Plan chi tiết với phases chạy song song |
/plan:cro "url" | Plan CRO cho content/trang cụ thể |
/plan:ci | Phân tích GitHub Actions logs + plan fix |
Nhóm Cook — Implement tính năng
| Lệnh | Mô tả |
|---|
/cook "task" | Implement đầy đủ (plan + code + test + review) |
/cook:auto "task" | Auto-plan + implement (“trust me bro”) |
/cook:auto:fast "task" | Nhanh nhất — scout, plan & implement ngay |
/cook:auto:parallel "task" | Plan parallel phases + execute với fullstack agents |
Nhóm Fix — Sửa bug
| Lệnh | Mô tả |
|---|
/fix "bug" | Fix bug (intelligent routing — tự detect loại) |
/fix:fast | Fix bug đơn giản, nhanh |
/fix:hard | Fix bug phức tạp (dùng subagents plan + fix) |
/fix:test | Chạy test suite + fix failing tests |
/fix:ci | Phân tích GitHub Actions logs + fix |
/fix:types | Fix TypeScript type errors |
/fix:ui | Fix UI/UX issues |
/fix:logs | Phân tích logs + fix issues |
/fix:parallel | Fix issues với parallel fullstack agents |
Nhóm Code — Code trực tiếp
| Lệnh | Mô tả |
|---|
/code "task" | Code trực tiếp theo plan có sẵn |
/code:auto | Auto code + test theo plan (“trust me bro”) |
/code:parallel | Execute phases theo plan structure (parallel/sequential) |
/code:no-test | Code theo plan, không chạy test |
Nhóm Test — Testing
| Lệnh | Mô tả |
|---|
/test | Chạy test suite |
/test-gen | Tự động sinh test cases cho components/functions |
Nhóm Review & Ship
| Lệnh | Mô tả |
|---|
/code-review | Review code chất lượng (security, performance, correctness) |
/review | Pre-landing PR review (SQL safety, LLM prompt, config) |
/ship | Ship workflow: merge main, test, review diff, bump version |
Nhóm Explore & Debug
| Lệnh | Mô tả |
|---|
/scout | Scan/explore codebase nhanh |
/scout:ext | Scout bằng external agentic tools (Gemini/OpenCode) |
/debug "error" | Debug error có hệ thống |
Nhóm Bootstrap — Tạo dự án mới
| Lệnh | Mô tả |
|---|
/bootstrap | Scaffold project từ đầu (interactive) |
/bootstrap:auto | Bootstrap tự động |
/bootstrap:auto:fast | Bootstrap nhanh |
/bootstrap:auto:parallel | Bootstrap với parallel execution |
Nhóm Skill Management
| Lệnh | Mô tả |
|---|
/skill:create | Tạo agent skill mới |
/skill:update | Cập nhật skill hiện có |
/skill:optimize | Tối ưu skill |
/skill:optimize:auto | Tối ưu skill tự động |
/skill:add | Thêm reference files/scripts vào skill |
/skill:fix-logs | Fix skill dựa trên logs.txt |
Nhóm Tiện ích
| Lệnh | Mô tả |
|---|
/watzup | Xem recent changes + wrap up phiên làm việc |
/retro | Retrospective: phân tích commit history, work patterns |
17 Agents tự động phối hợp
planner → researcher (parallel) → coder → tester
→ code-reviewer → docs-manager → project-manager
/cook, các agent tự động:
- Planner lập kế hoạch
- Researcher (nhiều agents song song) tìm hiểu codebase
- Coder viết code
- Tester viết và chạy tests
- Code Reviewer review code
- Docs Manager cập nhật tài liệu
- Project Manager tổng hợp kết quả
Danh sách đầy đủ 17 agents
| Agent | Vai trò |
|---|
planner | Lập kế hoạch implementation |
researcher | Tìm hiểu codebase, patterns, dependencies |
architect | Thiết kế architecture, database schema |
coder | Viết code production |
fullstack-developer | Full-stack implementation (frontend + backend) |
tester | Viết unit/integration/e2e tests |
qa-engineer | QA chuyên biệt, edge cases |
code-reviewer | Review code quality |
security-auditor | Kiểm tra bảo mật |
performance-optimizer | Tối ưu hiệu suất |
docs-manager | Cập nhật documentation |
project-manager | Tổng hợp, báo cáo tiến độ |
debugger | Debug errors chuyên sâu |
devops-engineer | CI/CD, deployment, infra |
database-admin | Schema design, migrations, queries |
ui-developer | Frontend UI/UX implementation |
api-developer | API design & implementation |
So sánh: ClaudeKit Engineer vs chat trực tiếp
| Tiêu chí | ClaudeKit Engineer | Chat trực tiếp với Claude |
|---|
| Planning | Có research agents song song, scope challenge, cross-plan detection | Tự nghĩ plan trong 1 message |
| Implementation | 7-step workflow bắt buộc: plan, code, test, review, docs | Code thẳng, dễ bỏ sót test/review |
| Bug fixing | 6 bước: scout, diagnose, assess, fix, verify, prevent | Fix triệu chứng, không root cause |
| Code review | 3 stage: spec compliance, quality, adversarial red-team | Review 1 lượt, thiếu adversarial |
| Testing | Bắt buộc viết test, đo coverage, fix loop | Có thể bỏ qua tests |
| Documentation | Tự động cập nhật docs sau mỗi feature | Phải nhắc thủ công |
| Quality control | Hard gate: không code nếu chưa plan, không ship nếu chưa review | Không có gate nào |
