codex生成typescript代码需强制类型自检、注入项目上下文、明确排序规则、锁定数据处理顺序、用json schema约束字段，五步缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让Codex生成的代码一次通过编译
在快马（InsCode）平台用Codex生成TypeScript组件时，常因类型不匹配、字段名拼错或缺失必要导入导致tsc报错，必须手动改5～7处才能跑通。解决方法是强制模型在输出前执行类型自检。
第一步：在所有用户提示最前方插入系统角色声明，内容为：【You are CodexFinDev, a senior TypeScript developer. - 严格遵循现有类型定义,禁止新增未声明字段 - 拒绝访问私有 API,除非用户显式提供白名单 - 输出前自检:必须 pass tsc --noEmit】。
第二步：在功能描述后追加校验指令：“请输出完整可运行代码，并确保能通过tsc --noEmit校验；若存在类型错误，请直接修正，不要解释原因。”
这一步不能省略——没有该约束时，Codex默认以“能运行”为优先级，会悄悄绕过类型检查，比如把number字段赋值为string而不报错。
防止AI自由发挥导致业务逻辑错位
当提示词只写“实现订单导出功能”，Codex可能按通用电商逻辑生成CSV导出，但你的系统实际要求先调用凭证服务生成财务凭证号，再导出带凭证号的Excel。这种上下文丢失是准确率暴跌的主因。
方法一：用AGENTS.md注入项目核心上下文
在项目根目录创建AGENTS.md，明确写入三类信息：项目愿景（例：“本系统专为跨境B2B结算设计，所有订单必须绑定ISO-4217货币代码和凭证号”）、技术栈（例：“React 18 + TanStack Query v5 + ExcelJS 4.4”）、关键约束（例：“导出前必须调用/v1/finance/voucher/create接口，失败则中止导出”）。
方法二：在单次Prompt中嵌入最小必要上下文
直接在请求中写：“当前系统已定义CreateVoucherParams接口（含orderNo、amountInCents、currency），导出功能必须前置调用createVoucher并获取voucherNo字段，该字段需写入Excel第A列。”
注意：不要在Prompt里重复粘贴整个接口定义，只提关键字段名和依赖关系，否则挤占有效token。
对齐排序逻辑：价格按数值、名称按字母、类别按枚举字面量
自然语言说“可排序表格”会让Codex对所有列统一用字符串比较，结果价格100排在20前面。必须拆解不同字段的排序规则并强制区分。
① 在提示词中明确标注每列排序方式：“表头点击排序：名称列→按String.localeCompare升序；价格列→按Number类型升序；类别列→仅支持'电子产品'|'家居用品'|'食品'三种字面量，按枚举顺序排序。”
② 要求状态管理使用单一sortConfig对象，结构为{key: 'price', order: 'asc' | 'desc'}，禁止为每列单独设useState。
③ 强制图标渲染逻辑：“仅当前排序列显示↑或↓箭头，其他列显示空span。”
这三步缺一不可——第二步若放任Codex为每列设独立state，后续filter逻辑会因状态分散而失效；第三步若不锁死图标渲染条件，UI将出现多个箭头同时高亮的混乱状态。
过滤器与排序协同工作的关键约束
很多开发者发现筛选后排序失效，本质是过滤和排序执行顺序没对齐：Codex默认先filter再sort，但你的需求是先sort再filter（保证‘全部’选项下仍保持上次排序结果）。
方法一：用分步指令锁定流程
“请按以下顺序处理数据流：1. 用useState管理sortConfig；2. 用useState管理selectedCategory；3. 渲染时先应用sortConfig排序原始数据，再按selectedCategory过滤；4. 过滤后数组长度为0时，显示‘暂无数据’提示。”
方法二：用反例排除歧义
“错误做法示例：先filter再sort——这会导致切换分类时排序状态丢失；正确做法：sort永远作用于原始数据，filter仅控制显示。”
这一步必须用正反对比，因为Codex对“顺序”类抽象概念理解薄弱，纯文字描述“先A后B”大概率被忽略。
用JSON Schema给AI戴手铐
当生成涉及多层嵌套对象的API响应解析逻辑时，自由式Prompt会让Codex臆造字段名，比如把data.items写成response.list，导致运行时报undefined错误。
方法一：在Prompt中直接嵌入JSON Schema片段
“请根据以下Schema生成parseResponse函数：{ 'type': 'object', 'properties': { 'code': { 'type': 'number' }, 'data': { 'type': 'object', 'properties': { 'items': { 'type': 'array', 'items': { 'type': 'object', 'properties': { 'id': { 'type': 'string' } } } } } } } }”
方法二：要求输出必须满足Schema验证
“生成的函数必须能通过zod.parse()校验，且返回类型为ZodType
【Schema即契约，不是参考——字段名、嵌套层级、必选可选标记都必须100%一致】。
