close

gstack

Mã nguồn mở bởi garrytan

gstack là bộ skill dạng lệnh gạch chéo cho Claude Code và các coding agent khác, do Garry Tan công bố. Mỗi lệnh đóng một vai trong nhóm làm phần mềm: người phản biện sản phẩm, quản lý kỹ thuật, nhà thiết kế bắt lỗi giao diện kiểu AI, người review mã, QA mở trình duyệt thật, kiểm tra bảo mật và người phát hành PR.

gstack dùng để làm gì?

  • Phản biện ý tưởng và lập kế hoạch bằng /office-hours, /plan-ceo-review, /plan-eng-review trước khi viết mã
  • Chấm và sửa thiết kế giao diện bằng /plan-design-review, /design-review, dựng hệ thống thiết kế bằng /design-consultation
  • Review mã để tìm lỗi qua được CI nhưng hỏng khi chạy thật bằng /review
  • Kiểm thử trên trình duyệt thật, API, CLI, job và webhook bằng /qa, tái hiện lỗi rồi sửa
  • Chạy test, mở PR, gộp và theo dõi sau khi deploy bằng /ship, /land-and-deploy, /canary

Cần biết trước khi dùng

  • Nghiêm trọng1 lỗ hổng đã biết trong dependency khai báo, trong đó mức Cao/Nghiêm trọng: GHSA-wq5f-xc86-pv6w (sharp@0.35.4, HIGH). Phiên bản lấy từ file khai báo nên có thể khác bản thật khi cài.
  • Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
  • Lưu ýTino chưa kiểm thử dự án này.

Kiểm tra tự động ngày 21/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.

gstack là gì?

gstack biến một phiên làm việc với coding agent thành quy trình có nhiều vai. README mô tả đây là một quy trình chứ không phải tập công cụ rời: các skill chạy theo thứ tự của một sprint, gồm Think, Plan, Build, Review, Test, Ship, Reflect. Kết quả bước trước là đầu vào bước sau: /office-hours viết design doc cho /plan-ceo-review đọc, /plan-eng-review viết kế hoạch test cho /qa dùng, /review bắt lỗi và /ship xác nhận lỗi đã sửa.

Bảng sprint trong README liệt kê 39 lệnh, cộng thêm một nhóm công cụ phụ. Phần lập kế hoạch có /office-hours (sáu câu hỏi ép làm rõ sản phẩm), /plan-ceo-review, /plan-eng-review, /plan-devex-review và /autoplan chạy lần lượt các lượt review. Phần kiểm tra có /review, /qa, /qa-only, /cso (kiểm tra bảo mật), /test-audit, /verify. Phần phát hành có /ship, /land-and-deploy, /canary, /benchmark, /document-release. Ngoài ra có /browse để agent điều khiển trình duyệt, /make-pdf, /diagram, /retro, /learn và các lệnh an toàn /careful, /freeze, /guard.

Nhóm lệnh thiết kế là phần liên quan tới giao diện. /plan-design-review chấm từng khía cạnh thiết kế theo thang 0-10, giải thích mức 10 trông ra sao rồi sửa kế hoạch, có bước phát hiện AI slop. /design-review làm cùng lượt soát đó trên sản phẩm đang chạy rồi sửa luôn, mỗi sửa đổi là một commit riêng kèm ảnh trước và sau. /design-consultation dựng hệ thống thiết kế từ đầu và ghi ra file DESIGN.md. /design-shotgun sinh 4-6 phương án mockup và mở bảng so sánh trên trình duyệt. /design-html chuyển mockup thành HTML dùng được, /design-motion dựng vòng lặp chuyển động và xuất MP4, GIF (cần ffmpeg).

