要让claude进行专业架构级peer review，需明确其首席架构师角色、提供完整上下文、按健康度模型结构化评审、引用权威基准，并建立迭代验证闭环。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望 Claude 对代码进行架构层面的 Peer Review，但其默认行为偏向通用问答而非专业角色扮演，则可能因提示词缺失、上下文不足或角色定义模糊导致反馈流于表面。以下是实现该目标的具体方法：
一、明确设定角色与职责范围
Claude 需在会话初始即被锚定为具备系统设计经验的资深架构师，而非普通开发者。该角色应聚焦可扩展性、模块边界、技术债识别、跨服务契约一致性等高阶维度，排除语法纠错或单函数优化类低层建议。
1、在首次输入中以指令形式声明角色：“你现在是拥有十年分布式系统经验的首席架构师，专精微服务治理与云原生架构。请以该身份对后续提供的代码进行严格的技术评审。”
2、紧随其后补充评审约束条件：“仅关注分层合理性、接口抽象质量、状态管理策略、可观测性埋点完备性、以及潜在的级联故障风险点。忽略变量命名、空格缩进等风格问题。”
3、提供最小必要上下文：“该服务部署于 Kubernetes 环境，依赖 Kafka 实现事件驱动，核心 SLA 要求 99.95% 可用性。”
二、结构化提交待审代码与场景说明
架构评审高度依赖运行环境与业务语义。零散粘贴代码片段将导致 Claude 缺乏上下文推演能力，无法判断某处同步调用是否违反最终一致性原则，或某类 DTO 是否隐含领域模型泄露风险。
1、使用清晰标题区隔各组件：“【订单服务】API 层入口控制器（OrderController.java）”
2、附带关键调用链说明：“该控制器接收 HTTP 请求后，经 Service 层协调库存扣减（同步 RPC）、积分更新（异步 Kafka）与物流触发（gRPC），最终返回响应。”
3、标注已知约束与权衡：“当前采用本地事务包裹库存扣减与订单持久化，未引入 Saga 模式，因业务方接受 T+1 订单补偿机制。”
三、注入架构评估框架引导输出深度
直接要求“给出评审意见”易触发泛泛而谈。需强制 Claude 按照工业界通行的架构健康度模型组织反馈，确保每个结论可追溯到具体原则依据。
1、指定评估维度模板：“请按以下四维度逐项评审：① 分布式一致性（CAP 权衡显式性、幂等设计覆盖度）；② 边界控制（限界上下文映射准确性、防腐层存在性）；③ 运维友好性（指标暴露粒度、日志追踪 ID 贯穿性、配置热加载支持）；④ 演进韧性（新增支付渠道时需修改的模块数量、适配器模式应用程度）。”
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、要求标注风险等级：“对每项发现的问题，必须标记为「阻断级」（导致数据不一致或服务不可用）、「严重级」（增加 30% 以上运维成本）或「建议级」（符合整洁架构但非强制）。”
3、禁用模糊表述：“禁止使用‘可以优化’‘建议考虑’等弱动词。须明确写出‘此处缺少幂等键生成逻辑，将导致重复下单时库存超卖’。”
四、提供对比基线强化判断依据
架构决策的有效性需参照行业基准。若未提供参照系，Claude 可能基于过时范式（如单体分层）评判现代事件驱动设计，或将合理技术选型误判为缺陷。
1、嵌入权威架构模式引用：“参照 Martin Fowler 提出的《Event Collaboration》模式，评估 Kafka 消息体是否包含完整业务上下文而非仅主键。”
2、绑定具体标准文档：“依据 AWS Well-Architected Framework 的可靠性支柱第 4.3 条，检查重试机制是否配置指数退避且上限不超过 5 分钟。”
3、限定技术栈约束：“本系统技术选型锁定 Spring Boot 3.x + Jakarta EE 9+，禁止建议使用 Quarkus 或 Rust 重构。”
五、迭代式澄清与证据验证
初次评审可能遗漏关键假设。需设计闭环验证机制，使 Claude 主动识别模糊点并索取必要证据，避免基于错误前提得出结论。
1、强制提问环节：“若以下任一信息缺失，请立即停止评审并列出所需材料：① 服务间调用拓扑图；② 核心实体的状态流转图；③ 近 30 天 Prometheus 中 error_rate 与 p99_latency 的相关性分析截图。”
2、设置反事实验证：“假设将当前同步调用库存服务改为异步事件，指出至少两个必须同步调整的补偿机制组件。”
3、要求引用代码行证：“所有关于‘缺少熔断器’的判断，必须指向具体类名与方法签名，例如 ‘PaymentService.invoke() 未包裹 HystrixCommand 或 Resilience4j 的 Bulkhead’。”
