Claude Code 实战指南(三):AI辅助开发工作流 Spec Workflow MCP教程

Claude Code 实战指南(三):AI辅助开发工作流 Spec Workflow MCP教程

本文将详细介绍如何在Claude Code CLI中配置和使用Spec Workflow MCP,这是一个用于AI辅助软件开发的结构化规范驱动开发工作流工具。

前提条件

  • 已安装Node.js和npm
  • 已安装Claude Code CLI
  • 有一个需要使用Spec Workflow的项目目录

配置步骤

1. 添加Spec Workflow MCP服务器

使用以下命令将Spec Workflow添加到Claude Code CLI的MCP配置中:

bash 复制代码
claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest -- /path/to/your/project

注意事项:

  • /path/to/your/project替换为您实际项目的路径
  • --分隔符确保路径传递给spec-workflow脚本,而不是npx

如果在Windows上遇到问题,可以尝试以下替代命令:

bash 复制代码
claude mcp add spec-workflow cmd.exe /c "npx @pimzino/spec-workflow-mcp@latest /path/to/your/project"

2. 启动Web仪表板(可选但推荐)

运行以下命令启动Web仪表板,用于监控和管理规范:

bash 复制代码
npx -y @pimzino/spec-workflow-mcp@latest /path/to/your/project --dashboard

❗注意: 如果启动的仪表盘针对当前文件夹,可以不加项目路径

bash 复制代码
npx -y @pimzino/spec-workflow-mcp@latest --dashboard

仪表板默认在http://localhost:50107启动

验证配置

验证Spec Workflow MCP是否正确配置:

bash 复制代码
claude mcp list

您应该能在列表中看到spec-workflow服务器

使用示例

在Claude Code CLI中与AI对话时,可以使用以下命令:

  • 创建规范:"Create a spec for 功能描述"
  • 列出规范:"List my specs"
  • 执行任务:"Execute task X.Y in spec spec-name"

审批流程

当创建规范或开始任务时,系统会提示您进行审批。访问http://localhost:50092/#/approvals查看待处理的审批请求。

看到有内容需要审批,可以点击去查看,是否同意

如果设计的方案不合理,让Claude 重新修改,直至满意。

再回到控制台上回复继续。

实际操作流程

  1. 创建规范:在Claude Code CLI中输入 "Create a spec for 您的需求"
  2. 检查规范内容:AI将生成规范内容
  3. 审批规范:通过Web仪表板进行审批
  4. 执行任务:要求AI执行规范中的特定任务
  5. 监控进度:通过仪表板实时查看任务状态

常见问题排查

  • 如果MCP服务器无法启动,检查Node.js和npm版本是否最新
  • 如果仪表板无法访问,确认端口50092未被占用
  • 如果命令执行出错,尝试添加--verbose参数查看详细日志

哇!现在您已成功驾驭Claude Code CLI与Spec Workflow MCP的强大组合,准备好用AI超能力turbo加速您的开发流程了吗?开发效率蹭蹭往上涨!

如果喜欢使用Claude Code开发,请关注我,持续更新最好用的技巧和秘笈~

项目GitHub仓库:https://github.com/Pimzino/spec-workflow-mcp

相关推荐
小白跃升坊11 小时前
Codex 增强部署:基于 Codex++ 接入 DeepSeek
ai·ai编程·codex·deepseek·ai coding·codex++
AlfredZhao11 小时前
GPT 省钱,不是别用最新模型,而是别浪费缓存
gpt·ai
doiito14 小时前
【Agent Harness】Gliding Horse 本体论系统设计:给 AI Agent 装上“语义大脑”
ai·rust·架构设计·系统设计·ai agent
码哥字节17 小时前
一周 30k+ stars 的 Skill 生态,3 个仓库代表 3 种工程师哲学
claude code·agent skills
小七-七牛开发者20 小时前
周一上线 | SpaceX 收购 Cursor、支付宝进入 AI 时代、DeepSeek 完成 500 亿元融资
ai·agent·token·glm·智谱·claudecode·ai coding·周一上线
doiito2 天前
【Agent Harness】为什么我把 JSON‑LD “编译成 DAG” 后,整个 Agent 平台立刻聪明了
ai·rust·架构设计·系统设计·ai agent
ServBay2 天前
Laravel Herd MCP 的替代,多语言与跨平台的 AI 本地开发选择
后端·ai编程·mcp
码哥字节2 天前
我把整个代码库喂给 Claude Code,工具超 50 个就静默丢失,这个坑太阴了
mcp·claude code·ai编程工具
xiezhr2 天前
折腾半小时,终于让AI 能直接帮我写飞书文档了
ai·飞书·ai agent·飞书cli·飞书文档