明确需求阶段、硬约束和上下文代码可解决AI生成无效代码问题；用规范文档喂AI、IDE实时校验或RAG技术可避免规范冲突；通过CLAUDE.md固化关键约定能防止上下文丢失；先定义参数契约再写测试可减少脱节；在请求工具中硬编码安全校验能强制AI补全签名逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
需求模糊导致AI反复生成无效代码
当你只说“做个登录页”，AI可能输出带JWT鉴权的完整前后端，也可能只给你一个含用户名密码输入框的HTML片段，两者都算“正确”，但完全不匹配你真实场景。
第一步：在提示词开头明确标注项目阶段——用【MVP】/【迭代v2】/【重构】等标签强制锚定上下文。
第二步：紧接写出三个不可妥协的硬约束，例如：【必须使用Pinia管理状态】、【所有API调用走/src/api/index.ts统一出口】、【禁止任何console.log残留】。
第三步：粘贴当前项目已有的相关代码片段（如已有useAuthStore.ts），让AI在真实上下文中缝合，而非凭空创造。
AI生成代码与现有工程规范冲突
常见于团队已约定ESLint规则、目录结构、Hook命名习惯，但AI按自己训练数据里的“通用最佳实践”输出代码，直接破坏一致性。
方法一：把团队《前端开发规范.md》全文喂给AI，并要求每段输出后附带“本段代码符合规范第X条”的说明。
方法二：在IDE中启用实时校验插件（如ESLint+Prettier），AI生成后自动标红不合规处，你只需聚焦修复标红行，不需通读全文件。
方法三：用RAG技术将规范文档向量化，接入AI编码工具，在生成前自动检索并注入最新规范条款——这步需要运维同学配合搭建，但一次配置永久生效。
上下文丢失引发逻辑断层
对话进行到第12轮时，AI突然把之前确认过的“用户ID用BigInt存储”改成string，因为你的初始约束被长对话挤出了上下文窗口。
立刻打开项目根目录，新建CLAUDE.md文件，用纯文本写死三件事：①核心数据类型映射表（如user.id→BigInt）；②所有已废弃的临时方案（如“已否决localStorage持久化方案”）；③本次迭代的终止信号（如“当导出功能支持字段配置即停止”）。
在克隆的 Git 仓库中驱动完整的规格驱动开发生命周期（init→需求→架构→流程设计→项目计划→编码→测试→缺陷修复→代码审查→发布）。阶段门控、产物强制输出、多语言支持，内置提交机制。
每次向AI提新需求前，先复制CLAUDE.md全文粘贴到对话框顶部——这比依赖AI记忆可靠10倍。
注意：CLAUDE.md必须用UTF-8无BOM编码保存，否则某些Agent会误读中文注释为乱码。
测试用例与实现代码严重脱节
你让AI“生成导出Excel的单元测试”，它真给你写了testExportToXlsx()，但函数里校验的是固定7列数据，而实际业务要求列数动态可配。
强制要求AI在生成测试代码前，先输出该函数的输入参数契约（interface ExportOptions），包含必填字段、可选字段、类型约束。
拿到契约后，你手动补全一行注释：// 实际字段列表由后端配置返回，前端仅做透传。再把这行注释连同契约一起发回AI，让它重写测试。
这一步能砍掉70%的测试返工——因为契约是静态的，而业务逻辑是动态的，AI擅长处理前者。
安全校验逻辑被AI悄悄绕过
当你没明说“所有接口必须带X-Signature头”，AI大概率在生成的fetch调用里漏掉签名步骤，尤其在快速迭代时，它会复用旧逻辑而不校验新约束。
在项目/src/utils/request.ts中，找到createRequestClient函数，在return语句前插入硬编码校验：【if (!config.headers['X-Signature']) throw new Error('Missing X-Signature')】。
这行代码会像地雷一样炸出所有漏签的请求，逼AI在后续生成中主动适配签名逻辑，而不是靠你肉眼排查。
