用途:create-specs 是“逆向工程到规格驱动开发”流程的第 3 步(共 6 步),把 Gear 2 生成的 docs/reverse-engineering/ 下 11 份文档转换为 GitHub Spec Kit 规格结构,输出到 .specify/ 目录。前置条件是已完成 Gear 2。
主要能力:按 Gear 1 配置的详细度生成不同层级内容。specs-only(约 30 分钟)生成所有功能的 spec.md、constitution 与目录结构;specs+plans(约 45-60 分钟)额外为 PARTIAL/MISSING 功能自动生成 plan.md;specs+plans+tasks(约 90-120 分钟)再生成每个 300-500 行的 tasks.md,形成可直接实施的路线图。
使用方式:先确认 .stackshift-state.json 存在并读取 gear3_thoroughness、route、spec_output_location 等配置;随后安装 Spec Kit 脚本(如 ~/git/stackshift/scripts/install-speckit-scripts.sh .,或从 GitHub raw 下载 check-prerequisites.sh、setup-plan.sh、create-new-feature.sh、update-agent-context.sh、common.sh 并 chmod +x);再执行 web/reconcile-specs.md 的自动化对账提示,解析 functional-specification.md 并生成 constitution.md 与各功能 spec.md;按详细度继续执行 operations/plan-generation.md 与 operations/task-generation.md;Greenfield 且指定了自定义输出位置时,将 .specify/ 复制到目标路径;最后做成功标准校验。
适用场景:需要把既有系统逆向文档转成规格驱动开发资产、并衔接后续 /speckit.plan、/speckit.tasks、/speckit.analyze 命令的团队。
限制:依赖 Gear 1 的状态文件与 Gear 2 的文档;缺少 Spec Kit 脚本会导致 Gear 4 的 /speckit.analyze 失败;自动化生成失败时需走 operations/manual-spec-generation.md 手动回退;子代理任务失败需重跑或内联生成。具体收费、平台支持等信息暂未提供。