Cài đặt bằng cách clone repo vào thư mục skill rồi chạy script ./setup. Script này build các binary trên máy (browse, design, pdf và một số công cụ khác) và đăng ký hook vào Claude Code. Claude Code được hỗ trợ ở mức full; Codex CLI, OpenCode, Cursor, Factory Droid, Kiro, GitHub Copilot CLI, Antigravity CLI, Gemini CLI, OpenClaw, Hermes ở mức experimental. README ghi macOS và Linux được hỗ trợ đầy đủ, Windows chỉ ở mức tối thiểu.

Về dữ liệu gửi ra ngoài: telemetry tắt mặc định và chỉ hỏi một lần. Kiểm tra cập nhật bật mặc định (vài request tới GitHub). Tính năng review từ bên ngoài cũng bật mặc định và gửi mã tới Codex hoặc Claude Code bằng tài khoản của chính bạn. Mỗi lần gửi ra ngoài đều ghi biên nhận, xem bằng gstack-egress list. Giấy phép MIT.

Nên dùng khi

  • Bạn làm sản phẩm một mình hoặc nhóm nhỏ và muốn có các lượt review sản phẩm, thiết kế, kỹ thuật, QA, bảo mật trước khi gộp mã
  • Bạn mới dùng Claude Code và muốn một quy trình có sẵn vai trò thay vì ô chat trống
  • Bạn muốn agent tự soát giao diện, bắt lỗi thiết kế kiểu AI và sửa kèm ảnh trước, sau
  • Bạn là tech lead cần tự động hoá review, QA và phát hành trên mỗi PR
  • Bạn dùng macOS hoặc Linux và chấp nhận cài Bun, Git cùng một bộ công cụ có nhiều thành phần

