Claude Code 後端架構師 Subagent：API 契約先行 + 微服務邊界設計

01PROMPT

要開一個新後端服務或 API，與其自己亂切邊界，不如叫一個專職架構師子代理：先定服務邊界與 API 契約，再規劃同步/非同步通訊、韌性與可觀測性。

[ 登入後可看完整內容 ]

02CONTEXT / 使用情境

## 這是什麼／解決什麼痛點 開一個新後端服務最常見的災難是「邊界亂切」：服務拆得太細導致到處跨服務呼叫、或拆得太糊導致一改全動；API 沒有契約、版本一升就破壞下游；韌性與可觀測性永遠是「之後再補」結果上線就被打爆。這個「後端架構師」子代理把這些決策結構化成一條 10 步流程：先釐清非功能性需求（規模、延遲、一致性），再用領域驅動設計（DDD）切邊界，接著契約先行設計 API，最後才把韌性、可觀測性、安全、效能、測試、部署一一規劃進去。 它的核心信念寫得很清楚——「清楚的邊界、明確的契約、從第一天就內建的韌性」，而且務實到會提醒你「能用單體就先別硬切微服務」。這正是很多團隊缺的那位會踩煞車的資深人。 ## 為什麼這來源值得用 wshobson/agents（Seth Hobson 維護，MIT 授權，GitHub 3.6 萬星以上）的 backend-architect 不是空泛的架構口號，而是把每個面向都鋪到可操作的技術選項：API 涵蓋 REST/GraphQL/gRPC/WebSocket/SSE 與分頁（offset/cursor/keyset）；微服務談到 DDD 拆分、service discovery、API Gateway、service mesh、strangler/saga/CQRS；事件驅動列出 Kafka/RabbitMQ/SQS 與 event sourcing、dead letter queue；韌性點名 circuit breaker、指數退避、bulkhead、冪等性；可觀測性指定 OpenTelemetry + correlation ID + RED 指標。框架層面也涵蓋 Node（Express/NestJS/Fastify）、Python（FastAPI/Django）、Java（Spring Boot/Quarkus）、Go（Gin/Echo）、.NET、Rust 等。這份廣度讓它能在你的技術棧內給出具體建議，而不是只會講原則。 ## 怎麼用（步驟） 1. 在專案建立 `.claude/agents/backend-architect.md`，貼入 full_prompt 的規格。注意 `model: inherit` 表示沿用你當前對話的模型——架構設計需要較強推理，建議在 Claude Code 裡用較強的模型主對話。 2. 觸發：「用 backend-architect 設計 X 服務」。把業務需求、預期規模、延遲與一致性要求一次講清楚，它的第一步就是釐清這些。 3. 它會依序產出服務邊界、API 契約（OpenAPI/GraphQL 片段）、Mermaid 架構圖、韌性與可觀測性策略、技術選型理由、部署策略，並附取捨與替代方案。 4. 把 ADR 與圖存進 repo，作為團隊的架構決策依據。 5. 接力：它刻意把資料庫 schema 細節留給 database 專家、把資安深掃留給 security-auditor，所以適合與那些子代理串成一條流水線。 ## 何時用 - 從零開立新的後端服務或對外 API 時。 - 要把一個單體拆成多個服務、或評估「該不該拆」時。 - 設計服務間通訊（同步 vs 非同步）、引入訊息佇列或事件串流時。 - 不適合拿它做純資料庫調校或前端架構——那不是它的職責邊界。 📎 來源：wshobson/agents（作者 Seth Hobson，MIT 授權）— 本篇為繁中改寫整理，原始內容見上方連結。