Spec Workflow Mcp

Spec Workflow MCP

English | 简体中文

引导 AI 通过结构化的 需求 → 设计 → 任务 工作流，系统地完成软件开发，确保代码实现与业务需求保持一致。

为什么要使用？

❌ 不使用 Spec Workflow

• AI 在任务间随意切换，缺乏系统性方法
• 需求与实际代码实现脱节
• 文档分散，难以跟踪项目进度
• 缺少设计决策记录

✅ 使用 Spec Workflow

• AI 按顺序完成任务，保持专注并延续上下文
• 从用户故事到代码实现的完整可追溯性
• 标准化文档模板，自动管理进度
• 每个阶段都需要确认，确保方向正确
• 进度持久化：即使开启新对话，也可以通过 check 从上次中断处继续

最近更新

v1.0.7

• 🎯 提升了大多数模型使用 spec workflow 管理任务的可靠性

v1.0.6

• ✨ 批量完成任务：一次完成多个任务，加快大型项目的进度

v1.0.5

• 🐛 修复边缘情况：区分“未找到任务”和“任务已完成”，避免工作流中断

v1.0.4

• ✅ 任务管理：新增任务完成跟踪，助力项目系统化推进

v1.0.3

• 🎉 首次发布：Requirements → Design → Tasks 核心工作流框架

快速开始

1. 安装（以 Claude Code 为例）

claude mcp add spec-workflow-mcp -s user -- npx -y spec-workflow-mcp@latest

其他客户端请参阅完整安装指南。

2. 开始新项目

"Help me use spec workflow to create a user authentication system"

3. 继续现有项目

"Use spec workflow to check ./my-project"

AI 会自动检测项目状态，并从上次中断处继续。

工作流示例

1. 描述需求

You: "I need to build a user authentication system"

2. AI 创建结构化文档

AI: "I'll help you create spec workflow for user authentication..."

📝 requirements.md - User stories and functional requirements
🎨 design.md - Technical architecture and design decisions
✅ tasks.md - Concrete implementation task list

3. 逐步审查并实施

每个阶段结束后，AI 都会在继续之前请求你确认，确保项目始终沿着正确方向推进。

文档组织

基本结构

my-project/specs/
├── requirements.md              # Requirements: user stories, functional specs
├── design.md                    # Design: architecture, APIs, data models
├── tasks.md                     # Tasks: numbered implementation steps
└── .workflow-confirmations.json # Status: automatic progress tracking

多模块项目

my-project/specs/
├── user-authentication/         # Auth module
├── payment-system/             # Payment module
└── notification-service/       # Notification module

你可以指定任意目录："Use spec workflow to create auth docs in ./src/features/auth"

AI 使用指南

🤖 让 AI 更好地使用此工具

强烈建议在 AI 助手配置中添加以下提示词。否则，AI 可能会：

• ❌ 不知道何时调用 Spec Workflow
• ❌ 忘记管理任务进度，导致工作混乱
• ❌ 不使用 Spec Workflow 进行系统化文档编写
• ❌ 无法持续跟踪项目状态

通过此配置，AI 将智能地使用 Spec Workflow 管理整个开发流程。

配置说明：请根据需要修改以下内容：

1. 将 ./specs 改为你首选的文档目录路径
2. 将“English”改为你首选的文档语言（例如“Chinese”）

# Spec Workflow Usage Guidelines

## 1. Check Project Progress
When user mentions continuing previous project or is unsure about current progress, proactively use:
specs-workflow tool with action.type="check" and path="./specs"

## 2. Documentation Language
All spec workflow documents should be written in English consistently, including all content in requirements, design, and task documents.

## 3. Documentation Directory
All spec workflow documents should be placed in ./specs directory to maintain consistent project documentation organization.

## 4. Task Management
Always use the following to manage task progress:
specs-workflow tool with action.type="complete_task" and taskNumber="current task number"
Follow the workflow guidance to continue working until all tasks are completed.

## 5. Best Practices
- Proactive progress check: When user says "continue from last time", first use check to see current status
- Language consistency: Use the same language throughout all project documents
- Flexible structure: Choose single-module or multi-module organization based on project scale
- Task granularity: Each task should be completable within 1-2 hours

安装

claude mcp add spec-workflow-mcp -s user -- npx -y spec-workflow-mcp@latest

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

使用 Cline 的 MCP 服务管理界面添加服务：

1. 打开装有 Cline 扩展的 VS Code
2. 打开 Cline 设置（齿轮图标）
3. 前往 MCP 服务部分
4. 添加新服务，并填写：
   • 命令：npx
   • 参数：-y spec-workflow-mcp@latest

Windsurf (Codeium)

将以下内容添加到 Windsurf 配置文件（~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"],
      "env": {},
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "transportType": "stdio"
    }
  }
}

VS Code（搭配 MCP 扩展）

将以下内容添加到 VS Code 设置（settings.json）：

{
  "mcp.servers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

Zed

将以下内容添加到 Zed 配置文件（~/.config/zed/settings.json）：

{
  "assistant": {
    "version": "2",
    "mcp": {
      "servers": {
        "spec-workflow": {
          "command": "npx",
          "args": ["-y", "spec-workflow-mcp@latest"]
        }
      }
    }
  }
}

从源码安装

git clone https://github.com/kingkongshot/specs-mcp.git
cd specs-mcp
npm install
npm run build

然后将以下内容添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "spec-workflow": {
      "command": "node",
      "args": ["/absolute/path/to/specs-mcp/dist/index.js"]
    }
  }
}

链接

• GitHub 仓库
• NPM 软件包
• 报告问题

许可证

MIT 许可证