| name | lazycat:migration-boundary |
| description | Non-invasive migration feasibility and workload gate for Lazycat. Use after migration-license to decide allowed write scope, runtime mapping, LPK/image boundary, workload level, and whether to proceed, POC, or stop. 迁移可行性、不改业务代码、运行适配、工作量评估、是否继续. |
Lazycat Migration Feasibility and Workload Gate
职责范围
只评估已通过 lazycat:migration-license 的候选能否在不修改上游业务代码的前提下迁移到懒猫，并给出工作量等级和下一步决策。它不做候选搜索、不做许可证结论、不实施完整打包、不提审。
通过后交给 lazycat:ship-app；风险较大时先做 POC。
输入
lazycat:migration-license 输出的候选记录。- 仓库路径或只读 clone 结果。
- README、Dockerfile、Compose、镜像、配置样例、启动方式和部署文档。
- 用户明确授权的业务代码修改范围；没有授权时视为零业务代码修改。
凭据环境变量约定
如流程需要登录懒猫微服、应用商店或开发者中心，优先读取当前进程环境变量；只有变量缺失或为空时才向用户报告缺失项。
- 微服设备：
LAZYCAT_USERNAME / LAZYCAT_PASSWORD
- 懒猫应用商店：
LAZYCAT_APPSTORE_USERNAME / LAZYCAT_APPSTORE_PASSWORD
- 懒猫开发者中心：
LAZYCAT_DEVELOPMENT_USERNAME / LAZYCAT_DEVELOPMENT_PASSWORD
使用约束：
- 只通过环境变量读取凭据，不把值写入仓库文件、报告、截图说明、提交信息或长期记忆。
- 不为确认变量而执行
echo $LAZYCAT_PASSWORD、printenv LAZYCAT_PASSWORD 等会输出明文的命令；只允许用 test -n "${LAZYCAT_PASSWORD:-}" 这类方式检查是否存在。
- 浏览器自动化登录时直接填入变量值，日志和回复只记录变量名、站点和操作结果，不记录值。
- CLI 登录或
copy-image 需要凭据时优先复用已有登录态；确需传参时避免把密码放在命令行参数、shell history 或可见输出中。
- 凭据只解锁认证，不扩大本技能权限；提交、发布、安装覆盖、远程写操作仍按本技能边界和当前任务授权执行。
输出
- 非侵入迁移结论。
- 允许修改的包装层范围。
- 运行模型映射：镜像、服务、路由、持久化、依赖、初始化、登录、文件能力。
- LPK 包体和远程镜像桥接方案。
- 工作量等级、主要风险和下一步建议。
前置条件
- 候选已通过
lazycat:migration-license，许可证为 Pass 或 Pass with Obligations。
- 应用商店和开发者中心查重为
Clear，或用户明确接受差异化理由。
- 已读取仓库的运行文档、Docker/Compose 证据和关键配置。
- 如需查看懒猫官方事实，优先读取
lazycat:ship-app/references/lpk/ 和相关本地文档。
允许执行
- 读取和分析上游源码、配置、Dockerfile、Compose、README、release 和部署文档。
- 修改或规划包装层文件：
package.yml、lzc-build.yml、lzc-manifest.yml、lzc-deploy-params.yml、Makefile、build.sh。
- 修改或规划 Docker wrapper、启动脚本、seed/setup 脚本、配置模板、图标、商店素材和迁移文档。
- 构建或试运行用于 POC 的包装层和镜像，前提是不修改上游业务代码。
- 调用
arc:frontend 仅处理新增包装层、配置向导、审核辅助页或独立管理台。
禁止执行
- 未经当前任务明确授权，不修改上游业务前端页面/组件/路由/状态、后端 handler/service/domain/auth、数据库 schema/migration/model、测试或 fixture。
- 不为了启动、登录、健康检查、路由、审核或“尽快跑起来”修改业务源文件。
- 不把上游前端、移动端、桌面端或小程序客户端重写成默认平台栈。
- 不使用
lzc-build.yml.images、embed:<alias>、包内 images/ 或 images.lock。
- 不把“能构建镜像”当作“能上架”；必须覆盖安装、启动、登录、持久化、核心流程和商店资料。
- 不处理许可证不明或查重未通过的项目；退回
lazycat:migration-license。
必查项
- 镜像路径：官方镜像、公开镜像、Dockerfile、自建镜像、源码构建。
- LPK 边界：最终
.lpk 是否可保持 <= 12,000,000 bytes，且不内嵌镜像。
- 服务模型：长期进程、固定端口、健康检查、依赖排序。
- 持久化：数据目录、配置目录、权限、缓存策略。
- 初始化：数据库迁移、管理员创建、密钥生成、首启向导。
- 登录：无登录、固定账号、OIDC、inject、反向代理、二次验证。
- 文件能力：无文件流程、上传下载、文件选择器、文件关联。
- 外部依赖：域名、邮件、对象存储、第三方 API、GPU、宿主机能力、特权容器。
- 上架成本：默认桌面端平台选择、2-5 张截图、图标、描述、测试账号、复现步骤、版本来源。
决策
非侵入迁移结论：
Can migrate non-invasively: 可以只改包装层完成迁移。Can migrate with wrapper risk: 可以包装，但启动、登录、文件、依赖或数据风险较高。Cannot determine yet: 关键事实缺失，需要补证据或 POC。Blocked by business-code change requirement: 必须修改上游业务代码，停止普通迁移。
工作量等级：
Small: 单服务或简单 Compose，官方/公开镜像可用，持久化清晰，通常 1 天内。Medium: 2-4 个服务，需要健康检查、初始化脚本、固定凭据或 inject，通常 1-3 天。Large: 多服务、复杂初始化、登录或文件流程、外部依赖多、镜像需自建，通常 3-7 天，先 POC。Too Large: 非侵入不可控、依赖特权/不可替代外部服务、关键二进制或许可证缺失，停止。
建议：
Proceed: 进入 lazycat:ship-app。POC first: 先做最小包装验证。Switch project: 候选可做但性价比低，换项目。Stop: 被业务代码、许可证、运行模型或包体门禁阻塞。
参考资料
references/porting-checklist.mdreferences/s2i-strategy.mdreferences/command-conventions.md
后置条件
- 输出允许写入范围和禁止写入范围。
- 输出运行模型、LPK/镜像边界、工作量等级和下一步建议。
- 除非用户明确要求并已验证移动端或智慧屏，进入上架时默认只选择桌面端，并要求静态元数据声明不支持
ios、tvos、android。
- 如果进入上架，必须带上许可证结论、查重结论、非侵入结论和工作量结论。
- 如果阻塞，必须给出唯一阻塞原因或证据缺口。
输出格式
Phase: Migration Feasibility and Workload Gate
Repository: <owner/repo>
Inputs
- License gate:
- Duplicate checks:
- Source evidence:
Allowed Write Scope
- Packaging:
- Runtime:
- Assets/docs:
Runtime Model
- Image:
- LPK size/embed boundary:
- Store platforms:
- Services/routes:
- Persistence:
- Dependencies:
- Initialization:
- Login:
- File flows:
- External requirements:
Decision
- Feasibility: Can migrate non-invasively / Can migrate with wrapper risk / Cannot determine yet / Blocked by business-code change requirement
- Workload: Small / Medium / Large / Too Large
- Recommendation: Proceed / POC first / Switch project / Stop
Risks
- Business-code risks:
- Data risks:
- Store readiness:
Next: lazycat:ship-app / POC / Stop
