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

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

yureki:Claude Code 迁 40 个 REST→GraphQL——12 天,差分 harness 0/500→500/500

个人;披露 12 天、约 40 端点、差分 500 条签名;p95 约 1340→480ms、往返 6→1;N+1 曾吃掉两天;不代你任意仓同速。

场景说明

面向要把有机生长的 REST 面迁到 GraphQL、却卡在「如何证明新旧返回一致」的后端/移动协作:把「先建差分记分板再写 schema」写成门禁,区别于云账单迁机与静态档案后处理。

案例叙事

01他们做了什么

yureki_lab 在 DEV《How I Migrated 40 REST Endpoints to GraphQL With Claude Code in 12 Days》(datePublished 2026-08-29)写明:把 Claude Code 当苦力引擎,但真正堵点不是写 resolver,而是证明新 API 与旧 REST 返回等价。

关键门禁不是「先写完 schema 再补测」,而是先建差分 harness(录流量→规范化→深比较),再让代理对着数字迭代;N+1 还要第二块查询数记分板。架构与切流仍由人定。

本场景据此输出「API 等价迁移门禁」提纲。禁止把 12 天或 500/500 写成任意仓 SLA,或建议跳过差分直接切全量流量。

02实际效果

  • 源披露约 12 天、约 40→37 端点、差分 0/500→500/500、往返 6→1、p95 约 1340→480ms、N+1 曾 151 查询等作者口径;属单人/单仓督导窗口,不可外推为你的发布列车工期或「同 harness 必同速」。
  • 能把「可让代理刷绿的机械改写」与「必须人定的兼容/切屏策略」拆开。
  • 为「差分全绿仍 9× 慢」提供查询数第二记分板提问清单。

03值得知道

  • 工期、p95 与 harness 计数为作者自述;无第三方审计。
  • 特性开关切屏与 partner 集成仍须人;代理不能替你验收业务语义。
  • 上面写的是个人实践帖,不是 GraphQL/Anthropic 官文简报。

04可复制提示词

REST→GraphQL 等价门禁

你是资深 API 迁移教练。只根据用户边界写门禁,不要编造已通过的差分条数或 p95。

REST 面与客户端:{{scope}}
不可改行为:{{compat}}
不可无人执行:{{no_auto}}

输出 Markdown:
1. 录流量→差分 harness→schema/resolver→切流的最小阶段表
2. 「0/N→N/N」记分板如何定义(规范化/深比较)
3. N+1 的第二记分板(查询数断言)最低要求
4. 人必须批准的清单(删端点/特性开关)
禁止声称「必 12 天」;禁止建议未差分就全量切流量。

差分全绿仍变慢复盘

差分 harness 已接近全绿,但负载测显示 GraphQL 远慢于旧 REST。请写复盘提纲。

现象:{{symptom}}

输出:
1. 更像 N+1、缺 DataLoader,还是缺查询数断言
2. 最小修补与重跑顺序
3. 下次验收标准(正确性+性能)
4. 人工确认清单
不要伪造「再开并行会话等于已修 N+1」。

怎么做

  1. 粘贴 REST 面范围(端点数/客户端约束)、不可改行为清单,以及「绝不可无人切流」项
  2. Agent 按实践帖输出:录流量→差分 harness→schema/resolver→N+1 查询数门禁→特性开关切屏表
  3. 人工保留兼容裁决与发布列车批准;Agent 不代你保证「必 12 天或同 p95」

实用提示

  • 源帖(JSON-LD datePublished 2026-08-29T14:32:38Z → 2026-08-29):yureki_lab 用 Claude Code(披露 Opus 5)把约 40 个有机 REST 端点迁到 GraphQL。先录请求签名建差分 harness,起点 0/500,日 6 约 461/500,终 500/500;迁成 37 个端点(删 3)。披露屏级往返 6→1、p95 约 1340→480ms,并删客户端正规化层约 620 LOC。日 7–8 负载测:50 订单+用户+订阅曾打出 151 次库查询(约 9× 慢于旧 REST),靠 DataLoader 与查询数断言补第二块记分板。约束:REST 不能冻结、要求 bug-for-bug。主线是「给代理记分板」的高风险机械重构,不是官文简报。
  • 与 yureki-agent-tool-noop-observability / arezvov-ghost-nextjs-claude-cursor-migration 不同:本条是 REST→GraphQL 等价证明与 N+1 第二记分板,不是工具 noop JSONL 观测或博客栈迁移
#Claude Code#GraphQL#REST#差分测试#N+1