Hướng dẫn ClaudeKit

Hướng dẫn đầy đủ cách sử dụng ClaudeKit Engineer và Marketing Kit, từ cài đặt đến workflow hàng ngày.

Yêu cầu

Chỉ chạy trên Claude Code CLI (claude command trong terminal)
KHÔNG chạy trên claude.ai web app, desktop app, VS Code/JetBrains extension
Cần Node.js v18+ và Claude Code v2.1+

# Cách chạy đúng
cd ~/Claude\ Code/projects/ten-project
claude
# Gõ lệnh: /plan "mô tả"

Cài đặt

Cài Claude Code CLI

npm install -g @anthropic-ai/claude-code

Đăng nhập

claude login

Copy Engineer Kit vào project

cd ~/Claude\ Code/projects/ten-project
# Copy .claude/ folder từ project template
cp -r ../template-project/.claude/ .claude/

Kiểm tra skills đã có

claude
# Gõ /plan rồi xem danh sách hiện ra
# Phải thấy: /plan, /cook, /fix, /test, /code-review, ...

Cập nhật: Các commands /plan:fast, /plan:hard, /cook:auto, /test-gen, /fix:* variants, /bootstrap:* variants, /skill:* đã bỏ trong bộ claudekit mới. Xem skill-mapping để biết replacements.

Command Cheat Sheet — Engineer Kit

Workflow chính: Ý tưởng đến Ship

# 1. Plan
/plan "mô tả tính năng"            # Plan chuẩn (skill auto-detects depth)
/plan validate path/to/plan.md     # Validate plan assumptions
/plan red-team path/to/plan.md     # Adversarial review

# 2. Implement
/cook                               # Implement theo plan đã tạo
/cook "mô tả feature"              # Tự plan + implement
/cook --auto "fix nhỏ"             # Auto-approve
/cook --tdd "plan.md"              # Test-driven development
/vibe --ship "feature description" # Full autonomous pipeline

# 3. Test
/test                               # Chạy test suite + coverage
/verify                             # Verify fix không regression
/test-flakiness                     # Detect flaky tests
/qa-full:tdd:verify                # TDD tests + verify

# 4. Review
/code-review                        # Review changes hiện tại
/code-review #123                   # Review PR cụ thể
/review-pr #123 --fix --reply      # Review + auto-fix + reply
/design-review                      # Visual QA + design system check
/review                             # Pre-landing review

# 5. Ship & Deploy
/ship official                      # Release official version
/ship beta                          # Release beta version
/land-and-deploy                    # Merge → deploy → monitor
/canary                             # Post-deploy health check
/setup-deploy                       # Config deploy platform
/ghpm                               # GitHub project management

Fix bugs

/fix "mô tả bug"                   # Auto-detect + route + fix
/investigate "complex bug"          # Find root cause FIRST
/verify                             # Confirm fix no regression

Explore & Debug

/scout                              # Tìm files, hiểu cấu trúc
/ck-debug "error message"           # Systematic debugging
/ck-predict                         # 5 experts debate changes
/ck-scenario                        # Generate edge cases
/ck-security                        # STRIDE + OWASP audit
/ck-graphify                        # Semantic graph of codebase

Utilities & Safety

/watzup                             # Wrap up session
/checkpoint                         # Save session state
/journal                            # Technical journal
/guard                              # Safety gate before commit
/freeze / /unfreeze                 # Lock/unlock codebase
/careful                            # Require confirmation on risky ops

Command Cheat Sheet — Marketing Kit

Marketing Kit chạy trong folder marketing-kit/. Commands dùng prefix /ckm:.

# Chạy Marketing Kit
cd ~/Claude\ Code/marketing-kit
claude

# Content
/ckm:write:good "topic"            # Viết content chất lượng
/ckm:write:blog "topic"            # Viết blog
/ckm:write:cro "page"              # Tối ưu conversion

# SEO
/ckm:seo:keywords "từ khóa"        # Nghiên cứu từ khóa
/ckm:seo:audit                     # Audit SEO
/ckm:seo:pseo                      # Programmatic SEO

# Campaign
/ckm:campaign:create "name"         # Tạo campaign
/ckm:campaign:email "name"          # Email campaign
/ckm:email:sequence "type"          # Email drip sequence

# Social & Analysis
/ckm:social "post"                  # Social media content
/ckm:competitor "domain"            # Phân tích đối thủ
/ckm:persona                        # Customer persona
/ckm:funnel                         # Thiết kế funnel
/ckm:analyze                        # Analytics reports

Workflow khuyên dùng theo tình huống

Feature mới phức tạp

/plan "mô tả tính năng"            # 1. Plan
# Review plan trong ./plans/
/cook                               # 2. Implement theo plan
/qa-full:check                      # 3. QA kiểm tra
/code-review                        # 4. Review
/ship                               # 5. Ship

Fix bug

/fix "mô tả bug"                   # Auto-detect + fix
/qa-full:regression src/file.ts     # Kiểm tra hồi quy

Feature nhanh (đã rõ requirements)

/cook "mô tả feature"              # Plan + implement luôn

Task rất nhỏ

/cook:auto:fast "fix typo in header"

Nhiều modules song song

/cook:auto:parallel "auth + profile + settings"

Vị trí cài đặt

Engineer Kit

projects/ten-project/.claude/
├── skills/          # SKILL.md files (logic chính)
├── commands/        # Slash commands (giao diện user)
├── agents/          # Agent definitions (AI workers)
├── hooks/           # Pre/post hooks (tự động hóa)
├── scripts/         # Helper scripts
└── settings.json    # Cấu hình hooks, permissions

Marketing Kit

