结构化提示词需严格定义JSON Schema并绑定上下文锚点：开头粘贴完整Schema锁定字段，接口路径、错误码前缀、消息描述须精确；用“不可接受”案例封堵模糊表达；堆栈分析按关键词触发预设模板，强制文件行号与执行顺序。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codeium提示词工程科普内容常因字段定义模糊、边界不清晰，导致你照着操作却得不到结构化输出——比如要求生成API错误码说明，结果字段缺失或命名混乱；要求拆解堆栈，却得到一堆孤立建议而非执行流顺序步骤。

用结构化模板锁死字段名

在提示词最开头直接粘贴固定JSON Schema，一个字都不能少：“请严格按如下JSON Schema输出错误码说明,所有字段必须存在且不可合并、不可省略:{code:string, http_status:number, level:string(取值:'fatal'/'error'/'warn'),message_zh:string, message_en:string, cause:string, solution:string, example_call:string}”

【Codeium不会自动补全你没写的字段,漏一个就少一类信息】。如果你只写“包含code和message”，它可能把cause和solution全吞掉，或者擅自改成reason、fix等非标字段。

这一步必须写死，不能缩写、不能换词、不能加“例如”“如”等引导性虚词。

给每个字段绑定真实上下文锚点

方法一：接口路径必须与代码日志/ curl / OpenAPI完全一致
在错误码描述前加一句：“该错误码出现在 POST /v2/transaction/submit 接口响应体中”。
不要写“支付提交接口”，Codeium可能生成 /api/pay/submit 或 /payment/create 等变体。

方法二：code字段强制加业务前缀
原始code是4001，必须写成 PAY_4001；原始code是5003，必须写成 AUTH_5003。
这样团队成员在IDE里搜 PAY_4001 就能直接定位到同一段说明，不用再猜这是哪个模块的错误。

方法三：message_zh禁用泛称，改用具体约束描述
✘ “参数错误” → ✅ “user_id格式非法(非16位十六进制字符串)”
✘ “系统异常” → ✅ “Redis连接池耗尽(最大连接数配置为32，当前活跃连接33)”

用失败案例反向堵住空洞表达

在提示词末尾加一段“以下写法不可接受”，直接封死AI自由发挥空间：

✘ “对缺失值进行处理” → 缺失值在哪列？是空字符串、NULL、还是'N/A'？处理方式是填充均值、前向填充，还是丢弃？
✘ “统一日期格式” → 原始格式是‘2026/05/30’还是‘30-May-2026’？目标格式是ISO 8601还是Unix timestamp？
✘ “检查权限” → 检查哪类资源的权限？依据RBAC还是ABAC？失败时返回403还是跳转登录页？

每条都对应一个真实踩坑点，Codeium看到这种明确否定，会主动规避同类表达。

按错误类型匹配预设排查模板

第一步：识别堆栈首行关键词，触发对应逻辑链
检测到关键词“undefined”，启用【空值溯源三步法】：
① 找出调用链中最后一个非undefined值来源
② 检查该值被赋值时的条件分支是否全部覆盖
③ 验证接口返回结构与TS类型定义是否一致

第二步：禁用模糊词，强制绑定文件与行号
在报错堆栈后立刻追加：“所有分析必须基于/src/utils/apiClient.ts第42行展开，忽略其他文件中的同名函数。”
【Codeium对模糊禁令响应敏感，漏掉这句就会默认启用猜测模式】

第三步：步骤动词必须锁定执行流顺序
“请严格按以下三步处理：① 定位最内层异常发生行（不是第一行堆栈）；② 找出该行直接依赖的上一层变量或函数调用；③ 检查该依赖在调用前是否被正确赋值/初始化。”