​
Cài đặt Skills cho Team

Hướng dẫn cài đặt bộ Claude Code Skills đầy đủ cho team PrimeCommerce. Chỉ cần 3 bước: download → install → verify.
Skills CHỈ chạy trên Claude Code CLI (terminal). KHÔNG chạy trên claude.ai web, desktop app, VS Code extension, hay JetBrains extension.

​
1. Yêu cầu hệ thống

Yêu cầuVersionKiểm tra
macOS hoặc Linux(Windows cần WSL2)—
Node.js>= 20 (khuyên v22)node --version
Claude Code CLILatestclaude --version
GitAnygit --version
# Kiểm tra tất cả
node --version        # >= v20
claude --version      # Phải có output
claude auth status    # Phải đã đăng nhập

​
2. Download Skill Package

Download file: team-claude-skills.zip (Lark Drive — yêu cầu quyền truy cập)Liên hệ Tech Lead nếu chưa có quyền download.
Giải nén: 
# Download file từ Lark Drive về ~/Downloads/
cd ~/Downloads
unzip team-claude-skills.zip
cd team-claude-skills
Bên trong gói: 
team-claude-skills/
├── skills/              # 70+ skill folders
├── commands/            # Tất cả commands + sub-commands
├── agents/              # qa-engineer, docs-engineer
├── hooks/               # 2 hooks enforce
├── docs/                # 2 file hướng dẫn
├── install-scripts/     # 5 install scripts theo vai trò
│   ├── install-all.sh   # Lead/Senior
│   ├── install-dev.sh   # Dev
│   ├── install-qc.sh    # QC
│   ├── install-pm.sh    # PM
│   └── install-devops.sh # DevOps
└── README.md

​
3. Cài đặt theo vai trò

Chọn script phù hợp với vai trò — chỉ cần 1 lệnh: 
bash install-scripts/install-dev.sh
Cài: plan, cook, fix, code, scout, debug, qa-full, code-review, test, ship, docs-project + hooksLệnh hay dùng sau cài:
/plan "feature"    /cook    /fix "bug"    /qa-full:check    /ship

​
4. Kiểm tra sau cài

1

Mở Claude Code CLI

cd ~/your-project
claude
2

Kiểm tra skills

/find-skills
Phải hiển thị danh sách skills đã cài.
3

Chạy thử

/plan:fast "add a hello world endpoint"    # Test plan
/qa-full:audit                              # Test QA
/docs-project:guide                         # Test docs

​
Checklist

  • claude --version chạy OK
  • /find-skills hiển thị skills
  • /plan:fast "test" chạy không lỗi
  • /qa-full:audit chạy không lỗi (QC/Dev)
  • Hooks không báo lỗi khi khởi động

​
5. Cập nhật Skills

Khi có phiên bản mới (Tech Lead thông báo qua Lark): 
# 1. Download file mới từ Lark Drive
cd ~/Downloads
unzip -o team-claude-skills.zip
cd team-claude-skills

# 2. Chạy lại install script theo vai trò
bash install-scripts/install-dev.sh     # hoặc install-qc.sh, install-pm.sh
Không bao giờ:
  • Sửa trực tiếp files trong ~/.claude/skills/ (sẽ bị ghi đè khi update)
  • Xoá ~/.claude/settings.json (mất cấu hình permissions)
  • Chạy rm -rf ~/.claude/ (xoá hết tất cả!)

​
6. Xử lý lỗi

LỗiNguyên nhânFix
”Unknown skill: xxx”File thiếuls ~/.claude/skills/xxx/SKILL.md — nếu thiếu, chạy lại install script
”Permission denied”Thiếu quyền executechmod +x ~/.claude/hooks/*.cjs
Skills không hiệnClaude chưa reloadThoát (exit) rồi mở lại (claude)
Hooks không chạysettings.json thiếu configcat ~/.claude/settings.json | grep hooks — chạy lại install
Claude skip instructionsGiới hạn cốt lõiChạy lại hoặc gõ: “hãy follow đúng skill”

​
7. Cấu trúc file sau cài đặt

~/.claude/
├── settings.json              # Permissions + hooks config
├── skills/
│   ├── qa-full/SKILL.md       # QA toàn diện (12 use cases)
│   ├── docs-project/SKILL.md  # Documentation pipeline
│   ├── cook/SKILL.md          # Implement features
│   ├── plan/SKILL.md          # Plan features
│   ├── fix/SKILL.md           # Fix bugs (8 sub-commands)
│   ├── ck-scenario/SKILL.md   # Edge cases (12 chiều)
│   ├── ck-predict/SKILL.md    # AI debate (5 personas)
│   └── ... (70+ skill folders)
├── commands/
│   ├── qa-full.md + qa-full/  # 8 QA sub-commands
│   ├── plan.md + plan/        # 7 plan modes
│   ├── cook.md + cook/        # 4 cook modes
│   └── ...
├── agents/
│   ├── qa-engineer.md
│   └── docs-engineer.md
└── hooks/
    ├── qa-context-inject.cjs   # Auto-detect test framework
    └── docs-context-inject.cjs # Inject project info

​
Bước tiếp theo

Đọc Best Practices

Anti-patterns, skill combos, safety rules — dùng skills hiệu quả.

Xem workflow team

Quy trình phối hợp PM → Design → Dev → QA → DevOps.

Chọn lệnh theo vai trò

Decision tree: dùng lệnh nào cho tình huống nào.

Tổng quan công cụ

Danh sách tất cả skills, agents, MCP servers.