SpecForge

🇨🇳 中文

🇺🇸 English
🇪🇸 Español
🇧🇷 Português
🇫🇷 Français
🇩🇪 Deutsch

🇨🇳 中文

🇺🇸 English
🇪🇸 Español
🇧🇷 Português
🇫🇷 Français
🇩🇪 Deutsch

Appearance

快速开始 ​

SpecForge 是为你的 AI 工具设计的插件，帮助你规划、追踪和验证软件功能。你不需要在每次对话中重复自己——只需创建一个规格（spec，一个简短的计划加上"完成"清单），你的 AI 会自动遵循它。

前提条件 ​

兼容的 AI 代理 ​

SpecForge 支持任何支持 Model Context Protocol (MCP) 的工具：

代理安装方式链接
Claude Desktop编辑配置文件Anthropic
Claude Codeclaude mcp add 命令Anthropic
Cursor编辑 ~/.cursor/mcp.jsonCursor
Windsurf编辑 ~/.codeium/windsurf/mcp_config.jsonCodeium
Gemini CLI编辑 ~/.gemini/settings.jsonGoogle
ChatGPT Desktop编辑配置文件 — 需要 Plus 或 Pro
Cline（VS Code）Cline 设置 → MCP Servers

安装 ​

所有工具的配置块相同 — 只有文件位置不同：

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

Claude Desktop ​

第 1 步. 在你的电脑上打开 Claude Desktop。

第 2 步. 进入 Claude 菜单 → 设置 → 开发者 标签页 → 点击 编辑配置。

这会在你的文本编辑器中打开配置文件。如果文件为空，从 {} 开始。

第 3 步. 将上面的配置块粘贴到 "mcpServers" 中，保存文件。

第 4 步. 完全退出并重新打开 Claude Desktop。

第 5 步. 打开一个新对话 — SpecForge 会出现在工具面板中（🔌）。

Claude Code ​

bash
claude mcp add specforge -- npx -y specforge-mcp@latest

重启 Claude Code，SpecForge 将在你的下一个会话中可用。Claude Code 文档 →

ChatGPT Desktop ​

打开或创建配置文件：

  • Mac： ~/Library/Application Support/ChatGPT/config.json
  • Windows： %APPDATA%\ChatGPT\config.json

将配置块粘贴到 "mcpServers" 中，保存并重启 ChatGPT。需要 ChatGPT Plus 或 Pro。

Cursor ​

打开或创建 ~/.cursor/mcp.json 并粘贴配置块。然后重启 Cursor。Cursor 文档 →

Windsurf ​

打开或创建 ~/.codeium/windsurf/mcp_config.json 并粘贴配置块。然后重启 Windsurf。Windsurf 文档 →

Gemini CLI ​

打开或创建 ~/.gemini/settings.json 并粘贴配置块。然后重启 Gemini CLI。Gemini CLI →

Cline（VS Code 插件） ​

在安装了 Cline 的 VS Code 中：打开 Cline 侧边栏 → 点击 MCP Servers → 粘贴配置块。Cline →

你的第一个项目 ​

第 1 步 — 验证 SpecForge 是否正常工作 ​

在你的 AI 代理（Claude Desktop、Cursor、Windsurf 等）中打开一个新对话并输入：

"列出所有 specforge 工具"

你应该看到 59 个以上工具的列表。如果没有显示，请返回安装步骤 — 代理可能需要完全重启。

第 2 步 — 初始化你的项目 ​

告诉你的 AI 代理你的项目文件夹路径：

"使用 specforge 初始化我在 /Users/yourname/projects/my-app 的项目"

将 /Users/yourname/projects/my-app 替换为你项目的实际文件夹路径。

SpecForge 会扫描目录并自动检测你的语言、框架、包管理器和架构。它会返回一个 projectId（例如 proj_abc123）— 保存它，下一步会用到。

第 3 步 — 创建你的第一个规格 ​

告诉 Claude 你想构建什么功能：

"为项目 proj_abc123 创建一个添加 Google OAuth 用户登录的规格"

SpecForge 会创建一个规格（spec）— 一个简短的文档，包含逐步计划和"完成"的检查清单。所有内容都保存在你的项目文件夹中。

第 4 步 — 在规格引导下构建 ​

像往常一样继续与你的 AI 代理对话。规格充当开发契约 — 代理读取它、遵循它，并根据它检查自己的工作。

当你认为完成时，进行验证：

"根据 /Users/yourname/projects/my-app/src 的代码验证规格 SPEC-001"

第 5 步 — 检测漂移 ​

随着代码库的演进，保持规格同步：

"检查我的实现是否仍然符合 SPEC-001"

SpecForge 会报告哪些已完成、哪些缺失，以及哪些偏离了原始计划 （"漂移"drift — 指代码不再符合最初约定的情况）。

下一步 ​