Hướng Dẫn Tích Hợp gstack Vào Claude Code: Quy Trình Cài Đặt và Tối Ưu Hóa

gstack là bộ skill mã nguồn mở do @garrytan xây dựng, cung cấp các slash command như /review, /qa, /office-hours để Claude Code làm việc theo flow có cấu trúc thay vì prompt dài lẫn lộn. Tài liệu này hướng dẫn bạn cài từ đầu, kể cả khi chưa quen dòng lệnh.

Bước 1 · Chuẩn bị

Bước 1: Yêu cầu trước khi cài

Cài đủ các công cụ này trước để tránh lỗi vặt. macOS/Linux gọn hơn, Windows thường cần thêm một bước.

Bắt buộc

Claude Code – ứng dụng/CLI của Anthropic
Git – để clone gstack từ GitHub
Bun v1.0 trở lên

Tuỳ hệ điều hành

Windows – thường cần cài thêm Node.js LTS
macOS / Linux – chỉ cần Git + Bun là đủ

Chưa có Bun?: Vào bun.sh, chạy một lệnh cài là xong. Sau đó quay lại trang này để bắt đầu Bước 2. Chạy trong Claude Code hoặc Terminal. Lệnh sẽ clone gstack vào thư mục ~/.claude/skills rồi chạy setup tự động.

Trên Windows: Cài thêm Node.js LTS nếu bị lỗi phụ thuộc, sau đó chạy lệnh dưới đây trong PowerShell.

Bước 2.1 – Đợi chạy xong

Nếu gặp lỗi “permission denied” → xem Bước 6 bên dưới.

Bước 2.2 – Mở Claude Code

Vào workspace đang làm và thử gọi slash command để xác nhận.

Bước 3 · Kiểm tra

Bước 3: Thử 3 lệnh để dùng ngay

Ba lệnh này vừa giúp bạn xác nhận cài đúng, vừa là cách bắt đầu làm việc với gstack theo flow gọn nhất. Copy vào Claude Code rồi chạy thử.

Khởi động

Mô tả bạn đang build gì để gstack vào đúng “chế độ làm việc” phù hợp. /office-hours

/office-hours

Review code

Soi lỗi kiểu production: edge case, dữ liệu xấu, race condition, trust boundary… /review

/review

QA có “mắt” – thử trên staging URL thật

Nếu bạn có staging URL, dùng lệnh này để Claude click thật, đọc console thật và chụp screenshot thật – không phải đoán mò. /qa https://your-staging-url.com

/qa https://your-staging-url.com

Bạn sẽ có ngay sau khi cài

Slash commands /review, /qa, /browse, /ship; một workflow rõ ràng để Claude Code làm việc theo flow; và Browser QA để kiểm tra UI, console và screenshot thực tế – không cần prompt dài.

Bước 4 · Cho team

Bước 4: Thêm gstack vào repo

Nếu bạn làm team: commit skill vào repo để mọi người có cùng bộ lệnh. Người mới chỉ cần chạy setup một lần là xong, không cần giải thích gì thêm. cp -Rf ~/.claude/skills/gstack .claude/skills/gstack && rm -rf .claude/skills/gstack/.git && cd .claude/skills/gstack && ./setup

cp -Rf ~/.claude/skills/gstack .claude/skills/gstack \
&& rm -rf .claude/skills/gstack/.git \
&& cd .claude/skills/gstack \
&& ./setup

New-Item -ItemType Directory -Force .\.claude\skills | Out-Null; Copy-Item -Recurse -Force $HOME\.claude\skills\gstack .\.claude\skills\gstack; Remove-Item -Recurse -Force .\.claude\skills\gstack\.git; cd .\.claude\skills\gstack; .\setup.ps1

New-Item -ItemType Directory -Force .\.claude\skills | Out-Null
Copy-Item -Recurse -Force $HOME\.claude\skills\gstack .\.claude\skills\gstack
Remove-Item -Recurse -Force .\.claude\skills\gstack\.git
cd .\.claude\skills\gstack
.\setup.ps1

Mẹo cho team: Sau bước này, commit thư mục .claude/skills/gstack vào repo. Đồng đội mở repo ra là dùng được ngay – không cần hướng dẫn thêm.

Bước 5 · Bảo trì

Bước 5: Cập nhật gstack lên phiên bản mới

Khi gstack có bản cập nhật, pull và chạy lại setup là xong. Toàn bộ slash command mới sẽ tự có ngay. cd ~/.claude/skills/gstack && git pull && ./setup

cd ~/.claude/skills/gstack && git pull && ./setup

Đồng bộ cho team: Nếu bạn đã copy vào repo (.claude/skills/gstack) thì cũng cập nhật ở đó và commit lại để cả team dùng chung phiên bản mới nhất.

Bước 6 · Xử lý sự cố

Bước 6: Lỗi thường gặp

Chọn đúng lỗi của bạn bên dưới rồi làm theo 1-2 bước là xong.

Đọc tiếp