spec-kitty

给 AI 编码装上规格看板,多任务并行不打架

spec-kitty 是一个面向严肃软件开发者的规格驱动开发(Spec-Driven Development)工作流工具。它把「先写规格、再让 AI 编码」的流程工程化:你可以在 Claude Code、Cursor、Gemini、Codex 等主流 AI 编程工具中围绕规格文件展开协作,而不是让 AI 随意生成代码。核心能力包括看板式仪表盘(Kanban dashboard)用于可视化任务与进度、基于 git worktree 的隔离开发环境让多个 AI 任务并行不互相污染、自动合并(auto-merge)减少手工集成成本,以及围绕规格的进度追踪。它解决的是 AI 编码时代「生成快但难管理、难追踪、难并行」的痛点,把散落的 AI 会话变成有规格、有看板、有分支隔离的可控工程流程,适合需要多人多任务协作、对代码质量与可追溯性有要求的团队。

开源 unknown 编程开发
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1628
维护状态 活跃
是否开源
定价模式 unknown

项目数据

分类编程开发
开发团队spec-kitty
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源
开源协议MIT
主要语言Python
技术栈/模型agentic-coding,ai-agents,ai-coding-workflow,ai-development-dashboard,ai-progress-tracking,ai-workflow,claude-code,code-workflow,coding-agent-orchestration,cursor-agent,development-kanban,gemini-cli,github-copilot,kanban-workflow,multi-agent-support,spec-driven-development,spec-workflow-automation,structured-development,vibe-coding,windsurf
GitHub 星标★ 1628
30天Star增速
HF 下载量
上线时间2025-10-09 00:00:00
最近更新2026-09-16 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-09-17
浏览次数0

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 5 步

环境要求

  • 已安装 pipx 或 uv 工具(用于安装隔离的 CLI 环境)
  • 可访问 PyPI 的网络环境
  • 一个本地 git 仓库(工作流基于仓库内规格文件与 git worktree 隔离执行)
  • 至少一个受支持的 AI 编程工具(如 Claude Code、Codex、Cursor、Gemini 等)

安装与启动步骤

  1. 1用 pipx 安装 CLI

    README 推荐的首选安装方式,pipx 会把 Spec Kitty 放在独立虚拟环境里,规避现代 Linux 上的 externally-managed-environment 报错。

    pipx install spec-kitty-cli
  2. 2用 uv 安装(备选)

    没有 pipx 或更习惯 uv 时改用此命令,效果同为把 CLI 装成全局工具。

    uv tool install spec-kitty-cli
  3. 3试用 4.x 预发行版

    main 分支承载 4.x 发布候选线,需安装精确版本号才能测试 RC2;属资格验证用途,稳定发布验收仍待定。

    uv tool install 'spec-kitty-cli==4.0.0rc2'
  4. 4确认命令可用

    安装完成后在终端直接调用 spec-kitty,具体子命令与参数以本地帮助输出为准,README 未列出更多 CLI 参数。

  5. 5按规格流程推进

    在仓库中沿 spec → plan → tasks → next → review → accept → merge 推进;规格、计划、工作包、验收标准与评审状态都留在仓库里,agent 在隔离 worktree 中并行实现。

如何确认成功

安装后终端可直接调用 spec-kitty 命令,并能在 git 仓库中按 spec→plan→tasks→next→review→accept→merge 流程产出规格与工作包。

常见问题

Q:安装时报 externally-managed-environment 怎么办?

A:这是现代 Linux 常见错误。README 建议用 pipx 安装到独立虚拟环境,或改用 uv tool install spec-kitty-cli。

Q:没有 pipx 可以装吗?

A:可以。README 明确列出另一种方式:uv tool install spec-kitty-cli,两者都是把 CLI 隔离安装的推荐做法。

Q:怎么体验 4.x 版本?

A:执行 uv tool install 'spec-kitty-cli==4.0.0rc2' 安装精确的 RC2 版本;注意它属于预发行版,仅用于资格验证。

Q:支持哪些 AI 编程工具?

A:可围绕 Claude Code、Codex、Cursor、Gemini、GitHub Copilot、Windsurf、OpenCode 等 agent 构建受治理的软件开发流程。

注意事项

  • 不指定版本时,正常安装会选择已发布的稳定版本,不会自动装 4.x 预发行版。
  • 4.0.0rc2 只用于资格验证,稳定版发布验收尚未完成,不建议用于正式项目。
  • Spec Kitty 默认不是全自动黑盒:人类定义意图、架构和验收标准,agent 只在可追溯的工作包内实现。
  • 多个 AI 任务并行前请确认仓库已纳入 git 管理,隔离执行依赖 git worktree。

核心亮点

  • 用 git worktree 隔离每个 AI 任务,多任务并行开发互不干扰
  • 提供 Kanban 看板可视化 AI 开发进度,任务状态一目了然
  • 支持 Claude、Cursor、Gemini、Codex 等多种 AI 编程工具,不绑定单一厂商

不足之处

  • 项目处于成长阶段,生态与文档完善度有待观察
  • 强依赖 git worktree 与规格流程,轻量小项目可能觉得偏重

适用场景

  • 团队用多个 AI 代理并行开发同一仓库的不同功能模块
  • 需要按规格追踪 AI 编码进度、向干系人汇报的开发管理
  • 在 Claude Code/Cursor 等工具间切换时统一管理 AI 开发工作流

替代项目

OpenHands、Aider、Continue

项目介绍

spec-kitty 是一个编程开发领域的开源项目,官方简介:Spec-Driven Development for serious software developers. Spec Coding with with Claude, Cursor, Gemini, Codex. Kanban dashboard, git worktrees, auto-merge and more.。项目使用 Python 开发,在 GitHub 上获得 1628 星标。

上一篇:ruler

下一篇:ccmanager

同类项目推荐

bolt.new 开源

想到啥说啥,网页应用当场生成直接能用

Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···

★ 16553 2026-08-09
fuzz4all 开源

用大模型自动生成测试输入,发现各种软件漏洞

️Fuzz4All: Universal Fuzzing with Large Language Models

★ 338 2026-08-09
superpowers-zh 开源

全套 AI 编程神技汉化好了,照着用就行。

AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···

★ 8109 2026-08-09
Gitea 代码托管 开源

轻量 Git 代码托管平台

Git with a cup of tea! Painless self-hosted all-in-one software development service,···

★ 58021 2026-08-22