shipfast
MCP server · Python · MIT

Quy trình làm việc giữa PO và AI, đóng gói thành MCP server

PO quyết định phạm vi và nghiệm thu. Orchestrator điều phối, đề xuất và phản biện. Việc chuyên môn do các bộ phận lập theo dự án đảm nhận, mỗi bộ phận là một subagent.

/plugin install shipfast --marketplace QuocTang/shipfast-mcp

Client MCP khác: uvx shipfast-mcp · gói trên PyPI

Xem ví dụHướng dẫn cài đặt
Quy trình

Vòng đời một wave

  1. 1/7IntakeGom việc, mỗi vấn đề kèm phương án
  2. 2/7DiscussionĐề xuất, phản biện, PO chốt
  3. 3/7Scope lockPO nói "chốt"
  4. 4/7BuildBộ phận build theo hạng mục
  5. 5/7CleanupDọn mã chết, tài liệu lệch
  6. 6/7AcceptanceQA độc lập, quality gate
  7. 7/7ReleaseRút kinh nghiệm, đóng wave
Vấn đề

Sáu lỗi thường gặp khi làm việc với AI

Viết code trước khi yêu cầu được làm rõ

Không viết code trước khi PO lock scope. Discussion kết thúc khi mọi vấn đề đã có kết luận.

Một phiên AI đảm nhận mọi việc, ít phản biện

Orchestrator điều phối và phản biện; mỗi lĩnh vực có bộ phận riêng đưa ý kiến chuyên môn.

Quyết định nằm rải rác trong hội thoại

Decision log ở một chỗ (SP, KT, QT); code và tài liệu chỉ dẫn mã.

Phiên mới mất bối cảnh

Trạng thái lưu trong file của repo; tool status cho biết wave đang ở bước nào.

Báo hoàn thành khi chưa kiểm chứng

Quality gate phải chạy thật; acceptance do subagent độc lập với bộ phận đã build thực hiện.

Cập nhật khung phải đối chiếu tay với repo mẫu

upgrade dùng three-way merge: giữ phần dự án đã sửa, nhận thay đổi mới của khung.

Cài đặt

Các bước bắt đầu

  1. 1

    Cài uv

    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 2

    Thêm shipfast vào client MCP

    /plugin install shipfast --marketplace QuocTang/shipfast-mcp
  3. 3

    Gọi prompt init hoặc adopt

    /mcp__shipfast__init
  4. 4

    Trả lời theo mã vấn đề

    Trả lời theo mã, ví dụ "W01-02: A"; nói "chốt" khi đồng ý phạm vi.

  5. 5

    Nâng cấp khi có bản mới

    /mcp__shipfast__upgrade
Ví dụ

Cách dùng từng prompt

Hội thoại đã rút gọn. Số liệu của upgrade lấy từ lần nâng một dự án thử từ 0.1.0 lên 0.2.0.

init · Repo mới

Repo trống quan-ly-kho, chưa chọn stack.

~/quan-ly-kho — claude
  1. > /mcp__shipfast__init

  2. shipfast - scaffold_project (MCP)(mode: "init", dry_run: true)

    34 file sẽ tạo, 0 file trùng

  3. Đã mở wave W01. Sản phẩm làm gì, cho ai dùng?

  4. > App quản lý kho cho cửa hàng nhỏ, hai vai: chủ cửa hàng và nhân viên.

  5. W01-01: nhập xuất kho, cảnh báo sắp hết, báo cáo tồn; in hoá đơn và đa chi nhánh để sau (BL-005, BL-006). W01-02 stack: đề xuất A (Next.js + Postgres). Phản biện: cần thêm runtime khi có job nền. W01-09: lập ba bộ phận PRODUCT, PLATFORM, TRUST.

  6. > W01-02: A, còn lại theo đề xuất. Chốt.

  7. shipfast - create_department (MCP)(code: "PLATFORM")

    docs/departments/platform/, .claude/agents/dept-platform.md

> Trả lời theo mã, ví dụ "W02-01: A"

Kết quả

  • CLAUDE.md, docs/ (wave, backlog, decision log, tổ chức), 6 skill trong .claude/skills/
  • 3 bộ phận PRODUCT, PLATFORM, TRUST: hồ sơ trong docs/, subagent trong .claude/agents/
  • SP-001 phạm vi bản đầu, KT-001 stack, QT-002 lập bộ phận
  • Khung code chạy được: lint, test, build xanh; trang health trả 200
  • W02 mở sẵn từ backlog: nhập xuất kho
quan-ly-kho/
├── CLAUDE.md
├── .claude/skills/shipfast-*
├── .claude/agents/dept-{product,platform,trust}.md
├── .shipfast/manifest.json
└── docs/
    ├── 04_waves/W01/  1-discussion … 5-acceptance
    └── 05_decisions/  SP-001 KT-001 QT-002