github / spec-kit

查看原文 / View Original 编辑 / Edit

github / spec-kit

🌱 Spec Kit Build high-quality software faster. An open source toolkit that allows you to focus on product scenarios and predictable outcomes instead of vibe coding every piece from scratch. 🌱 Spec Kit 更快地构建高质量软件。这是一个开源工具包，旨在让你专注于产品场景和可预测的结果，而不是从零开始进行“感觉编程”（vibe coding）。

🤔 What is Spec-Driven Development?

Spec-Driven Development flips the script on traditional software development. For decades, code has been king — specifications were just scaffolding we built and discarded once the “real work” of coding began. Spec-Driven Development changes this: specifications become executable, directly generating working implementations rather than just guiding them.

🤔 什么是规范驱动开发（Spec-Driven Development）？

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

⚡ Get Started

  1. Install Specify CLI Requires uv (install uv). Replace vX.Y.Z with the latest tag from Releases: uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z See the Installation Guide for alternative methods, verification, upgrade, and troubleshooting.

⚡ 快速开始

  1. 安装 Specify CLI 需要 uv（安装 uv）。将 vX.Y.Z 替换为 Releases 中的最新标签： uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z 查看安装指南以获取替代方法、验证、升级和故障排除信息。
  1. Initialize a project
specify init my-project --integration copilot
cd my-project

To check for updates or upgrade the installed CLI, use the self-management commands. See the Upgrade Guide for detailed scenarios and customization options.

  1. 初始化项目
specify init my-project --integration copilot
cd my-project

要检查更新或升级已安装的 CLI，请使用自管理命令。查看升级指南以获取详细场景和自定义选项。

  1. Establish project principles Launch your coding agent in the project directory. Most agents expose spec-kit as /speckit.* slash commands; Codex CLI in skills mode uses $speckit-* instead. Use the /speckit.constitution command to create your project’s governing principles and development guidelines that will guide all subsequent development. /speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements.

  2. 建立项目原则 在项目目录中启动你的编码代理。大多数代理将 spec-kit 暴露为 /speckit.* 斜杠命令；处于技能模式（skills mode）下的 Codex CLI 则使用 $speckit-*。使用 /speckit.constitution 命令创建项目的指导原则和开发准则，这将指导后续的所有开发工作。 /speckit.constitution 创建专注于代码质量、测试标准、用户体验一致性和性能要求的原则。

  1. Create the spec Use the /speckit.specify command to describe what you want to build. Focus on the what and why, not the tech stack. /speckit.specify Build an application that can help me organize my photos in separate photo albums. Albums are grouped by date and can be re-organized by dragging and dropping on the main page. Albums are never in other nested albums. Within each album, photos are previewed in a tile-like interface.

  2. 创建规范 使用 /speckit.specify 命令描述你想要构建的内容。专注于“做什么”和“为什么做”，而不是技术栈。 /speckit.specify 构建一个应用程序，帮助我将照片整理到不同的相册中。相册按日期分组，并可以在主页上通过拖放进行重新排序。相册不能嵌套在其他相册中。在每个相册内，照片以平铺界面预览。

  1. Create a technical implementation plan Use the /speckit.plan command to provide your tech stack and architecture choices. /speckit.plan The application uses Vite with minimal number of libraries. Use vanilla HTML, CSS, and JavaScript as much as possible. Images are not uploaded anywhere and metadata is stored in a local SQLite database.

  2. 创建技术实施计划 使用 /speckit.plan 命令提供你的技术栈和架构选择。 /speckit.plan 该应用程序使用 Vite，并尽可能减少库的使用。尽可能使用原生 HTML、CSS 和 JavaScript。图片不会上传到任何地方，元数据存储在本地 SQLite 数据库中。

  1. Break down into tasks Use /speckit.tasks to create an actionable task list from your implementation plan. /speckit.tasks

  2. 拆解任务 使用 /speckit.tasks 根据你的实施计划创建一个可执行的任务列表。 /speckit.tasks

  1. Execute implementation Use /speckit.implement to execute all tasks and build your feature according to the plan. /speckit.implement For detailed step-by-step instructions, see our comprehensive guide.

  2. 执行实施 使用 /speckit.implement 执行所有任务，并根据计划构建你的功能。 /speckit.implement 有关详细的分步说明，请参阅我们的综合指南。

📽️ Video Overview

Want to see Spec Kit in action? Watch our video overview!

📽️ 视频概览

想看看 Spec Kit 的实际操作吗？观看我们的视频概览！

🌍 Community

Explore community-contributed resources on the Spec Kit docs site:

  • Extensions — commands, hooks, and capabilities
  • Presets — template and terminology overrides
  • Walkthroughs — end-to-end SDD scenarios
  • Friends — projects that extend or build on Spec Kit

🌍 社区

在 Spec Kit 文档网站上探索社区贡献的资源：

  • 扩展（Extensions） — 命令、钩子和功能
  • 预设（Presets） — 模板和术语覆盖
  • 演练（Walkthroughs） — 端到端的 SDD 场景
  • 朋友（Friends） — 基于 Spec Kit 扩展或构建的项目

🤖 Supported AI Coding Agent Integrations

Spec Kit works with 30+ AI coding agents — both CLI tools and IDE-based assistants. See the full list with notes and usage details in the Supported AI Coding Agent Integrations guide. Run specify integration list to see all available integrations in your installed version.

🤖 支持的 AI 编码代理集成

Spec Kit 支持 30 多种 AI 编码代理，包括 CLI 工具和基于 IDE 的助手。在“支持的 AI 编码代理集成”指南中查看完整列表、注释和使用详情。运行 specify integration list 可查看你当前安装版本中所有可用的集成。

← 返回新闻列表 / Back to news list