io.github.QuocTang/shipfast-mcp
Quy trình theo wave giữa PO và AI: khung tài liệu, skill, scaffold, nâng cấp three-way merge.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
shipfast-mcpclaude mcp add shipfast-mcp -- uvx shipfast-mcp==0.2.3{
"mcpServers": {
"shipfast-mcp": {
"command": "uvx",
"args": [
"shipfast-mcp==0.2.3"
]
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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):
> /mcp__shipfast__init
● shipfast - scaffold_project (MCP)(mode: "init", dry_run: true)
└ 34 file sẽ tạo, 0 file trùng
● Đã mở wave W01. Sản phẩm làm gì, cho ai dùng?
> App quản lý kho cho cửa hàng nhỏ, hai vai: chủ cửa hàng và nhân viên.
● 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.
> W01-02: A, còn lại theo đề xuất. Chốt.
● shipfast - create_department (MCP)(code: "PLATFORM")
└ docs/departments/platform/, .claude/agents/dept-platform.mdInstallation
| 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:
{
"mcpServers": {
"shipfast": { "command": "uvx", "args": ["shipfast-mcp"] }
}
}Ghim phiên bản: uvx shipfast-mcp@0.2.2.
Features
Vòng đời một wave
📥 Intake → 🗣️ Discussion → ✅ Scope lock → 🔨 Build → 🧹 Cleanup → 🧪 Acceptance → 🚀 Release| 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/<mã>/, subagent .claude/agents/dept-<mã>.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 |
| 💬 Prompt | init, adopt, upgrade | Điểm vào |
| 📚 Resource | skill://shipfast-*/SKILL.md | 6 skill: luật nền, khởi tạo, áp dụng, chạy wave, debate, nâng cấp |
| 📚 Resource | shipfast://guide/* | Bắt đầu, tổ chức, ý nghĩa, phát triển và nâng cấp |
Nâng cấp khung
Dự án giữ .shipfast/manifest.json và .shipfast/base/ (bản khung lần trước). upgrade so ba bản: bản gốc, bản dự án, bản mới.
| Trường hợp | Kết quả |
|---|---|
| Dự án chưa sửa file | Thay bằng bản mới |
| Hai bên sửa khác chỗ | Gộp tự động |
| Hai bên sửa cùng chỗ | File thật giữ nguyên; bản gộp có dấu xung đột ở .shipfast/pending/ để duyệt |
| Bảng wave, backlog, decision log | Giữ nguyên |
Hướng dẫn
| Bài | File |
|---|---|
| Bắt đầu từ đâu | start.md |
| Tổ chức ra sao | organization.md |
| Ý nghĩa và mục đích | purpose.md |
| Phát triển tiếp và nâng cấp | evolve.md |
| Ghi chú phát hành | changelog.md |
How to Contribute
Đóng góp nên là cách làm đã chạy ở dự án thật và dùng được cho mọi stack.
- Fork repository.
- Tạo nhánh mới cho thay đổi.
- Gửi Pull Request: mô tả vấn đề gặp phải, cách làm, bằng chứng từ dự án thật.
Phát triển tại máy:
uv sync
uv run pytest
uv run shipfast-mcpKho tri thức nằm ở src/shipfast_mcp/knowledge/: project/ (khung dựng vào dự án), department/ (hồ sơ và subagent bộ phận), skills/, guide/. Landing page ở site/ (site/README.md). Quyết định thiết kế: docs/decisions/README.md.
Community & Support
- Báo lỗi, đề xuất: GitHub Issues.
- Gắn sao (⭐) repository để theo dõi các bản phát hành mới.
Repo Contributors
Made with contrib.rocks.
License
MIT License. See LICENSE for details.
Star History
Questions fréquentes
Qu'est-ce que io.github.QuocTang/shipfast-mcp ?
Quy trình theo wave giữa PO và AI: khung tài liệu, skill, scaffold, nâng cấp three-way merge.
Comment installer io.github.QuocTang/shipfast-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add shipfast-mcp -- uvx shipfast-mcp==0.2.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.QuocTang/shipfast-mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.QuocTang/shipfast-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.QuocTang/shipfast-mcp ?
Il est publié par QuocTang. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.