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ầu	Version	Kiểm tra
macOS hoặc Linux	(Windows cần WSL2)	—
Node.js	>= 20 (khuyên v22)	`node --version`
Claude Code CLI	Latest	`claude --version`
Git	Any	`git --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/     # 6 install scripts theo vai trò
│   ├── install-all.sh   # Lead/Senior
│   ├── install-dev.sh   # Dev
│   ├── install-qc.sh    # QC
│   ├── install-pm.sh    # PM
│   ├── install-design.sh # UI/UX Designer
│   └── 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

bash install-scripts/install-qc.sh

Cài: qa-full (8 sub-commands), ck-scenario, ck-predict, docs-project:qa, test, scout + hooksLệnh hay dùng sau cài:

/ck-scenario "feature"    /qa-full:full    /qa-full:accept    /qa-full:verify-issue

bash install-scripts/install-pm.sh

Cài: docs-project (5 sub-commands), plan, ck-predict, scout, marketing toolsLệnh hay dùng sau cài:

/docs-project:guide    /docs-project:prd "feature"    /plan:validate    /ck-predict

bash install-scripts/install-design.sh

Cài: design, design-system, ui-styling, brand, banner-design, logo-design, slides, cip-design, docs-project:ui, scoutLệnh hay dùng sau cài:

/design "mô tả UI"    /design-system    /ui-styling    /brand    /docs-project:ui "feature"

bash install-scripts/install-devops.sh

Cài: fix, ck-security, deploy, devops, land-and-deploy, canary, cso, cti-expert, security-scan, security-audit, health, ghpm, bootstrap, scoutLệnh hay dùng sau cài (bộ mới):

/fix "CI red"           # Auto-route CI fix (thay /fix:ci cũ)
/land-and-deploy        # Merge PR + deploy + canary verify
/canary                 # Post-deploy monitoring
/cso daily              # Daily security audit
/security-scan          # Secrets + dependency scan
/health                 # Code quality 0-10 score
/deploy-checklist       # Custom PrimeCommerce page

bash install-scripts/install-all.sh

Cài: Tất cả 70+ skills, commands, agents, hooks — đầy đủ nhất.

4. Kiểm tra sau cài

Mở Claude Code CLI

cd ~/your-project
claude

Kiểm tra skills

/find-skills

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

Chạy thử

/plan "add a hello world endpoint"          # Test plan (bộ mới đã bỏ :fast)
/qa-full:audit                              # Test QA
/docs-project:guide                         # Test docs
/vibe                                       # Test full pipeline (nếu có GitHub issue)

Checklist

claude --version chạy OK
/find-skills hiển thị skills
/plan "test" chạy không lỗi
/vibe skill hiển thị (skill autonomous pipeline mớ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ó bản mới, Tech Lead gửi gói cập nhật qua Lark (chỉ chứa phần thay đổi). Không cần tải lại bộ đầy đủ.

Bản 05/10/2026 — `team-claude-skills-update-261005.zip` (62 MB)

Chạy được trên Mac chip Apple, Mac Intel, Ubuntu.

# 1. Thoát hết phiên claude đang mở
# 2. Giải nén và chạy (Ubuntu chưa có unzip: sudo apt install unzip)
cd ~/Downloads
unzip -o team-claude-skills-update-261005.zip
cd team-claude-skills-update-261005
bash update.sh
# 3. Mở lại claude, thử /vibe và /plan "test"

update.sh tự làm:

Chỉ cập nhật skill máy đã có — giữ đúng bộ theo role đã cài.
Thêm 12 skill mới (/vibe, /ghpm, /review-pr, /ck:issue-to-plan, chrome-profile, agent-browser + skill nền).
Gỡ bản cũ trùng tên lệnh: code-review → ck-code-review, graphify → ck-graphify.
Giữ node_modules, .venv và file .env (API key) bên trong skill.
Cài lệnh ak (AgentKit CLI) đúng loại máy — xem Lệnh ak trên từng loại máy.
Cất bản cũ vào ~/.claude/backups/team-update-261005-*, không xoá gì.

Muốn dùng lệnh /ak:* trong 1 project (không cần đăng nhập AK): xem Áp dụng AK trong team. Lỗi sau khi cập nhật → khôi phục đúng trạng thái trước:

bash rollback.sh

Chi tiết thay đổi: file CHANGES.md trong gói. Máy chưa từng cài → cài bộ đầy đủ ở mục 2 trước, rồi chạy gói cập nhật.

Chép đè bằng install-scripts/*.sh của bộ cũ không còn khuyến nghị: cách đó để lại file cũ thừa và gây trùng tên ck:code-review / ck:graphify.

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ỗi	Nguyên nhân	Fix
”Unknown skill: xxx”	File thiếu	`ls ~/.claude/skills/xxx/SKILL.md` — nếu thiếu, chạy lại install script
”Permission denied”	Thiếu quyền execute	`chmod +x ~/.claude/hooks/*.cjs`
Skills không hiện	Claude chưa reload	Thoát (`exit`) rồi mở lại (`claude`)
Hooks không chạy	settings.json thiếu config	`cat ~/.claude/settings.json \| grep hooks` — chạy lại install
Claude skip instructions	Giới hạn cốt lõi	Chạy lại hoặc gõ: “hãy follow đúng skill”

7. Hiểu 3 cấp độ cài đặt

Skills có thể cài ở 3 cấp — ưu tiên từ thấp lên cao:

Quy tắc ghi đè: Project > Global. Nếu cùng 1 skill tồn tại ở cả 2 nơi, bản project-level sẽ được dùng.

Cấp	Vị trí	Scope	Khi nào dùng
Global	`~/.claude/`	Mọi project	Skills chung cho team (qa-full, docs-project, plan…)
Project	`project/.claude/`	1 project	Skills riêng cho project đó (custom cook, hooks riêng…)
Worktree	Kế thừa từ project	Tạm thời	Không cần cài — tự có từ project gốc

Script cài đặt → cài vào Global (`~/.claude/`)

Khi chạy bash install-dev.sh, tất cả skills được copy vào ~/.claude/ — nghĩa là mở claude ở bất kỳ project nào đều thấy skills.

~/.claude/                          ← Global (script cài vào đây)
├── skills/
│   ├── qa-full/SKILL.md           # Dùng ở mọi project
│   ├── docs-project/SKILL.md
│   ├── cook/SKILL.md
│   └── ...
├── commands/
│   ├── qa-full.md + qa-full/
│   ├── plan.md + plan/
│   └── ...
├── agents/
│   └── qa-engineer.md
└── hooks/
    └── qa-context-inject.cjs

Khi nào cần cài Project-level?

Nếu 1 project cần ghi đè skill (ví dụ: /cook riêng cho project đó), tạo file trong:

~/projects/my-project/.claude/      ← Project-level (ghi đè global)
├── commands/
│   └── cook.md                    # Cook riêng cho project này
└── hooks/
    └── pre-commit.cjs             # Hook riêng cho project này

Ví dụ thực tế:

/qa-full cài global → tất cả projects dùng chung ✅
/cook cài project-level ở admap/.claude/ → chỉ admap dùng bản riêng, các project khác dùng bản global ✅

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.

​Cài đặt Skills cho Team

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

​2. Download Skill Package

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

​4. Kiểm tra sau cài

​Checklist

​5. Cập nhật Skills

​Bản 05/10/2026 — team-claude-skills-update-261005.zip (62 MB)

​6. Xử lý lỗi

​7. Hiểu 3 cấp độ cài đặt

​Script cài đặt → cài vào Global (~/.claude/)

​Khi nào cần cài Project-level?

​Bước tiếp theo

Đọc Best Practices

Xem workflow team

Chọn lệnh theo vai trò

Tổng quan công cụ

Cài đặt Skills cho Team

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

2. Download Skill Package

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

4. Kiểm tra sau cài

Checklist

5. Cập nhật Skills

Bản 05/10/2026 — `team-claude-skills-update-261005.zip` (62 MB)

6. Xử lý lỗi

7. Hiểu 3 cấp độ cài đặt

Script cài đặt → cài vào Global (`~/.claude/`)

Khi nào cần cài Project-level?

Bước tiếp theo