大版本遗留迁移指南先行简报
你是 Java/前端框架现代化顾问。只根据用户约束写指南与门禁，不要编造已通过兼容认证。
源栈：{{from_stack}}
目标栈：{{to_stack}}
数据/商标约束：{{constraints}}
输出 Markdown：
1. 首份迁移指南目录（含人必须拍板项）
2. 分层上「可不动」与「必重写」边界
3. 联调期「测试中勿改」纪律
4. 人必须保留的法律/产品决策
禁止建议无人值守合入；禁止伪造「下午必生产就绪」。← 返回用例列表
Flowing Code：Vaadin 10→25 一下午——先出迁移指南再动手，约 3–4 小时
团队用 Claude Opus 复活 2018 黑客松应用；披露先写可分享迁移指南、免费无 Key API 约束、约 3–4 小时有效会话、后接 Vaadin MCP/Signals；不代你无人值守合入商标与架构。
场景说明
面向要把跨大版本 Java/Vaadin 遗留演示救活、又怕盲开改的小团队：把「首交付=指南」、人裁 API/商标与测试中禁改写成门禁，区别于一日多站主机迁与两日内容站重建。
案例叙事
01他们做了什么
Paola De Bartolo 代表 Flowing Code 团队在《Vaadin 10 to 25: Migrating a 8-Year-Old App with Claude AI》（JSON-LD datePublished 2026-06-18T19:49:25Z → 2026-06-18）写明：他们要把 2018 黑客松足球赛况看板从 Vaadin 10/Java 8/Spring Boot 2.0 迁到 Vaadin 25/Java 21/Spring Boot 4.0.6，并用 Claude Opus 作结对。首交付不是代码，而是可分享的迁移指南——盘点现状、比较数据源、标出必须由人决定的项；Claude 侦察确认原 API worldcup.sfg.io 已永久下线。
人裁关键决策：严格「免费、无 API Key」直接排除付费富统计源，产品收敛为赛程/比分/小组/国家页，选用 worldcup26.ir；因赛事相关商标，人决定更名为 Global Football 2026 Stats 并加非隶属声明；纠正模型把 Vaadin 25 误绑 Spring Boot 3.x 的过时假设。架构红利：原 MVP 分层使 view-DTO 与数据源无关，主要重写 repository/mapper，presenter/屏幕/DTO 基本不动。
协作亮点：读已解析 JAR/官方 starter POM、curl 验活 API schema；机械扫 javax→jakarta 与弃用组件。踩坑：缺 vaadin-dev 依赖导致本地命令崩；测试运行中 Agent 改文件造成冲突配置——须明示「我在测试，别动」。事后补接 Vaadin MCP，用 SharedMapSignal 替换 2018 手写 broadcaster/UI.access 直播分推送。作者估计同类手工要数日，本次有效会话约 3–4 小时，最慢机械步是约 3 分钟的 Vite 打包。本场景据此输出「指南先行的大版本迁」提纲。禁止建议无人值守处理商标或把 3–4 小时写成任意遗留仓保证。
02实际效果
- 源披露约 3–4 小时有效会话、指南先行、免费无 Key 约束、商标更名声明、以及后接 MCP/Signals 等作者口径；属小演示仓窗口，不可外推为你的企业遗留工期或「下午必可上生产」。
- 能把「能编译到新版本」与「人裁数据/法律 + 测试中禁改 + 领域 MCP」拆开。
- 为盲开大版本、以及 Agent 在联调时抢改文件提供提问清单。
03值得知道
- 免费社区 API 可能拥堵/短暂不可用；作者已提示。
- 知识截止日期会导致错误框架假设，须人纠。
- 上面写的是 Flowing Code 团队实践帖，不是 Vaadin/Anthropic 官文。
04可复制提示词
联调时 Agent 抢改文件复盘提纲
人在跑应用验收，Agent 同时改配置导致启动冲突。请写复盘提纲。
现象：{{symptom}}
输出：
1. 缺原子变更边界、缺口头禁令，还是缺分支隔离
2. 最小恢复步骤
3. 下次验收标准
4. 人工确认清单
不要伪造「Agent 会自动感知你在测试」。怎么做
- 粘贴源/目标栈、是否必须免费无 Key 数据源，以及商标/免责约束
- Agent 按实践帖输出：首份迁移指南提纲、人必须拍板项、以及「测试中勿改文件」纪律
- 人工保留 API/法律与合入决策；Agent 不代你声称可覆盖全部破坏性变更或免审上线
实用提示
- 源帖：2018 Vaadin 10 + Java 8 + Spring Boot 2.0 → Vaadin 25 + Java 21 + Spring Boot 4.0.6；原 worldcup.sfg.io 已永久下线；严格「免费、无 API Key」；选用 worldcup26.ir；应用更名 Global Football 2026 Stats 并加非隶属声明；有效会话约 3–4 小时；Vite 打包约 3 分钟最慢机械步；MVP 分层使 presenter/DTO 未动；后接 Vaadin MCP 与 SharedMapSignal 重构直播分推送
- 与 jeremy-keeshin-16-sites-linode-day-migrate / outloop-claude-legacy-dotnet-audit-harden 不同：本条是 Vaadin/Java 大版本下午迁+指南先行，不是多站主机迁或 .NET 审计加固