Không nên dùng khi

  • Bạn không muốn chạy script cài đặt lạ trên máy: gstack cài bằng git clone rồi ./setup, script build binary ngay trên máy và đăng ký hook vào Claude Code, nên đọc script và docs/install.md trước
  • Bạn dùng Windows 11 bật Smart App Control: các binary browse, find-browse, design, pdf, gstack-global-discover được build tại máy và không ký số nên bị chặn (issue #2595); cách xử lý hiện có là chạy trong WSL hoặc tắt Smart App Control. README ghi Windows chỉ được hỗ trợ tối thiểu
  • Mã nguồn của bạn không được phép gửi cho bên thứ ba: review từ bên ngoài bật mặc định và gửi mã tới Codex hoặc Claude Code; cần tắt bằng gstack-config set codex_reviews disabled
  • Bạn lo ngại về phiên đăng nhập trình duyệt: /browse dùng phiên thật của trình duyệt Aside trên macOS, /setup-browser-cookies chép cookie từ Chrome, Edge, Brave sang trình duyệt của gstack, /pair-agent tự mở tunnel ngrok cho agent từ xa
  • Bạn chỉ cần một skill nhỏ cho giao diện: gstack là cả một quy trình với hàng chục lệnh, tự kiểm tra cập nhật mỗi phiên và có ý kiến riêng về cách làm việc
  • Bạn dùng agent khác Claude Code và cần lớp chặn lệnh nguy hiểm: trên các host còn lại, skill an toàn chỉ ở mức khuyến nghị, không chặn
  • Bạn muốn giữ nguyên công cụ trình duyệt đang dùng: câu lệnh cài trong README yêu cầu ghi vào CLAUDE.md rằng chỉ duyệt web bằng /browse và không dùng các tool mcp__claude-in-chrome

Tính năng chính

  • 39 lệnh trong bảng sprint của README, chạy theo chuỗi Think, Plan, Build, Review, Test, Ship, Reflect
  • Nhóm thiết kế: /plan-design-review, /design-review, /design-consultation, /design-shotgun, /design-html, /design-motion; nhóm iOS có /ios-design-review
  • /plan-design-review chấm từng khía cạnh thiết kế 0-10 và có bước phát hiện AI slop; /design-review sửa bằng commit riêng kèm ảnh trước, sau
  • /design-consultation ghi hệ thống thiết kế ra DESIGN.md theo định dạng mở để công cụ khác đọc chung
  • /review tự sửa lỗi rõ ràng, đánh dấu test bị làm yếu, timeout, snapshot hoặc chỗ tắt cảnh báo để người duyệt
  • /qa và /qa-only kiểm thử trình duyệt, API, CLI, job, webhook; /qa-only chỉ báo cáo, không sửa mã
  • /cso kiểm tra bảo mật; không có Docker thì chỉ chạy đánh giá tĩnh
  • /browse điều khiển trình duyệt Aside trên macOS hoặc Chromium đi kèm trên Linux, Windows
  • /careful, /freeze, /guard cảnh báo trước lệnh phá huỷ và khoá phạm vi sửa file
  • /codex và /claude-code lấy ý kiến review độc lập từ agent còn lại
  • Chế độ nhóm (team mode) để cả nhóm tự nhận gstack và tự cập nhật theo kênh stable
  • Hỗ trợ nhiều host qua ./setup --host; gstack-doctor kiểm tra tình trạng cài đặt
  • Giấy phép MIT

Cách cài đặt gstack

  1. Cài trên máy cho Claude Code README hướng dẫn dán lệnh này vào Claude Code để agent tự chạy, kèm yêu cầu thêm mục gstack vào CLAUDE.md. Bản cài mới theo kênh stable. Nên đọc script setup trước khi chạy.
    git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup
  2. (Tuỳ chọn) Bật chế độ nhóm cho repo dùng chung Chạy trong repo của bạn. Lệnh này tạo một commit để đồng đội tự nhận gstack. Đổi required thành optional nếu chỉ muốn nhắc chứ không chặn. Hook required chạy bằng Node.js nên mọi thành viên cần có Node.js.
    (cd ~/.claude/skills/gstack && ./setup --team) && ~/.claude/skills/gstack/bin/gstack-team-init required && git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"
  3. (Tuỳ chọn) Cài cho agent khác --host auto cài cho mọi agent mà setup phát hiện trên máy. Các host ngoài Claude Code ở mức experimental hoặc chỉ có hướng dẫn.
    git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
    cd ~/gstack && ./setup --host auto      # or: ./setup --host codex
    ./setup --status                         # one row per install: host, tier, scope, version, path
  4. Kiểm tra cài đặt In từng dòng kiểm tra (cài đặt, Bun, hook, binary) kèm lệnh sửa. Trên Windows bật Smart App Control, các binary bị chặn hiện trạng thái blocked.
    ~/.claude/skills/gstack/bin/gstack-doctor
  5. (Tuỳ chọn) Tắt review từ bên ngoài và kiểm tra cập nhật Dùng khi không muốn mã được gửi tới Codex hoặc Claude Code. Tắt kiểm tra cập nhật bằng gstack-config set update_check false.
    gstack-config set codex_reviews disabled

Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.

Cấu hình quan trọng

MụcÝ nghĩa
GSTACK_CHROMIUM_NO_SANDBOXĐặt bằng 1 khi Chromium cài được nhưng không khởi động vì máy Linux chặn unprivileged user namespaces (mặc định AppArmor của Ubuntu 24.04+).
GSTACK_STRICT_BUILDĐặt bằng 1 để setup dừng hẳn khi build công cụ native của /cso thất bại, giống cách CI chạy. Mặc định setup vẫn hoàn tất và báo bước lỗi.
CODEX_HOMEThư mục gốc của Codex CLI; skill cài cho Codex nằm trong ${CODEX_HOME:-~/.codex}/skills/.
GSTACK_STATE_ROOTThư mục trạng thái của gstack; /spec lưu spec vào $GSTACK_STATE_ROOT/projects/$SLUG/specs/.

Cách tích hợp và sử dụng

  1. Bắt đầu bằng /office-hoursMô tả thứ bạn định làm. Skill hỏi về vấn đề cụ thể, phản biện cách đặt bài toán, đưa các hướng triển khai và viết design doc cho các skill sau đọc.
  2. Soát thiết kế giao diệnTrước khi viết mã, chạy /plan-design-review để chấm kế hoạch theo từng khía cạnh thiết kế. Khi sản phẩm đã chạy, dùng /design-review để soát và sửa kèm ảnh trước, sau. Cần dựng hệ thống thiết kế từ đầu thì dùng /design-consultation.
  3. Review nhánh đang làmChạy /review trên nhánh có thay đổi. Lỗi rõ ràng được sửa tự động, các vấn đề cần quyết định được hỏi lại bạn.
  4. Kiểm thửChạy /qa kèm URL staging, ví dụ /qa https://staging.myapp.com, để skill mở trình duyệt, bấm qua các luồng, tái hiện lỗi và sửa. Muốn chỉ nhận báo cáo thì dùng /qa-only.
  5. Phát hành/ship đồng bộ main, chạy test, soát độ phủ rồi push và mở PR. /land-and-deploy gộp PR, chờ CI và deploy, kiểm tra tình trạng production.
  6. Chạy trọn chuỗi review kế hoạch/autoplan chạy lần lượt lượt review CEO, thiết kế, DX, kỹ thuật và chỉ hỏi bạn những quyết định mang tính lựa chọn.

Cập nhật và sao lưu

Cập nhật bằng lệnh /gstack-upgrade; lệnh này làm mới mọi bản cài đã đăng ký. Mỗi phiên Claude Code có một lượt kiểm tra cập nhật, giới hạn một lần mỗi giờ. Bản cài mới theo kênh stable (bản phát hành có tag); chuyển kênh bằng gstack-config set update_channel main hoặc stable. Trên Windows không bật Developer Mode, cần chạy lại ./setup sau mỗi lần git pull vì setup chép file thay cho symlink.

README không nêu quy trình sao lưu. Dữ liệu cục bộ gồm cấu hình, những gì /learn ghi nhớ và spec lưu trong thư mục trạng thái của gstack. Gỡ cài đặt theo docs/uninstall.md.

Câu hỏi thường gặp

Chỉ muốn dùng nhóm lệnh thiết kế của gstack thì có cài riêng được không?

README chỉ hướng dẫn cài cả bộ bằng ./setup, không nêu cách cài riêng một nhóm lệnh. Phần troubleshooting có nhắc tới việc tắt skill, chi tiết nằm trong docs/troubleshooting.md.

/plan-design-review khác /design-review ở điểm nào?

/plan-design-review chạy ở giai đoạn kế hoạch, trước khi có mã: chấm điểm và sửa bản kế hoạch. /design-review chạy sau khi có sản phẩm: làm cùng lượt soát rồi sửa trực tiếp, mỗi sửa đổi một commit kèm ảnh trước và sau.

gstack có gửi mã của tôi đi đâu không?

Theo README, telemetry tắt mặc định. Review từ bên ngoài bật mặc định và gửi mã tới Codex hoặc Claude Code bằng tài khoản của bạn; lần đầu có in thông báo. Lệnh gstack-egress list liệt kê mọi lần gửi ra ngoài.

Dùng gstack trên Windows có ổn không?

README ghi gstack chạy trên Windows 11 qua Git Bash hoặc WSL nhưng chỉ cam kết mức tối thiểu. Cần cả Bun và Node.js. Nếu bật Smart App Control, các binary tự build bị chặn; cách xử lý được nêu là chạy trong WSL hoặc tắt Smart App Control.

Kênh stable và main khác nhau thế nào?

stable chỉ nhận bản phát hành có tag, theo README là thứ Hai và thứ Năm, kèm bản vá bảo mật đã kiểm chứng. main nhận mọi lần gộp mã. Bản cài mới mặc định theo stable.

Ứng dụng liên quan

Miễn trừ trách nhiệm

Tino không phát triển, không sở hữu và không liên kết với gstack hay nhóm phát triển garrytan. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.

gstack được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.

Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.