marketing-kit/.claude/
├── skills/          # Marketing skills
├── commands/        # /ckm:* commands
└── agents/          # Marketing agents

Tips & Best Practices

1. Luôn plan trước khi cook Ngay cả task “đơn giản” cũng nên plan. Plan mất 30 giây nhưng tránh 30 phút debug.2. Dùng đúng sub-command /fix:types cho TypeScript errors, /fix:ci cho CI failures — đừng dùng /fix chung.3. Đọc plan output trước khi approve Plan có thể sai hoặc thừa. Review kỹ trước khi /cook.4. Dùng QA sau cook /qa-full:check sau mỗi feature đảm bảo coverage đủ.5. Đừng sợ /plan:hard Cho feature quan trọng (auth, payment), đầu tư thêm 5 phút plan sẽ tiết kiệm nhiều giờ.6. Skill Combos cho từng tình huống Feature mới: /plan → /cook → /test → /code-review → /ship Fix bug: /scout → /ck-debug → /fix → /qa-full:regression Trước release: /qa-full:full → /deploy-checklist7. Khi bị stuck Context hết → /watzup + /clear + /cook path/plan.md Fix 3 lần fail → dừng, dùng /brainstorm hoặc hỏi team

→ Xem hướng dẫn đầy đủ: Best Practices tổng hợp — anti-patterns, safety rules, team adoption, troubleshooting.

Lưu ý quan trọng

Commands dùng / prefix (ví dụ: /plan, /cook) — KHÔNG phải /ck:plan
Marketing commands dùng /ckm: prefix
Engineer Kit chạy trong project folder (ví dụ: projects/admap/)
Marketing Kit chạy trong marketing-kit/ folder
Không thể dùng 2 kit cùng lúc trong 1 session

Troubleshooting

Lỗi thường gặp

Vấn đề	Nguyên nhân	Giải pháp
”Unknown skill”	Skills nằm sai folder	Restart: `Ctrl+C` rồi `claude` lại. Check `.claude/skills/`
Không thấy lệnh	`.claude/` chưa copy vào project	Copy `.claude/` vào project root
Skill bị lỗi	Skill cần update	`/skill:optimize ten-skill`
Agent bị treo	Context quá lớn	`Ctrl+C` rồi chạy lại
”OAuth expired”	Token hết hạn	`claude login`
Plan quá chậm	Dùng hard mode cho task đơn giản	`/plan:fast` thay vì `/plan:hard`
Cook bỏ qua test	Flag `--no-test`	Kiểm tra command, bỏ flag
Coverage thấp	Target quá cao ngay đầu	`/qa-full:check --coverage 60` rồi nâng dần
Hook block tool	Hook config sai	Check `.claude/settings.json` → hooks
PRD không chi tiết	Thiếu context (chưa scout)	Chạy `/scout` trước `/docs-project:prd`
ck-scenario bị skip	Claude dùng Agent thay vì Skill tool	USER gõ `/ck-scenario` TRỰC TIẾP, không để skill khác gọi
Cook không đọc PRD	Plan không link docs	Thêm Related Docs vào `plan.md` → Cook sẽ đọc
MDX parse error	Ký tự `<` `>` trong text	Dùng `<` `>` (không phải JSX)

Giới hạn quan trọng

Skills KHÔNG phải magic — hiểu giới hạn để tránh bẫy:

Claude có thể skip instructions (~20%) — check output có đủ bước
Skill gọi skill khác hay bị skip — luôn gõ từng skill trực tiếp
Context lớn = output ít chi tiết hơn — dùng per-sprint mode
Hooks (.cjs) chỉ chạy trên CLI — không chạy trên web/desktop/IDE

→ Xem chi tiết: Best Practices — Giới hạn cần biết

So sánh Engineer Kit vs Marketing Kit

Tính năng	Engineer Kit	Marketing Kit
Prefix	`/` (plan, cook, fix)	`/ckm:` (write, seo, campaign)
Chạy trong	`projects/ten-project/`	`marketing-kit/`
Agents	17 agents (coder, tester, reviewer…)	32 agents (copywriter, seo-expert…)
Skills	86 skills	68 skills
MCP servers	Không	8 MCP servers (storage, analytics…)
Focus	Code quality, testing, deployment	Content, SEO, campaigns

​Hướng dẫn ClaudeKit

​Yêu cầu

​Cài đặt

​Command Cheat Sheet — Engineer Kit

​Workflow chính: Ý tưởng đến Ship

​Fix bugs

​Explore & Debug

​Utilities & Safety

​Command Cheat Sheet — Marketing Kit

​Workflow khuyên dùng theo tình huống

​Feature mới phức tạp

​Fix bug

​Feature nhanh (đã rõ requirements)

​Task rất nhỏ

​Nhiều modules song song

​Vị trí cài đặt

​Engineer Kit

​Marketing Kit

​Tips & Best Practices

​Lưu ý quan trọng

​Troubleshooting

​Lỗi thường gặp

​Giới hạn quan trọng

​So sánh Engineer Kit vs Marketing Kit

Hướng dẫn ClaudeKit

Yêu cầu

Cài đặt

Command Cheat Sheet — Engineer Kit

Workflow chính: Ý tưởng đến Ship

Fix bugs

Explore & Debug

Utilities & Safety

Command Cheat Sheet — Marketing Kit

Workflow khuyên dùng theo tình huống

Feature mới phức tạp

Fix bug

Feature nhanh (đã rõ requirements)

Task rất nhỏ

Nhiều modules song song

Vị trí cài đặt

Engineer Kit

Marketing Kit

Tips & Best Practices

Lưu ý quan trọng

Troubleshooting

Lỗi thường gặp

Giới hạn quan trọng

So sánh Engineer Kit vs Marketing Kit