成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Khalit:SST 打了 8 个月后——3 周用 Claude Code 把后端改成 FastAPI 单体

TessellAI 照片马赛克;披露约 5 个月停更、3 周重写、432 文件 +24422/-11569、16 份设计文档、迁完后功能多于前 8 个月基建;不代你无人值守合入生产。

场景说明

面向被错误 Serverless 选型拖死、又觉得重写付不起的独立开发者:把编号任务、设计文档先行与人裁架构写成门禁,区别于主机多站迁与框架大版本下午迁。

案例叙事

01他们做了什么

Khalit Hartmann 在个人站《I Used Claude Code to Migrate My Full-Stack App from Serverless to Monolith》(JSON-LD datePublished 2026-03-10 → 2026-03-10)写明:TessellAI 是活动现场照片马赛克生成器;2024-12 选 SST/AWS(Neon/Drizzle/Hono/IoT MQTT/SQS/S3)后,重图像流水线与 Serverless 冷启动/超时/伸缩反复打架——2025-03 约 196 次提交几乎全是基建,同年 8 月后约五个月零提交。2026-01-25 起用 Claude Code 把后端改到 FastAPI/Python 单体,约三周内落地。

人裁架构:Python 统一马赛克管线语言、FastAPI 而非 Django、Celery 而非后台线程、WebSocket 而非 AWS IoT。Day1 先加 CLAUDE.md 与编号任务(模型、鉴权 TDD、上传、Celery、管线、前端类型、前两页迁移)。随后约十日按页改前端;openapi-fetch 在编译期抓住响应形变。一次 squash:432 文件、+24,422/-11,569。迁后三周内反而能推新样式、PixiJS、向导、i18n 11 语言、高分辨率打印管线等——作者称功能进度超过此前八个月基建。2026-02-16 一日完成 Media→EventMedia/MosaicMedia 四阶段向后兼容迁移(每阶段有设计文档与测试)。

诚实面:AI 时代更容易「先做再评」——spotlight 动画建了又删;432 文件 squash 不利追溯;方向仍须人给;写稿时迁移仍在 feature 枝、最终合 main/生产切流未完。本场景据此输出「停更项目单体复活」提纲。禁止建议跳过设计文档与人裁架构,或把三周写成任意 Serverless 仓保证。

02实际效果

  • 源披露约 5 个月停更、约 3 周重写、432 文件 +24422/-11569、16 份设计文档约 237KB、月提交约 +42%、以及无 AI 估 2–3 月等作者口径;属一人活动产品窗口,不可外推为你的停机、数据零损或「三周必可切生产」。
  • 能把「生成很快」与「编号计划 + 设计文档 + 人裁栈选型」拆开。
  • 为错误 Serverless 选型沉没成本、以及 squash 过大难回滚提供提问清单。

03值得知道

  • 作者自承迁移枝尚未最终合 main;演示进度≠生产切流完成。
  • 生成便宜会诱使先建后评;仍须人做架构与品味否决。
  • 上面写的是 Khalit 个人实践帖,不是 AWS SST/Anthropic 官文。

04可复制提示词

Serverless→单体重写门禁简报

你是独立产品架构迁移顾问。只根据用户约束写编号任务与验收门,不要编造已切生产。

当前痛点:{{pains}}
目标栈边界:{{target}}
是否要求分阶段可回滚:{{rollback}}

输出 Markdown:
1. 人必须先拍板的架构决策清单
2. 编号任务表(先后端 API,再分页前端)
3. 设计文档最小模板
4. 合入/切流人审门
禁止建议无人值守改生产 DNS;禁止伪造「三周必零停机」。

生成过快导致功能建了又删复盘提纲

低成本生成后快速上线又整段删除重做。请写复盘提纲。

现象:{{symptom}}

输出:
1. 缺设计文档门、缺「先评价值再实现」,还是范围一次过大
2. 最小刹车机制
3. 下次验收标准
4. 人工确认清单
不要伪造「生成成本低就可以跳过产品否决」。

怎么做

  1. 粘贴当前栈痛点、目标单体边界,以及是否要求每阶段可回滚/向后兼容
  2. Agent 按实践帖输出:编号迁移任务表、先后端后分页前端、以及设计文档→实现节奏
  3. 人工保留架构决策与合入;Agent 不代你声称 3 周必生产可切或可无人值守改 DNS

实用提示

  • 源帖:SST/AWS 约 8 个月;2025-03 单月约 196 commit 多为基建;约 2025-08-18→2026-01-24 五个月零提交;2026-01-25 起约 3 周重写;squash 432 文件 +24,422/-11,569;16 设计文档约 237KB;月提交约 74→105(+42%);2026-02-16 一日四阶段 Media 表拆分;作者估无 AI 约 2–3 月全职;迁移枝仍在 feature 未最终合 main
  • 与 jeremy-keeshin-16-sites-linode-day-migrate / flowingcode-vaadin10-to-25-claude-afternoon / keith-townsend-gcp-local-migration-gap 不同:本条是产品架构 Serverless→单体重写+停更复活,不是主机迁、Vaadin 版本迁或云→本地演示鸿沟
#Serverless#单体重写#FastAPI#设计文档#技术债