快速开始

Spec Coding MCP 是一个本地 MCP server。安装后可以注册到 Codex、Claude Code、OpenCode，让 AI 编程工具通过 MCP 读取和生成 specs。

安装

npm install -g @dev_xiaoyun/spec-coding-mcp
specc init

specc init 会扫描本机已安装的 AI 编程工具，并用交互式选择把 MCP server 注册进去。

手动配置 Codex

如果需要手动配置，可以使用 Node 直连入口：

[mcp_servers.spec-coding]
command = "C:\\nvm4w\\nodejs\\node.exe"
args = ["C:\\nvm4w\\nodejs\\node_modules\\@dev_xiaoyun\\spec-coding-mcp\\dist\\index.js"]

路径需要按本机 Node 全局安装目录调整。

初始化项目 specs

在目标项目里调用 MCP 工具：

spec_init

它会创建：

specs/
  README.md
  guidance/
  review/
  active/
  todo/
  done/

旧项目接入

旧项目第一次接入时，先让 MCP 从源码反推规格：

spec_generate_from_source

然后阅读 specs/review/source-inventory.md 和 specs/review/*.md，把源码事实修正成真实业务规格。

新需求开发

新需求可以先创建 active spec：

spec_create

用户审阅并修改 specs/active/*.md 后，让 AI 调用：

spec_context

AI 读取上下文后实现代码和测试。验证通过后调用：

spec_checkpoint

记录本次完成的 TODO、变更文件、验证结果、风险和阻塞。全部完成后调用：

spec_done

如果需要更正式的阶段回顾，可以调用：

spec_review_result

spec_context 会附带当前 spec/TODO、下一步建议、guidance 索引和必要执行护栏。工程、UI/UX、spec 写作等原则详情按需用 spec_guidance_list / spec_guidance_read 读取。

执行清单任务

短任务可以用执行清单表达：

spec_todo

它会创建 specs/todo/*.md。也可以直接在 active spec 里写：

## 执行清单

- [ ] 定位相关实现。
- [ ] 更新测试。
- [ ] 运行验证。

spec_context 会把未勾选 TODO 提取出来，要求 AI 按顺序执行并在完成后勾选。