Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
Quy trình theo wave giữa PO và AI: khung tài liệu, skill, scaffold, nâng cấp three-way merge.
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ต้องเตรียมก่อน
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"shipfast": {
"command": "uvx",
"args": [
"shipfast-mcp"
]
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add shipfast -- uvx shipfast-mcpวางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"shipfast": {
"command": "uvx",
"args": [
"shipfast-mcp"
]
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"shipfast": {
"type": "stdio",
"command": "uvx",
"args": [
"shipfast-mcp"
]
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569
ชื่อใน registry ยืนยันด้วยบัญชี GitHub QuocTang ซึ่งเป็นเจ้าของ repo
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.3) เข้า registry 24 วันที่ผ่านมา
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย
ในหมวดเดียวกันมี Spec Driven Development, Remote Desktop Commander, NexusWindows
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Windows computer use in the background: desktop apps driven without your mouse or keyboard.
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
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.
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.md
| 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.
📥 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ạ |
| 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 |
| 💬 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 |
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 |
| 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 |
Đóng góp nên là cách làm đã chạy ở dự án thật và dùng được cho mọi stack.
Phát triển tại máy:
uv sync
uv run pytest uv run shipfast-mcp
Kho 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.
Made with contrib.rocks.
MIT License. See LICENSE for details.