Cài đặt GSD-2

GSD-2 dùng cùng gói gsd-pi với Get Shit Done Framework - không cần cài đặt riêng. Sau khi cài, tính năng auto-mode và toàn bộ lệnh GSD-2 đều có sẵn ngay lập tức. Bạn chỉ cần thêm một AI assistant tương thích để kích hoạt vòng lặp tự động.

Yêu cầu trước khi cài đặt

Node.js 18 trở lên

GSD yêu cầu Node.js phiên bản 18+ và npm đi kèm. Kiểm tra bằng lệnh node --version. Nếu chưa cài, tải tại nodejs.org hoặc dùng nvm để quản lý nhiều phiên bản.

AI assistant tương thích

GSD-2 yêu cầu một AI assistant có thể nhận và thực thi lệnh /gsd. Các assistant được hỗ trợ bao gồm Claude Code, Cursor, Windsurf, và bất kỳ công cụ nào hỗ trợ MCP (Model Context Protocol) hoặc cho phép tích hợp công cụ tuỳ chỉnh.

Git

Dự án của bạn cần được quản lý bằng git. GSD-2 dùng git để tạo commit tự động sau mỗi task hoàn thành và hỗ trợ chế độ cô lập task qua git worktree. Kiểm tra bằng lệnh git --version.

Cài đặt gsd-pi

Cài đặt gsd-pi toàn cục bằng npm. Gói này cung cấp lệnh pi và toàn bộ hệ thống GSD bao gồm cả Get Shit Done Framework lẫn GSD-2:

bash

npm install -g gsd-pi

Lệnh này cài đặt gsd-pi vào thư mục npm toàn cục. Trên Linux/macOS, bạn có thể cần dùng sudo nếu npm toàn cục yêu cầu quyền ghi vào thư mục hệ thống. Khuyến nghị dùng nvm để tránh vấn đề quyền truy cập.

Xác minh cài đặt

Sau khi cài xong, chạy lệnh sau để kiểm tra công cụ hoạt động đúng:

bash

pi --version

Kết quả xuất ra sẽ tương tự:

text

pi version 2.x.x
gsd-pi v2.x.x

Nếu lệnh không được nhận ra, hãy kiểm tra lại PATH của npm toàn cục bằng npm root -g và đảm bảo thư mục đó có trong biến môi trường PATH.

Kết nối AI assistant

GSD-2 hoạt động bên trong ngữ cảnh của AI assistant - các lệnh /gsd được nhập trực tiếp vào chat của assistant, không phải trong terminal độc lập. Để kết nối, assistant cần có quyền truy cập vào các công cụ GSD thông qua một trong hai cách:

Tích hợp MCP (khuyến nghị)

Cấu hình GSD như một MCP server trong file cấu hình của assistant (ví dụ: .mcp.json hoặc cài qua Claude Desktop). Cách này cho phép assistant gọi các hàm GSD trực tiếp như công cụ bản địa với schema rõ ràng.

Kết nối qua extension/plugin

Một số AI assistant (Cursor, Windsurf) hỗ trợ GSD thông qua extension tích hợp sẵn hoặc cấu hình rules. Tham khảo tài liệu của từng assistant để biết cách khai báo công cụ tuỳ chỉnh.

Tài liệu kết nối AI assistant

Hướng dẫn chi tiết cách cấu hình GSD với từng assistant cụ thể (Claude Code, Cursor, Windsurf) có trong phần tài liệu riêng của từng assistant. Tìm kiếm "MCP setup" hoặc "tools integration" trong tài liệu của assistant bạn đang dùng.

Bước tiếp theo

Sau khi cài đặt xong và kết nối AI assistant, bạn đã sẵn sàng bắt đầu với GSD-2:

Auto Mode Step vs Auto Mode Lệnh GSD-2