// role: 资深后端架构师; scenario: 评审「跨境订单履约状态自动回传至shopify」需求,当前prd文档版本v1.3,已知对接shopify admin api v2024-10,日均订单量8.2万单。状态变更后即时推送。‘即时推送’中的‘即时’,是指从erp系统触发事件开始计时,还是从mq消费成功后开始计时?要求的p99延迟阈值是多少毫秒?若超时是否降级为异步批量回传?‘所有状态变更’是否包含‘已取消’‘已作废’等终态?退货流程中产生的‘部分退款成功’是否触发回传?若shopify侧同一order_id在5分钟内收到2次status=paid,后端是否拒绝第二次?当前依赖的erp接口平均响应时间为1.2s,p99为3.8s。若该接口连续3次超时(>5s),本需求是否允许跳过状态校验直接回传?若允许,回传的status字段应填什么值?erp系统中‘部分发货’对应status=fulfilled,但shopify要求同一order_id下multiple fulfillments需单独创建fulfillment对象——此处是拆成多条回传,还是聚合为单次回传并忽略fulfillment_id?
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Codeium在需求评审环节精准暴露模糊点、遗漏约束和隐性风险,而不是泛泛而问“这个需求有没有问题”,否则它只会返回“逻辑基本完整”这类无效反馈。真实评审会上,产品经理刚说完“支持实时同步”,技术负责人立刻追问“实时指端到端延迟≤200ms还是仅指消息发出即算完成”,这种带量纲、锚定技术行为的提问才有效。
先锁定角色与上下文再提问
在提示词最开头插入一行注释:// Role: 资深后端架构师; Scenario: 评审「跨境订单履约状态自动回传至Shopify」需求,当前PRD文档版本v1.3,已知对接Shopify Admin API v2024-10,日均订单量8.2万单。
这行注释必须顶格写,不缩进、不加空行。漏掉API版本或日均量级,Codeium会默认按千单级场景评估,忽略高并发下的幂等性、重试频次等关键约束。
【必须】把PRD原文中“状态变更后即时推送”这句话原样复制粘贴到提示词里,不加引号、不换行、不润色——这是触发AI识别模糊表述的锚点。
用三类具体问法逼出可执行澄清
方法一:对时间类描述追问量纲与测量点
“‘即时推送’中的‘即时’,是指从ERP系统触发事件开始计时,还是从MQ消费成功后开始计时?要求的P99延迟阈值是多少毫秒?若超时是否降级为异步批量回传?”
方法二:对范围类描述追问边界与例外
“‘所有状态变更’是否包含‘已取消’‘已作废’等终态?退货流程中产生的‘部分退款成功’是否触发回传?若Shopify侧同一order_id在5分钟内收到2次status=paid,后端是否拒绝第二次?”
方法三:对依赖类描述追问SLA与兜底方案
“当前依赖的ERP接口平均响应时间为1.2s,P99为3.8s。若该接口连续3次超时(>5s),本需求是否允许跳过状态校验直接回传?若允许,回传的status字段应填什么值?”
注意:每个问句都必须含一个可测量参数(如“5分钟内”“P99为3.8s”)和一个技术动作(如“拒绝第二次”“跳过状态校验”)。没有参数的问句会被AI当作开放讨论处理,不会进入边界确认流程。
强制AI停在澄清阶段不输出方案
第一步:开头指令锁死动作边界
只做需求边界确认,不写实现逻辑、不列功能清单、不画状态流转图。
第二步:列出你已知的硬性约束
【必须】仅通过Shopify Admin API v2024-10的POST /admin/api/2024-10/orders/{id}/events接口回传;
【必须】每次回传携带X-Shopify-Access-Token请求头,token有效期≥24小时;
【必须】status字段值必须严格匹配Shopify文档定义的枚举,不允许映射转换。
第三步:用问句暴露模糊点
“ERP系统中‘部分发货’对应status=fulfilled,但Shopify要求同一order_id下multiple fulfillments需单独创建fulfillment对象——此处是拆成多条回传,还是聚合为单次回传并忽略fulfillment_id?”
请逐条确认以下约束是否完整:
如有未覆盖的隐性规则,请指出缺失维度(如合规审计要求、区域数据主权限制、第三方平台调用配额);
确认完毕前,不生成任何需求描述或验收标准。











