你有没有遇到过这种情况：想让AI帮你生成一个登录页、后台系统或者数据看板，指令发出去之后，拿到的代码要么缺功能、要么跑不起来、要么风格完全不对——问题往往不出在AI的能力边界，而是你第一句话就把需求说含糊了。

为什么“我想做个登录页”这种说法会失败

AI没有读心术。它没法从“做个登录页”这种模糊意图里猜出你真正要的：是面向内部员工的极简表单，还是带微信扫码、密码、信息三合一的C端产品入口？它默认按最简逻辑实现，结果就是你反复改三次才勉强接近预期。必须把“谁用、在哪用、为什么用、不能错什么”一次性塞进第一条消息里，AI才能锚定上下文，不走偏。

写出高质量Vibe Coding需求描述的三步法

第一步：先写背景与目标（Why）
用一两句话说清楚这个功能存在的真实原因。别拍脑袋，要落地。比如：“当前销售团队每天手动导出Excel，再发邮件同步客户线索，平均每人每天花费47分钟。本需求要替换为前端一键导出PDF，并自动推送至钉钉群。”这样AI一上来就知道它要解决效率痛点，而不是凭空堆代码。

第二步：明确使用场景（Context）
列出3个以上具体触发条件。越细越好，避免AI猜。比如：
• 销售在CRM网页端点击“导出线索”按钮
• 导出文件名需包含当天日期和销售姓名（如“张三_20260609.pdf”）
• 钉钉机器人需携带文件直传，不走本地中转

第三步：定义核心需求（What）
分点写，每点只讲一件事。禁用“尽量”“优化”“合理”这类主观词，它们只会让AI无所适从。正确示范：
1. 前端按钮固定在CRM线索列表右上角
2. 点击后立即生成PDF，不弹窗、不跳转
3. PDF包含表头、线索编号、客户名称、联系人、电话、创建时间共6列
4. 导出失败时显示红色Toast提示“导出失败，请重试”，不报控制台错误
【导出失败必须静默处理，否则销售会误以为系统崩溃】

两个高频踩坑点及修正方式

方法一：避免用“用户友好”“体验流畅”这类主观词
错误示范：“做一个用户友好的搜索框”
正确写法：“搜索框需支持中文输入即时过滤，输入‘上海’后0.3秒内列表只显示地址含‘上海’的客户，且光标始终停留在输入框末尾。”把主观感受翻译成可观测、可度量的指标，AI才能精准执行。

方法二：关键约束必须前置声明
错误示范：“我需要一个文件上传功能”
正确写法：“文件上传功能仅用于内部审计系统，所有上传文件必须：
• 限制类型为.xlsx、.pdf、.docx
• 单文件≤50MB
• 上传后自动重命名为‘部门_日期_原始名’（例：财务_20260609_报销单.xlsx）
• 不存本地，直传至阿里云OSS bucket ‘audit-prod-2026’”
约束前置，等于给AI画好跑道，它就不会乱跑乱跳。