
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 会话变成有规格、有看板、有分支隔离的可控工程流程,适合需要多人多任务协作、对代码质量与可追溯性有要求的团队。
项目数据
使用教程
环境要求
- 已安装 pipx 或 uv 工具(用于安装隔离的 CLI 环境)
- 可访问 PyPI 的网络环境
- 一个本地 git 仓库(工作流基于仓库内规格文件与 git worktree 隔离执行)
- 至少一个受支持的 AI 编程工具(如 Claude Code、Codex、Cursor、Gemini 等)
安装与启动步骤
-
1用 pipx 安装 CLI
README 推荐的首选安装方式,pipx 会把 Spec Kitty 放在独立虚拟环境里,规避现代 Linux 上的 externally-managed-environment 报错。
pipx install spec-kitty-cli -
2用 uv 安装(备选)
没有 pipx 或更习惯 uv 时改用此命令,效果同为把 CLI 装成全局工具。
uv tool install spec-kitty-cli -
3试用 4.x 预发行版
main 分支承载 4.x 发布候选线,需安装精确版本号才能测试 RC2;属资格验证用途,稳定发布验收仍待定。
uv tool install 'spec-kitty-cli==4.0.0rc2' -
4确认命令可用
安装完成后在终端直接调用 spec-kitty,具体子命令与参数以本地帮助输出为准,README 未列出更多 CLI 参数。
-
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
项目介绍
同类项目推荐
bolt.new
开源
想到啥说啥,网页应用当场生成直接能用
Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···
fuzz4all
开源
用大模型自动生成测试输入,发现各种软件漏洞
️Fuzz4All: Universal Fuzzing with Large Language Models
superpowers-zh
开源
全套 AI 编程神技汉化好了,照着用就行。
AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···
Gitea 代码托管
开源
轻量 Git 代码托管平台
Git with a cup of tea! Painless self-hosted all-in-one software development service,···