OpenSource-Hub

spec-kit

命令行工具

github/spec-kit

辅助规范驱动开发的AI工具包。

项目简介

Spec Kit 是开源 CLI 工具包,实现规范驱动开发。它提供创建规范、生成实施计划并配合 AI 编程助手执行任务的命令,帮助开发者聚焦产品场景与可预测成果。

README 预览

\n    \n    🌱 Spec Kit\n    Build high-quality software faster.\n\n\n\n    An open source toolkit that allows you to focus on product scenarios and predictable outcomes instead of vibe coding every piece from scratch.\n\n\n\n    \n    \n    \n    \n\n\n---\n\n## Table of Contents\n\n- [🤔 What is Spec-Driven Development?](#-what-is-spec-driven-development)\n- [⚡ Get Started](#-get-started)\n- [📽️ Video Overview](#️-video-overview)\n- [🧩 Community Extensions](#-community-extensions)\n- [🎨 Community Presets](#-community-presets)\n- [🚶 Community Walkthroughs](#-community-walkthroughs)\n- [🛠️ Community Friends](#️-community-friends)\n- [🤖 Supported AI Coding Agent Integrations](#-supported-ai-coding-agent-integrations)\n- [🔧 Specify CLI Reference](#-specify-cli-reference)\n- [🧩 Making Spec Kit Your Own: Extensions & Presets](#-making-spec-kit-your-own-extensions--presets)\n- [📚 Core Philosophy](#-core-philosophy)\n- [🌟 Development Phases](#-development-phases)\n- [🎯 Experimental Goals](#-experimental-goals)\n- [🔧 Prerequisites](#-prerequisites)\n- [📖 Learn More](#-learn-more)\n- [📋 Detailed Process](#-detailed-process)\n- [🔍 Troubleshooting](#-troubleshooting)\n- [💬 Support](#-support)\n- [🙏 Acknowledgements](#-acknowledgements)\n- [📄 License](#-license)\n\n## 🤔 What is Spec-Driven Development?\n\nSpec-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.\n\n## ⚡ Get Started\n\n### 1. Install Specify CLI\n\nChoose your preferred installation method:\n\n> **Important:** The only official, maintained packages for Spec Kit are published from this GitHub repository. Any packages with the same name on PyPI are **not** affiliated with this project and are 

常见问题 (3)

故障排除
为什么在运行'specify init --ai codex'时,constitution.md没有被SKILL.md引用?

这是Specify CLI v0.8.0中的一个错误,使用Codex AI初始化时遗漏了读取.specify/memory/constitution.md的指令。请升级到最新版本,此问题已修复。

来源 Issue #2650
故障排除
为什么当我运行'specify init --ai claude'时没有生成CLAUDE.md?

这是 SpecKit v0.4.1 中的一个已知错误。作为临时解决方案,请在项目根目录下手动创建 CLAUDE.md 文件,并包含以下内容:

## Claude 的角色
首先读取 `.specify/memory/constitution.md`。它是本项目的事实权威来源。其中的所有内容不可协商。

## SpecKit 命令
- `/speckit.specify` — 生成规格说明
- `/speckit.plan` — 生成计划
- `/speckit.tasks` — 生成任务列表
- `/speckit.implement` — 执行计划

## 关于歧义
如果某个规格说明缺失、不完整或与章程冲突——请停下来询问。不要推断。不要继续。

该文件可确保 Claude Code 在会话启动时了解 SpecKit 方法论和章程。请关注官方修复进展,访问 https://github.com/github/spec-kit/issues/1983。

来源 Issue #1983
故障排除
如何防止AI代理在PR审核中通过重复的逐条回复造成刷屏?

向AGENTS.md添加“回应PR审查评论”部分,包含以下规则:(1)每个审查轮次发布一条顶层总结评论,而非针对每条审查评论单独回复。(2)仅在表达异议、推迟处理或修正不明显问题时使用内联回复。(3)切勿点击“解决对话”。(4)避免使用表情符号、祝贺性文字或重复审查者的意见。(5)在解决所有反馈后,仅请求一次重新审查。同时要求代理商自我披露(代理商名称、模型、人类操作者)。

来源 Issue #2849