spec-kitty

环境要求

• Python 运行环境（pipx 会为 CLI 创建独立虚拟环境）
• 一个 git 仓库（Spec Kitty 把 spec、plan、验收标准等存进仓库，并用 git worktree 隔离并行任务）
• 已使用的 AI 编码助手，如 Claude Code、Codex、Cursor、Gemini、GitHub Copilot、Windsurf、OpenCode

安装与启动步骤

1. 1用 pipx 安装 CLI

   README 推荐的安装方式，pipx 会把 Spec Kitty 装进独立虚拟环境，避免现代 Linux 上常见的 externally-managed-environment 报错。

   pipx install spec-kitty-cli

   复制

2. 2或用 uv 安装

   README 列出的另一种受支持安装方式，已习惯 uv 的用户可直接用；与 pipx 方式二选一即可。

   uv tool install spec-kitty-cli

   复制

3. 3准备 git 仓库

   Spec Kitty 以仓库为唯一事实来源，并依赖 git worktree 做多任务并行隔离，因此需要在 git 仓库内使用。

   git init

   复制

4. 4按工作流接入流程

   README 给出的主干流程为 spec -> plan -> tasks -> next -> review -> accept -> merge，请在仓库中按此顺序推进任务。

5. 5连接你的 AI 助手

   在 Claude Code、Codex、Cursor、Gemini、GitHub Copilot、Windsurf、OpenCode 等助手环境中使用，由人在规格与验收标准上把关。

如何确认成功

安装完成后终端中可直接调用 spec-kitty 命令（pipx/uv 会自动加入 PATH）；再进入 git 仓库按 spec -> plan -> tasks 流程跑通第一个任务。

常见问题

注意事项

• README 节选只给出安装命令，未提供 init、看板启动等具体子命令与参数，请以官网 https://spec-kitty.ai 和仓库文档为准。
• Spec Kitty 把 spec、plan、work package、验收标准、评审状态和合并决策都保存在你的仓库里，请确保仓库纳入版本管理。
• 包名是 spec-kitty-cli，命令行工具名是 spec-kitty，两者不要混淆。
• 它定位为「明亮的软件工厂」而非黑盒：人的评审与验收是流程中的必备环节。