Codex生成代码需严格遵循项目风格:前置四要素声明、提供少样本示例或引用AGENTS.md、执行最小改动三步法,确保命名、错误处理、类型安全等统一。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

让Codex生成的代码与项目现有风格保持一致,避免命名混乱、结构错位、错误处理不统一等问题,是团队协作和Code Review顺利通过的关键前提。
用四要素指令锚定风格
第一步:在每次让Codex写代码前,必须在Prompt最开头插入四要素声明,不换行、不加解释、不缩进:【Goal:生成符合当前项目规范的用户注册逻辑;Context:位于src/features/auth/register.tsx,已有useForm封装;Constraints:类名必须带Feature前缀(如RegisterFeature),错误提示用Toast.error而非alert,禁止使用any类型;Done when:函数名动词开头小驼峰(handleSubmit ✅,handleSubmitFn ❌),参数≤3个,每函数≤25行】
这一步必须写在Prompt最前面。如果写在中间或末尾,Codex大概率忽略——它不会主动回溯上下文去猜你的“规范”是什么。
第二步:删掉所有冗余说明。不要写“请参考项目风格”,不要加“谢谢”“辛苦了”,不要解释四要素含义。Codex只认结构化、前置、无干扰的声明。
注入项目级风格锚点
方法一:提供少样本示例
直接贴出2~3段项目中真实存在的、风格典型的代码片段,每段前加简短说明:
这是登录表单的提交处理函数(注意命名+早期返回+Toast调用):
const handleLogin = () => { if (!formState.email) return Toast.error('邮箱不能为空'); api.login(formState).then(() => navigate('/home')); };
配置 OpenClaw 多提供商认证与 OpenAI Codex OAuth 备用方案,实现自动模型切换,适用于多 OpenAI Codex 账户设置。
这是用户列表组件的命名方式(注意Feature后缀+Props接口命名):
interface UserListFeatureProps { users: User[]; }
export const UserListFeature = ({ users }: UserListFeatureProps) => { };
方法二:引用AGENTS.md文件
请先读取./AGENTS.md中的代码规范章节,特别是“命名规则”“组件结构”“错误处理”三节,再生成register逻辑。注意:AGENTS.md必须存在且路径准确,否则Codex会静默跳过。
强制执行最小改动原则
第一步:先让Codex只读不改
请不要修改任何文件。请分析src/features/auth/下的所有TSX文件,列出当前已使用的Hook命名模式、Toast调用方式、表单验证逻辑位置。
第二步:确认最小方案
基于上一步分析,请给出本次注册功能的最小改动方案:是否复用现有useAuth Hook?
第三步:对比验证
生成代码后,立即检查三项:① 函数名是否动词开头小驼峰;② 所有Toast调用是否未用alert替代;③ 是否出现any类型或超过3个参数的函数签名。

















