用途:在棕地项目完成 Gear 6(implement)且 .stackshift-state.json 中 modernize 为 true 时触发,把依赖升级到最新稳定版本、修复破坏性变更、同步规格并生成升级报告。仅适用于 Node.js/TypeScript 项目;greenfield 项目会停止。
主要能力:按顺序执行七个阶段——预升级基线(备份 package.json 与锁文件、跑测试与覆盖率、npm outdated)、依赖升级(npx npm-check-updates -u --target latest --reject 'alpha,beta,canary,rc' 后 npm install,再 npm audit fix)、破坏性变更检测、按规格修复破坏性变更、规格同步、覆盖率提升至 85%+、最终验证(build、test、coverage、规格漂移、npm audit)。输出 .modernize/UPGRADE_REPORT.md 并更新状态文件。
使用方式:读取项目根目录 .stackshift-state.json,确认 path 为 brownfield、modernize 为 true、Gear 6 完成;工作目录为 .modernize/。状态字段包括 modernizeStatus(in-progress/complete/failed)与时间戳。失败时按回滚流程恢复基线并运行 npm install 与 npm test。
限制:不升级预发布/beta/canary 版本;不删除锁文件;不运行 npm audit fix --force;阶段串行且需通过门禁;若 /speckit.analyze 不可用则手动比对规格验收标准;测试失败率超 50% 时回滚并询问用户。