Cài skill, rồi nói muốn build gì.
Cần Node.js 22.14 trở lên và một coding agent: Claude Code, Codex, Cursor, hoặc Antigravity.
npx @manhquy/flow-skill@latestVersion hiện tại đi theo cặp: skill product v0.34.4, npm installer 0.7.11 trên @latest. Đừng npm i gói này — lệnh đó không copy skill. Cũng đừng pin version của skill khi cài qua npm.
Quá trình cài đặt: installer tự nhận diện agent, bạn chọn thư mục home, skill được đặt vào đó (ví dụ ~/.claude/skills/flow).
Sau đó restart agent. Chưa restart thì agent chưa biết skill tồn tại.
| Agent | Sau restart |
|---|---|
| Claude Code | gõ /flow |
| Codex CLI | restart một lần, rồi gõ $flow |
| Cursor | reload tool, mở skill flow |
| Antigravity | restart IDE hoặc agy, rồi /flow |
Kiểm tra thêm (không bắt buộc): bash ~/.claude/skills/flow/runner/flow.sh doctor phải in ra READY.
--help hiển thị cả hai số version (installer và skill). Xem Hai số version.
Bạn nhận được gì
Phần tiêu đề “Bạn nhận được gì”Ba điều bạn nhận được. Điều đầu tiên có ngay sau npx. Hai điều sau có sau khi bạn vượt gate hoặc đóng card.
- Gate chặn trung thực.
/flow nextkhông mở stage tiếp theo nếu file còn trống, nội dung bịa đặt, hoặc scope bị bơm hạng để lách qua. Loại ý tưởng đó tại gate là kết quả hợp lệ. Gate chỉ từ chối phần việc — agent vẫn chạy bình thường. - Plan nằm trong repo, có được khi bạn vượt gate. Sáu file dưới
flow/, rồi card dướicards/. Session khác mở lên là làm tiếp được ngay. Cài đặt xong chưa có những file này. - Hoàn thành nghĩa là thứ đó thật sự tồn tại. URL đang chạy, CLI chạy được, API import được, hoặc skill đã chạy thật. Không phải “tests pass”.
Lần chạy đầu: một lệnh, một restart, một kiểm
Phần tiêu đề “Lần chạy đầu: một lệnh, một restart, một kiểm”npx @manhquy/flow-skill@latest# restart agent# trong thư mục project:Tôi muốn build app quản lý kho cho cửa hàng.# hoặc gõ /flow (Codex: $flow)Chat là cửa chính. Lệnh /flow gõ tay luôn được ưu tiên. Concierge hỏi một câu xin phép, rồi đề xuất một hành động tiếp theo. Routing đáng tin cậy trên Claude; trên Codex hoặc Antigravity, hãy coi chat chỉ là best-effort và gõ lệnh trực tiếp. Xem lưu ý đầy đủ tại Dùng chat Concierge.
Hoàn thành trang này khi: skill đã có trên máy, agent đã restart, bạn đã nói muốn build gì hoặc đã gõ /flow, và harness đã trả về trạng thái, hành động tiếp theo, hoặc kết quả gate.
Bản đầy đủ, gồm cả demo “Xem gate từ chối”: Cài đặt và lần chạy đầu.
Lệnh hằng ngày
Phần tiêu đề “Lệnh hằng ngày”| Bạn muốn | Gõ |
|---|---|
| Bạn đang ở đâu? | /flow |
| Đi tiếp, hoặc bị chặn rõ ràng | /flow next |
| Tạo một card build | /flow card |
| Chứng minh nó tồn tại | /flow check C-001 |
| Đánh giá codebase có sẵn | /flow assess |
| Kiểm tra máy | /flow doctor |
Codex dùng $flow. Bảng đầy đủ: Lệnh. /flow auto là nâng cao; xem Khi việc phải dừng.
Các luồng công việc
Phần tiêu đề “Các luồng công việc”Idea → Research → Scope → PRD → ADR → Contract, rồi card, rồi Retro. Mỗi stage có file tương ứng (flow/00-idea.md … flow/05-contract.md) — đó là tên file, không phải tiêu đề.
Contract là stage duy nhất không được skip. Xem Vì sao contract không bao giờ được skip và Khi việc phải dừng.
Với repo có sẵn, bắt đầu bằng /flow assess (Assess brownfield). Teach và work chỉ khác nhau ở một câu hỏi xin phép; gate thì giống hệt nhau (Teach và work).
Walkthrough đầy đủ không nằm ở trang này. Đi hết một dự án mẫu.
Khi bị kẹt
Phần tiêu đề “Khi bị kẹt”- Tiếp tục dự án đang dở → Tiếp tục giữa dự án
- Gỡ khóa session cũ → Mở khóa phiên cũ
- Sửa lỗi cài đặt → Khắc phục cài đặt
Đọc thêm
Phần tiêu đề “Đọc thêm”- Hai lớp chạy thế nào → Harness hai lớp
- Vì sao “tests pass” chưa phải là hoàn thành → Hoàn thành nghĩa là bằng chứng thế giới thật
- Khi việc phải dừng → Khi việc phải dừng
- Vì sao hai số version → Hai số version
- Kiến trúc → Ba lớp
- Lệnh, Thuật ngữ, Nhật ký thay đổi
- Nâng cao (auto, attest, engine phụ) → Điều phối agent
Nếu bạn chỉ cần cài và chạy, đọc tới đây là đủ.