Claude Code 中使用 Spec Kit

参考文章:使用局限

在 Claude Code 中使用 Spec Kit(由 GitHub 官方推出的规格驱动开发工具包),可以实现"先写规范、再生成代码"的高质量 AI 编程流程。以下是完整的安装与使用指南:

一、前置依赖

确保系统已安装以下工具:

Git

Python ≥ 3.8(推荐 3.10+)

uv(新一代 Python 包管理器,比 pip 更快)

💡 Spec Kit 使用 uv 而非 npm,与 OpenSpec 不同。

二、安装 Spec Kit

1. 安装 uv(若未安装)

复制代码
# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

然后重启终端或运行:

复制代码
source ~/.cargo/env  # Linux/macOS

2. 安装 Spec Kit CLI(通过 uvx)

复制代码
uvx --from git+https://github.com/github/spec-kit.git specify --help

⚠️ 注意:Spec Kit 的命令行工具叫 specify,不是 speckit。

你也可以全局安装以便重复使用:

复制代码
uv tool install --from git+https://github.com/github/spec-kit.git specify

验证安装:

复制代码
specify --version

三、在项目中初始化 Spec Kit(与 Claude Code 集成)

进入你的项目目录:

复制代码
cd your-project

初始化 Spec Kit 项目:

复制代码
specify init <PROJECT_NAME>

例如:

复制代码
specify init my-api-service

按提示填写:

项目描述

技术栈(如 Node.js + Express, Python + FastAPI 等)

功能需求

✅ 初始化后,会自动生成:

  • spec/ 目录:包含 plan.md(开发计划)、tasks.md(任务列表)、schema/(数据结构)
  • .git/ 自动初始化(若未存在)
  • 与 Claude Code 兼容的上下文结构

四、在 Claude Code 中使用 Spec Kit 规范

方法一:直接调用 specify 命令生成任务,再用 Claude Code 实现

复制代码
# 生成具体开发任务
specify plan

# 输出任务后,在 Claude Code 中逐条实现

方法二:让 Claude Code 读取 spec/ 目录内容作为上下文

Claude Code 支持读取整个项目上下文。当你在 VS Code 中启用 Claude Code 插件 后:

  • 打开聊天窗口
  • 输入指令如:"根据 spec/plan.md 实现用户注册功能"
  • Claude Code 会自动参考 spec/ 下的规范生成符合要求的代码

🔑 关键:所有需求必须先写入 spec/,再交给 Claude Code 实现,避免"氛围编码"。

五、典型工作流(Spec Kit + Claude Code)

  1. 定义需求 → specify init
  2. 拆解任务 → specify plan
  3. 生成代码 → 在 Claude Code 中说:"按 spec/tasks.md 第3项实现 JWT 认证"
  4. 验证与测试 → specify verify(可选,需配置测试规范)
  5. 提交代码 → Claude Code 可自动 git add/commit

六、目录结构示例

复制代码
my-project/
├── spec/
│   ├── plan.md          # 整体开发计划
│   ├── tasks.md         # 具体任务清单
│   └── schema/
│       └── user.json    # 数据模型
├── src/                 # Claude Code 生成的代码放这里
└── README.md

📚 官方资源

GitHub 仓库:https://github.com/github/spec-kit

官方文档:README.md 中有详细 CLI 说明

CSDN 实战教程:Spec-Kit + Claude Code:规格驱动AI编程工程化实战

💡 小贴士

Spec Kit 不依赖任何在线服务,所有流程本地运行,隐私安全。

与 OpenSpec 类似,但 Spec Kit 是 GitHub 官方出品,更轻量、聚焦 CLI。

如果你已用 OpenSpec,也可同时使用 Spec Kit,两者理念一致,工具链互补。

相关推荐
weixin_468466858 小时前
从“看懂”到“做到”:视觉-语言-动作模型如何让机器人真正执行指令
人工智能·ai·机器人·大语言模型·前沿科技
效率工作实验室12 小时前
自定义Agent平台有哪些?灵活搭建专属AI智能体的方案
ai·自定义·agent·平台·平台有哪些
知了一笑13 小时前
人与AI互相效力:谁才是受益者?
ai·aigc·ai产品·ai工作流
一只游鱼13 小时前
LangGraph快速入门 —— Agent 是怎么转起来的
人工智能·ai·agent·langgraph
西索斯coding14 小时前
gpt-image-2.5-sunburst 和 gemini-3.1-flash-image 差多少?60 组项目素材的成功成本评测框架
java·linux·gpt·ai
wflynn17 小时前
Claude Sonnet 5自主选药选坐标完成小鼠脑部手术,更强模型拒绝执行
ai·技术
这是谁的博客?18 小时前
AI 加速器 RTL 数字系统设计深度解析:从 MAC 阵列 Verilog 实现到时序收敛与时钟功耗的芯片落地全链路
人工智能·macos·ai·verilog·数字ic设计·ai芯片·rtl
信息安全失业大专人员18 小时前
每日了解一个智能体-WorkBuddy
开发语言·ai·c#·智能体
OpenAnolis小助手18 小时前
龙蜥社区亮相 GOSIM AI Vision Forum 共话“Agentic Native”开源新
人工智能·ai·开源·操作系统·龙蜥社区·agent
恩喜玛生物19 小时前
03_GROMACS分子动力学实战:从 Factor Xa 输入准备到轨迹分析
ai