方案 AY：从 Vibe 原型到 Viable 产品（上线前打磨清单）

测试框架 + Claude Code

为关键逻辑补单元测试、为关键路径补端到端测试，让后续改动可回归。先测最容易崩的逻辑（数据处理、状态切换、外部依赖），再覆盖核心用户流程。

💡端到端测试用 Playwright 走一遍真实用户路径，比手点十次更可靠；先让测试稳定跑绿，再谈覆盖率。

Claude Code + Playwright

空态、失败态、非法输入逐一处理，避免白屏与崩溃；把错误信息写给用户看，而不是贴技术堆栈。网络超时、接口返回异常、数据缺失这些「正常跑」里不会出现的场景，才是上线后最常见的翻车点。

💡用 Playwright 模拟断网、慢响应、空数据来复现失败态；每个错误路径都要有可见的兜底文案。

浏览器 DevTools + Claude Code

用 DevTools 的 Performance 面板和 Network 面板定位加载、交互、响应时间的瓶颈，慢的部分优先优化，别过度优化。通常 80% 的收益来自少数几个点：首屏大请求、未缓存资源、渲染阻塞。

💡先量化再动手，记录优化前后的指标；设一个「够用」的目标（比如首屏 3 秒内），达标就停。

Claude Code

统一命名、拆分过大的函数与文件、补上类型、清理死代码，让项目能交给别人，或三个月后的自己。Vibe 编码阶段留下的临时 hack 和硬编码，在这里一次性归位。

💡让 AI 做一遍「可读性审查」，再逐条确认改动；改动保持小步提交，随时可回滚。

Claude Code

写清运行方式、环境变量、部署步骤、已知问题与限制，形成一份可交接的 README 或交接文档。别指望别人（或未来的自己）从代码里猜出启动命令和前置依赖。

💡把「从克隆到上线」的完整命令一步步跑一遍并记录，文档里出现的每条命令必须真的能跑。