实战！基于SPEC的AI开发

规范驱动开发颠覆了传统软件开发的模式 。几十年来，代码一直是王道——规范只是我们搭建的脚手架，一旦“真正的”编码工作开始，就被丢弃。规范驱动开发改变了这一点： 规范变得可执行 ，直接生成可执行的实现，而不仅仅是指导它们。

上面这段话来自spec-kit的仓库，简单介绍了基于Spec开发的意义。在传统依赖AI写代码时，我们往往直接发出指令，AI则遵循指令对代码进行修改，这样至少我发现的就有两个问题：

一是对于大型任务的指令遵循效果差，必须人为细化任务，但是人为细化往往还有所遗漏；二是由于个人提示词撰写水平能力的不同，AI写出的代码也良莠不齐。

而基于Spec编程，可能给了我们一个全新选择。

啥是基于Spec编程？

简单来说，在开始编程之前，花大量的时间和AI讨论你想要的产品的需求，实现，技术等，明确你想整出个什么玩意，然后根据这个需求再进行设计和任务拆分，最后严格按照任务顺序进行开发

这一篇先介绍我比较习惯的一个MCP工具，项目地址：https://github.com/Pimzino/spec-workflow-mcp

~~我是不会告诉你原本打算一次性写两个工具然后犯懒的~~

安装

Claude Code

一行命令安装

1	claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest

CODEX

编辑~/.codex/config.toml，

1
2
3

[mcp_servers.spec-workflow-mcp]
command = "npx"
args = ["-y", "@pimzino/spec-workflow-mcp@latest"]

通用安装

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
    }
  }
}

‍

在项目文件夹下新建一个 .spec-workflow 文件夹，文件夹下新建一个 config.toml ，写入下面内容。多个项目的话记得改面板端口


# Dashboard port (1024-65535)
port = 3456

# Auto-start dashboard with MCP server
autoStartDashboard = true

# Run dashboard-only mode
dashboardOnly = false

# Interface language
# Options: en, ja, zh, es, pt, de, fr, ru, it, ko, ar
lang = "zh"

# Sound notifications (VSCode extension only)
[notifications]
enabled = true
volume = 0.5

# Advanced settings
[advanced]
# WebSocket reconnection attempts
maxReconnectAttempts = 10

# File watcher settings
[watcher]
enabled = true
debounceMs = 3000

使用

官方给了一页的示例:https://github.com/Pimzino/spec-workflow-mcp/blob/main/docs/PROMPTING-GUIDE.md

从个人使用上来说，一般还是得强调一下，请使用spec-workflow-mcp工具

生成指导文档

指导文档（steering documents）是用来规定整个项目的文档

比如

1	请使用spec-workflow-mcp工具帮我生成一个steering documents，我希望写一个程序，使用纯HTML单文件，实现IP信息查询和Whois查询功能，使用免费的API

然后在AI一顿操作后，会首先生成一个product.md文件，这个文档会定义这个项目到底干嘛的，有什么用

然后让我们打开http://IP:端口/#/approvals，会出现一个类似下面这种审批申请，点击审阅和注释查看是否满足你的要求，满足就快速审批，想修改就直接滑动修改的地方给出意见，Preview是查看（只有这个页面能用沉浸式翻译...）,Annotate是审阅，Changes在多次审批之间可以查看和上次的区别