shipfast-mcp

shipfast-mcp

将 PO 与 AI 之间的工作流程打包为 MCP 服务。
PO 决定范围并验收。协调器负责协调、提议和反驳。专业工作由按项目组建的部门承担，每个部门都是一个子 Agent。

介绍页面 · PyPI · 文档 · 发行说明

一个模型上下文协议服务，可将产品负责人和 AI Agent 之间的波次式工作流程带入任何技术栈：协调器负责协调和评审，项目专属部门作为子 Agent，使用单一决策日志、经过验证的质量门禁，并支持三方合并升级。

目录

• 🚀 快速开始
• 🛠️ 安装
• 📦 功能
• 🤝 如何贡献
• 💬 社区与支持
• 👥 仓库贡献者
• ⚖️ 许可证
• 🌟 Star 历史

---

快速开始

需要 uv。

#	步骤	命令
1	安装 uv	curl -LsSf https://astral.sh/uv/install.sh | sh
2	将 shipfast 添加到 Claude Code	/plugin install shipfast --marketplace QuocTang/shipfast-mcp
3	调用 init 提示词（新仓库）或 adopt（已有代码的项目）	/mcp__shipfast__init
4	按问题编号回答	W01-02: A；同意范围时说 "chốt"
5	有新版本时升级	/mcp__shipfast__upgrade

在 Claude Code 中运行一次 init（简略版）：

> /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.md

安装

工具	安装方法
Claude Code（插件）	/plugin install shipfast --marketplace QuocTang/shipfast-mcp
Claude Code（MCP）	claude mcp add shipfast -- uvx shipfast-mcp
Cursor、VS Code、Codex 和其他 MCP 客户端	stdio 服务，使用 uvx 命令，参数为 shipfast-mcp

客户端读取 mcpServers 的 JSON 配置：

{
  "mcpServers": {
    "shipfast": { "command": "uvx", "args": ["shipfast-mcp"] }
  }
}

固定版本：uvx [email protected]。

功能

一个 wave 的生命周期

📥 Intake → 🗣️ Discussion → ✅ Scope lock → 🔨 Build → 🧹 Cleanup → 🧪 Acceptance → 🚀 Release

步骤	工作内容
Intake	汇总工作事项，每个问题附带方案
Discussion	协调器提出建议并进行反驳，征询各部门意见；PO 拍板
Scope lock	PO 说“chốt”；范围冻结，变更通过 CR 处理
Build	负责部门按条目构建
Cleanup	清理无用代码和不一致的文档
Acceptance	QA 独立于负责构建的部门；实际运行质量门禁
Release	发布、总结经验并结束 wave

拍板模式	适用情况
PO 拍板	默认
直接拍板	wave 较小且需求明确
委派决策	PO 将拍板权交给各部门之间的辩论；协调器担任主席

MCP 组件

类型	名称	用途
🔧 工具	scaffold_project	构建 CLAUDE.md、docs/（wave、backlog、决策日志、组织结构）和 skill .claude/skills/shipfast-*；先试运行，不覆盖现有内容
🔧 工具	upgrade	通过三方合并将框架升级到新版本
🔧 工具	status、check	查看正在运行的 wave、等待 PO 处理的事项，以及项目档案是否偏离
🔧 工具	refresh_departments	升级后，根据新模板刷新部门 subagent 文件
🔧 工具	create_department	根据项目创建部门：档案位于 docs/departments/<mã>/，subagent 位于 .claude/agents/dept-<mã>.md
🔧 工具	open_wave、new_decision、next_code	开启 wave、记录决策、分配不重复的编号
🔧 工具	read_guide	面向用户的指南文档
💬 提示词	init、adopt、upgrade	入口
📚 资源	skill://shipfast-*/SKILL.md	6 个 skill：基础规则、初始化、应用、运行 wave、讨论、升级
📚 资源	shipfast://guide/*	入门、组织结构、意义、演进和升级

升级框架

项目保留 .shipfast/manifest.json 和 .shipfast/base/（上次使用的框架副本）。upgrade 会对比三个版本：原始版本、项目版本和新版本。

情况	结果
项目未修改文件	替换为新版本
双方修改了不同位置	自动合并
双方修改了相同位置	保留实际文件；在 .shipfast/pending/ 中生成带有冲突标记的合并版本，供审核
wave、backlog 和决策日志表	保持不变

指南

文章	文件
从哪里开始	start.md
如何组织	organization.md
意义与目的	purpose.md
后续演进与升级	evolve.md
发布说明	changelog.md

如何贡献

贡献内容应是在真实项目中验证过、适用于所有技术栈的实践方法。

1. Fork 仓库。
2. 创建新分支进行修改。
3. 提交 Pull Request：描述遇到的问题、解决方法，以及来自真实项目的证据。

本地开发：

uv sync
uv run pytest
uv run shipfast-mcp

知识库位于 src/shipfast_mcp/knowledge/：project/（构建到项目中的框架）、department/（部门档案和 subagent）、skills/、guide/。Landing page 位于 site/（site/README.md）。设计决策见 docs/decisions/README.md。

社区与支持

• 报告问题、提出建议：GitHub Issues。
• 为仓库加星（⭐），以关注最新发布版本。

仓库贡献者

由 contrib.rocks 制作。

许可证

MIT 许可证。详情请参阅 LICENSE。

Star 历史