用途:modernize 是 StackShift 工作流中的可选步骤,针对设置 modernize: true 标志的棕地项目,在 Gear 6 完成后运行,目标是在维持规格驱动控制的前提下把应用的依赖升级到现代版本。触发条件是状态文件含 path: "brownfield" 且 modernize: true,且 Gear 1–6 已完成、规格覆盖率已达 100%。
主要能力:按技术栈检测包管理器(npm、yarn、pnpm、pip、go mod、cargo 等);审计当前依赖版本并建立基线;执行升级;运行测试识别破坏性变更;在规格引导下迭代修复;同步规格与 API/行为变化;校验测试覆盖率达 85% 以上;运行 /speckit.analyze 确认实现与规格一致。
流程概览:阶段 1 升级前审计,记录基线并生成升级计划;阶段 2 按栈执行依赖升级;阶段 3 运行测试并对比基线检测破坏性变更;阶段 4 依据规格修复破坏性变更并补测试;阶段 5 若行为变化则更新规格并运行 /speckit.analyze 校验;阶段 6 补齐测试至 85% 以上覆盖率;阶段 7 最终验证构建、测试、覆盖率、规格一致性与依赖安全。
输出:在 .modernize/UPGRADE_REPORT.md 生成升级报告,包含升级包数量、重大版本变更、修复的破坏性变更、修复与新增测试数、覆盖率变化和更新的规格。
运行方式:在 Cruise Control 模式下 Gear 6 后自动运行;手动模式下 Gear 6 完成后技能可用,用户显式调用 /stackshift.modernize 或技能自动激活。
适用场景与限制:适合希望现代化而不做完整重写的团队。预计耗时 2–6 小时,视依赖陈旧程度与破坏性变更数量而定。成功标准为全部依赖升级到最新稳定版、测试通过、各模块覆盖率不低于 85%、构建成功、/speckit.analyze 无漂移、无高危/严重安全漏洞、行为变化处规格已更新并生成升级报告。资料未提供具体收费、价格或支持平台信息。