用 GitHub Spec-Kit + uv + Qwen 开启 AI 驱动的规格先行开发

写代码之前，先写“宪法”？没错，这就是 Spec-Driven Development（规格驱动开发） 的核心理念。

在 AI 编程助手日益普及的今天，我们仍然常常陷入“边写边改”的混沌开发模式——prompt 写得模糊，AI 生成的代码反复返工，最终项目结构混乱、质量不可控。

有没有一种方式，能让 AI 在清晰的规则和目标下系统化地生成高质量代码？

答案是：GitHub 官方最新推出的 Spec-Kit 工具包，配合现代 Python 包管理器 uv 与国产大模型 Qwen（通义千问），让你真正实现 “先写规格，再写代码” 的 AI-native 开发流程。

🌟 什么是 Spec-Driven Development？

传统开发中，代码是国王，规格只是脚手架；而在 Spec-Driven Development 中，规格本身就是可执行的蓝图。

Spec-Kit 提出了一套结构化开发流程，通过以下五个核心命令，引导 AI 助手逐步完成从理念到实现的全过程：

  1. /speckit.constitution：定义项目“宪法”——编码规范、测试标准、性能要求等。
  2. /speckit.specify：描述“要做什么”和“为什么做”，聚焦用户需求，不涉及技术细节。
  3. /speckit.plan：指定技术栈（如 FastAPI + SQLite + React），给出架构方案。
  4. /speckit.tasks：将计划拆解为可执行的任务列表，带依赖关系和文件路径。
  5. /speckit.implement：AI 自动按任务顺序生成代码，支持并行执行。

这不是“一键生成”，而是多阶段、可验证、可回溯的工程化 AI 协作。

🛠️ 在 Windows 上快速上手（使用 uv + PowerShell）

你不需要手动下载 GitHub Release 中的 ZIP 包。借助 uv（超快的 Python 包安装器），只需一条命令即可全局安装 Spec-Kit CLI：

1
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

✅ 确保你已安装 uv 和 Git。

验证安装：

1
specify --help

初始化你的第一个 Spec 项目（以 Qwen 为例）

1
specify init my-photo-app --ai qwen --script ps
  • --ai qwen：指定使用 Qwen 作为 AI 助手（Qwen Code 已被官方支持 ✅）
  • --script ps：生成 PowerShell 脚本，完美适配 Windows 环境

项目初始化后，你会看到一个包含 .specify/ 目录的 Git 仓库，其中包含：

  • memory/constitution.md：项目宪法
  • specs/：功能规格
  • scripts/：自动化脚本（PowerShell 版）

🧠 如何与 Qwen 协作？

  1. 在项目根目录启动 Qwen Code（或支持 / 命令的 Qwen 客户端）
  2. 输入 /speckit.constitution，例如：
1
2
/speckit.constitution
创建注重代码简洁性、类型安全、FastAPI 最佳实践和日志可追溯性的开发原则。
  1. 接着用 /speckit.specify 描述需求：
1
2
3
/speckit.specify
构建一个本地照片管理工具，用户可创建相册，按日期分组，支持拖拽排序。
照片不上传云端，元数据存储在 SQLite 中。
  1. 再用 /speckit.plan 锁定技术栈：
1
2
/speckit.plan
使用 FastAPI 作为后端，SQLite 存储，前端用 HTMX + vanilla JS 实现拖拽。
  1. 最后 /speckit.tasks → /speckit.implement，让 Qwen 自动实现！

💡 为什么值得尝试？

  • 减少“Vibe Coding”：告别模糊 prompt，用结构化规格引导 AI。
  • 提升代码质量：通过“宪法”约束 AI 行为，避免过度工程。
  • 可维护性强：所有决策（需求、设计、任务）均有文档留存。
  • 国产友好：Qwen 已被官方支持，无需依赖国外模型。
  • 跨平台：Windows（PowerShell）、macOS、Linux 均可使用。

🚀 小结

Spec-Kit 不是一个模板生成器，而是一套AI 时代的软件工程方法论。它把“写清楚需求”这件事，变成了可执行、可验证、可迭代的工程资产。

如果你厌倦了 AI 生成一堆无法维护的“一次性代码”，不妨试试 Spec-Driven Development。

规格先行，代码自生。

🔗 相关资源

欢迎在评论区分享你的 Spec-Driven 项目经验！