规格工作流mcp

Name: 规格工作流mcp
Author: kingkongshot

作者：kingkongshot119 星标更新：2025-08-11

安装使用来源：spider==github.com

项目介绍

Spec Workflow MCP

英文 | 简体中文

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

为什么使用它？

❌ 没有 Spec Workflow

AI在任务之间随机跳跃，缺乏系统的方法
需求与实际代码实现脱节
文档分散，难以追踪项目进度
缺少设计决策记录

✅ 使用 Spec Workflow

AI按顺序完成任务，保持专注和上下文
用户故事到代码实现的完整可追溯性
标准化的文档模板，自动管理进度
每个阶段需要确认，确保正确的方向
持续进度：即使在新的对话中，也可以从上次停止的地方继续

快速开始

1. 安装（Claude 代码示例）

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

参见完整的安装指南以了解其他客户端的安装方法。

2. 开始新项目

"帮助我使用 spec workflow 创建用户认证系统"

3. 继续现有项目

"使用 spec workflow 检查 ./my-project"

AI会自动检测项目状态并从中继续。

工作流示例

1. 描述需求

你: "我需要构建一个用户认证系统"

2. AI创建结构化文档

AI: "我将帮助你创建用户认证的 spec workflow..."

📝 requirements.md - 用户故事和功能需求
🎨 design.md - 技术架构和设计决策
✅ tasks.md - 具体实施任务清单

3. 分步审查和实施

每个阶段后，AI都会请求你的确认，确保项目保持正确的方向。

文档组织

基本结构

my-project/specs/
├── requirements.md              # 需求：用户故事，功能规格
├── design.md                    # 设计：架构，API，数据模型
├── tasks.md                     # 任务：编号的实施步骤
└── .workflow-confirmations.json # 状态：自动进度跟踪

多模块项目

my-project/specs/
├── user-authentication/         # 认证模块
├── payment-system/             # 支付模块
└── notification-service/       # 通知模块

你可以指定任何目录："使用 spec workflow 在 ./src/features/auth 创建认证文档"

AI 使用指南

🤖 让 AI 更好地使用此工具

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

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

有了这个配置，AI将智能地使用 Spec Workflow 来管理整个开发过程。

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

将 ./specs 更改为你喜欢的文档目录路径

将 "English" 更改为你喜欢的文档语言（例如："Chinese"）

# Spec Workflow 使用指南

## 1. 检查项目进度
当用户提到继续之前的项目或不确定当前进度时，主动使用：
specs-workflow 工具，action.type="check" 和 path="./specs"

## 2. 文档语言
所有 spec workflow 文档应始终用英语编写，包括所有内容在需求、设计和任务文档中。

## 3. 文档目录
所有 spec workflow 文档应放置在 ./specs 目录中，以保持一致的项目文档组织。

##  4. 任务管理
始终使用以下方式管理任务进度：
specs-workflow 工具，action.type="complete_task" 和 taskNumber="当前任务编号"
按照工作流指导继续工作直到所有任务完成。

## 5. 最佳实践
- 主动检查进度：当用户说“从上次继续”，首先使用 check 查看当前状态
- 语言一致性：在整个项目文档中使用相同的语言
- 灵活结构：根据项目规模选择单模块或多模块组织
- 任务粒度：每个任务应在1-2小时内完成

安装

要求

Node.js ≥ v18.0.0
npm 或 yarn
Claude Desktop 或任何兼容 MCP 的客户端

在不同 MCP 客户端中安装

Claude Code（推荐）

使用 Claude CLI 添加 MCP 服务器：

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

Claude Desktop

添加到你的 Claude Desktop 配置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

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

Cursor

添加到你的 Cursor 配置（~/.cursor/config.json）：

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

Cline

使用 Cline 的 MCP 服务器管理 UI 添加服务器：

打开带有 Cline 扩展的 VS Code
打开 Cline 设置（齿轮图标）
导航到 MCP 服务器部分
添加新服务器：
- 命令：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": ["/绝对路径/to/specs-mcp/dist/index.js"]
    }
  }
}

</details>

链接

许可证

MIT 许可证