用途：这是“反向工程到规范驱动开发”流程的第4步（共6步），预计15分钟，前置条件为第3步完成、.specify/ 目录已存在规范。输出为 docs/gap-analysis-report.md。
主要能力：先读取 .stackshift-state.json 确定 route 与 detection_type；若该文件不存在则停止并提示先运行 Step 1 (analyze)。根据路由分两种模式：greenfield 检查各 spec.md 的歧义、验收标准与用户故事，用 [NEEDS CLARIFICATION] 标注缺口，询问目标技术栈并写入项目 Constitution，按构建阶段生成路线图；brownfield 通过 AST 分析（主）、Spec Kit /speckit.analyze（回退）、人工审查（最后手段）对比规范与现有实现，做详细差距分析、评估技术债，按 P0-P3 优先级和三个阶段排期。
必要用法示例命令：node ~/stackshift/scripts/run-ast-analysis.mjs roadmap . --format=markdown；回退命令 > /speckit.analyze。若 .specify/specs/ 缺失或为空则停止，提示先运行 Step 3 (create-specs)。
适用场景：新建项目的规范完备性检查与实现路线图；存量项目的实现差距分析、部分/缺失功能盘点和技术债梳理。完成后的后续命令：/speckit.analyze、/speckit.tasks {feature}、/speckit.implement {feature}、/speckit.clarify {feature}。
限制：必须依赖前置状态文件与规范目录，否则终止；AST 分析失败才降级到 Spec Kit，再失败才人工分析，人工为最不彻底选项；成功标准以报告文件等产出为准。官方未提供收费、平台支持等信息。