QuocTang/shipfast-mcp

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.
Trang giới thiệu · PyPI · Tài liệu · Ghi chú phát hành
> A Model Context Protocol server that brings a wave-based working process between a product owner and AI agents to any stack: an orchestrator that coordinates and critiques, project-specific departments as subagents, a single decision log, verified quality gates, and three-way-merge upgrades.
Table of Contents
- 🚀 Quick Start
- 🛠️ Installation
- 📦 Features
- 🤝 How to Contribute
- 💬 Community & Support
- 👥 Repo Contributors
- ⚖️ License
- 🌟 Star History
---
Quick Start
Cần uv.
| # | Bước | Lệnh |
|---|---|---|
| 1 | Cài uv | curl -LsSf https://astral.sh/uv/install.sh \| sh |
| 2 | Thêm shipfast vào Claude Code | /plugin install shipfast --marketplace QuocTang/shipfast-mcp |
| 3 | Gọi prompt init (repo mới) hoặc adopt (dự án đang có code) | /mcp__shipfast__init |
| 4 | Trả lời theo mã vấn đề | W01-02: A; nói **"chốt"** khi đồng ý phạm vi |
| 5 | Nâng cấp khi có bản mới | /mcp__shipfast__upgrade |
Một phiên init trong Claude Code (rút gọn):
Installation
| Công cụ | Cách cài |
|---|---|
| Claude Code (plugin) | /plugin install shipfast --marketplace QuocTang/shipfast-mcp |
| Claude Code (MCP) | claude mcp add shipfast -- uvx shipfast-mcp |
| Cursor, VS Code, Codex và client MCP khác | Server stdio, lệnh uvx, tham số shipfast-mcp |
Cấu hình dạng JSON cho client đọc mcpServers:
Ghim phiên bản: uvx shipfast-mcp@0.2.2.
Features
Vòng đời một wave
| Bước | Việc |
|---|---|
| Intake | Gom việc, mỗi vấn đề kèm phương án |
| Discussion | Orchestrator đề xuất và phản biện, lấy ý kiến bộ phận; PO chốt |
| Scope lock | PO nói "chốt"; phạm vi đóng băng, đổi qua CR |
| Build | Bộ phận phụ trách build theo hạng mục |
| Cleanup | Dọn mã chết, tài liệu lệch |
| Acceptance | QA độc lập với bộ phận đã build; quality gate chạy thật |
| Release | Phát hành, rút kinh nghiệm, đóng wave |
| Chế độ chốt | Khi nào |
|---|---|
| PO chốt | Mặc định |
| Chốt thẳng | Wave nhỏ, yêu cầu đã rõ |
| Delegation | PO giao quyền chốt cho debate giữa các bộ phận; Orchestrator làm Chủ toạ |
Thành phần MCP
| Loại | Tên | Việc |
|---|---|---|
| 🔧 Tool | scaffold_project | Dựng CLAUDE.md, docs/ (wave, backlog, decision log, tổ chức) và skill .claude/skills/shipfast-*; dry run trước, không ghi đè |
| 🔧 Tool | upgrade | Nâng khung lên phiên bản mới bằng three-way merge |
| 🔧 Tool | status, check | Wave nào đang chạy, chờ PO điều gì; hồ sơ có lệch không |
| 🔧 Tool | refresh_departments | Làm mới file subagent bộ phận theo mẫu mới sau khi nâng cấp |
| 🔧 Tool | create_department | Lập bộ phận theo dự án: hồ sơ docs/departments/ /, subagent .claude/agents/dept- .md |
| 🔧 Tool | open_wave, new_decision, next_code | Mở wave, ghi quyết định, cấp mã không trùng |
| 🔧 Tool | read_guide | Tài liệu hướng dẫn cho người |