用途:为 Spec Kitty 智能体工作流提供标准操作流程,覆盖 Plan(specify→plan→tasks)、Implement(工作包实现与审查)、Close(验收→回顾→合并→同步)三个阶段,并通过人工审批门(Human Gate)与看板状态控制推进节奏。
主要能力:通过 CLI 生成 spec.md、plan.md、tasks.md,禁止手工创建这些文件;用任务 CLI 管理 WP 看板泳道(planned、doing、for_review、done);执行工作包实现、审查、验收、回顾、合并与合并后校验;提供防止“勾选表演”“跳过阶段”“跳过收尾”等失败模式的反模式提示,以及合并预检、远端备份等安全步骤。
使用方式:先安装依赖 pip-compile ./requirements.in 与 pip install -r ./requirements.txt(当前标准库即可,锁文件为空)。创建功能用 spec-kitty agent feature create-feature "<slug>";规划用 spec-kitty agent feature setup-plan --feature <SLUG>;生成任务用 /spec-kitty.tasks;开始 WP 用 spec-kitty agent workflow implement --task-id <WP-ID> --agent "<AGENT-NAME>";更新泳道用 python .kittify/scripts/tasks/tasks_cli.py update <FEATURE-SLUG> <WP-ID> <LANE> --note "reason";查看看板用 /spec-kitty.status;审查用 spec-kitty agent workflow review --task-id <WP-ID>;验收用 spec-kitty accept --feature <SLUG>(模式 local、pr、checklist,可用 --lenient);回顾用 /spec-kitty_retrospective;合并前预检用 spec-kitty merge --feature <SLUG> --dry-run --json,正式合并用 spec-kitty merge --feature <SLUG> --push。
适用场景:需要在受控审批下逐阶段推进规格驱动开发、以工作包为单位协作并保证审查与收尾不遗漏的团队或智能体会话;也支持双环(Dual-Loop)分工模式。
限制:合并必须在主仓库根目录执行,工作树内会被 @require_main_repo 拦截;工作树中的未跟踪文件在 git worktree remove 时会被删除,需先同步到主检出;kitty-specs/ 在 WP 分支受 pre-commit 钩子限制,只能在主/目标分支提交;tasks.md 中未勾选任务会导致验收失败;部分 accept 参数(如 --actor、--test)不受支持;其他性能、收费与平台信息暂未提供。