用途：管理规格驱动开发（Spec-Driven Development）的完整生命周期，同时负责把本地项目工作流同步并广播到所有 AI 智能体。前提是用户已安装 spec-kitty-cli 并按 spec-kitty init . --ai windsurf 初始化仓库，否则不应操作。
工具链维护：pip install spec-kitty-cli 安装；pip install --upgrade spec-kitty-cli 更新；spec-kitty init . --ai windsurf 生成 .windsurf/workflows 与 .kittify/config.yaml。随后两步同步：先运行 python3 plugins/spec-kitty-plugin/skills/spec-kitty-agent/scripts/sync_configuration.py 把本地工作流转成插件内技能；再询问用户是否用 npx skills add ./plugins/spec-kitty-plugin --force 部署到活跃 AI 环境。
工作流：阶段 0 依次执行 spec-kitty specify、plan、tasks，并在每个产物后用 verify --phase 校验，禁止手工编写 spec.md、plan.md、tasks.md。每个阶段产物生成后必须停下，等待用户明确回复 Proceed、Go 或 Execute 才能继续，Sounds good 之类不算批准。阶段 1 按工作包执行：spec-kitty implement WP-xx 建 worktree，cd .worktrees/WP-xx，编码测试，git add . && git commit，再 spec-kitty review WP-xx。
收尾协议：每个 WP 用 spec-kitty agent workflow review --task-id <WP-ID> 移入 done；回到主仓库执行 spec-kitty accept --mode local --feature <SLUG>（shell_pid 报错可用 --lenient）；必须运行 /spec-kitty_retrospective 并生成 kitty-specs/<SPEC-ID>/retrospective.md；执行 spec-kitty merge --feature <SLUG> --dry-run 预检，再从主仓库根目录执行 spec-kitty merge --feature <SLUG>，失败可用 --resume；最后用 git log、git worktree list、git branch、git status 核验。
限制与已知问题：必须在主仓库而非 worktree 中合并；不要手工合并或删除 worktree；合并前有未跟踪文件先 git stash -u；WP 文件需含 lane、dependencies、base_branch 的 YAML frontmatter；worktree 会被删除，其中的 kitty-specs 研究文件需先 rsync 复制到主仓库再合并。看板用 /spec-kitty.status 查看，用 spec-kitty agent tasks move-task 移动泳道。