用途：作为六阶段逆向工程流水线的第 1 阶段（Gear 1），对一个代码库做初步分析，检测技术栈、目录结构与应用完整度，约 5 分钟，输出 analysis-report.md 到当前工作目录（无论 spec_output_location 如何设置，都写在此处）。
激活方式：当用户表达“分析这个代码库”“这是什么技术栈”“这个应用有多完整”“运行初始分析”“开始逆向工程流程”，或在新建/既有代码库上启动逆向工程时触发。
执行流程分四阶段：Phase 0 安装斜杠命令，运行 operations/install-commands.md 中的命令把 /speckit.* 复制进项目，失败则记录跳过并继续。Phase 1 检测：先按 operations/batch-session.md 查找 .stackshift-batch-session.json，找到则加载答案写入 .stackshift-state.json 并跳过 Phase 2；否则按优先级自动判定应用类型（monorepo-service、nx-app、turborepo-package、lerna-package、osiris、v9-velocity、v9-viewmodel、generic）。Phase 2 问卷：按 operations/questionnaire.md 对话式逐题提问，答案写入 .stackshift-state.json；已存在则询问复用还是重来。Phase 3 分析：并行运行 detect-stack、核心元数据提取、directory-analysis、documentation-scan、completeness-assessment 五项操作，任一失败重试一次，仍失败记“Unable to assess”并继续。Phase 4 报告：按 generate-report.md 模板生成 analysis-report.md，版本号读取 .claude-plugin/plugin.json，向用户汇报并询问是否进入 Gear 2。
路径描述：Greenfield 适合依据既有业务逻辑新建应用、迁移技术栈或需要平台无关规格，规格只关注 WHAT；Brownfield 适合用 spec 管理既有代码库，规格包含 WHAT 与 HOW。
限制与规则：命令无输出视为“未找到”，非零退出记录后继续，不因单条失败中止；目录列表用 head -50、grep 用 head -20 并注明截断；始终排除 node_modules、vendor、.git、build、dist、target、pycache、.next、.nuxt、coverage；分析中断需删除 .stackshift-state.json；报告已存在时询问更新还是跳到 Gear 2。Cruise Control 模式在 Phase 2 后非交互运行，失败即停止并询问用户。v9-velocity、v9-viewmodel、osiris 属遗留 CMS widget 类型，按通用分析并在报告中注明。其余未提及信息暂未提供。