简介:本文解决"AI 编程从入门到放弃"的核心问题:瓶颈不在模型能力,而在提示词结构。文章把传统软件工程流程拆成需求澄清、UI/UX 设计、编码实现、验证调试、部署上线五个环节,为每个环节给出可直接复制的专业级 Prompt 模板,并重点提供一套约束 UI 设计规范的 UI Designer 智能体提示词,解决 AI 生成界面"能用但很丑、无法集成"的问题。同时说明 ERNIE 5.5 Flash Preview 在长上下文代码理解、多步骤 Agent 工作流中的实际作用与使用边界。
很多人用 AI 编程的路径出奇一致:
把问题拆开看会发现,卡点几乎不在模型能力,而在 怎么开口 。同一个需求,有人越写越顺,有人越改越乱,差异主要来自提示词的结构化程度。想快速验证这一点,最直接的办法是拿同一个需求,分别用一句模糊描述和一套结构化提示词各跑一遍——可以先在 ERNIE 5.5 Flash Preview 在线体验 里输入需求,对比两次输出的差异。
另一个常被忽略的事实是:AI 编程并没有绕开传统软件开发架构,只是把每个环节的产出方式换成了”用提示词驱动”。需求设计 → 构建 → 验证 → 部署,每一环仍然需要软件工程方法论,才可能达到商业级质量。
| 环节 | 传统产出物 | 提示词要解决的核心问题 | 典型失败症状 |
|---|---|---|---|
| 需求澄清 | PRD / 技术方案 | 消除歧义,锁定技术栈与边界 | AI 自作主张换框架、加依赖 |
| UI/UX 设计 | 设计规范、组件清单 | 约束视觉与交互规范 | 界面”AI 味”重、组件不可复用 |
| 编码实现 | 代码与目录结构 | 限定文件边界与改动范围 | 一次改十个文件,越写越乱 |
| 验证调试 | 测试用例、修复记录 | 强制根因分析而非猜测式修补 | 改一个 bug,坏三个地方 |
| 部署上线 | 构建与发布配置 | 明确环境与回滚策略 | 本地能跑,线上白屏 |
下面逐个给出可复用模板。
这一步的目标不是让 AI 写代码,而是让它 先反问 。跳过澄清直接生成,是后续所有混乱的源头。
# 角色你是一位有 10 年经验的全栈技术负责人,擅长把模糊需求转成可执行的技术方案。# 任务我要开发:[用一句话描述产品,例如"一个团队内部使用的报销审批系统"]目标用户:[角色]核心场景:[用户完成什么任务]# 执行要求1. 先不要写代码。先用不超过 10 个问题向我澄清需求,问题按"影响架构 > 影响体验 > 影响实现"排序。2. 我回答后,输出技术方案,包含:功能清单(P0/P1 分级)、数据模型、接口列表、目录结构、技术栈选型及理由。3. 明确列出"本次不做"的范围(Non-goals)。4. 技术栈一经确认,后续所有输出必须沿用,不得擅自更换框架、库或目录约定。# 预期输出格式## 澄清问题## 功能清单(表格:模块 / 优先级 / 验收标准)## 数据模型## 接口设计## 目录结构## 技术栈与理由## 本次不做
关键在最后一条约束。绝大多数”AI 自作主张”都是因为一开始没有把技术栈钉死。
这是最容易被低估的一环。现在的 coding 模型基本都能”生成一个界面”,但生成出来的东西往往细看就不行:功能模块不完整、间距随意、颜色是模型偏爱的紫色渐变、组件无法复用,导致后面完全没法跟应用逻辑集成。
根因是缺少 设计规范约束 。下面这套 UI Designer 提示词的作用,就是把 AI 关进专业设计框架里工作。
# 角色你是一位资深 UI/UX 设计架构师,在视觉设计、用户体验原则、设计系统和现代界面开发方面拥有深厚专业知识,全面掌握设计理论、无障碍标准(WCAG 2.1 AA)、组件架构以及跨平台设计考量。# 核心职责1. 设计系统架构:创建具有清晰层次结构和依赖关系的可扩展、可维护设计系统,包括设计 token 分层(primitive → semantic → component)。2. 视觉与层次:定义排版比例、间距节奏(4/8px 基准)、色彩语义、阴影与圆角规范,确保信息层级清晰、视觉噪音可控。3. 组件设计:输出可复用组件清单,明确每个组件的 Props、状态(default/hover/active/disabled/loading/error/empty)、以及组合规则。4. 可访问性:正文对比度 ≥ 4.5:1,大字号 ≥ 3:1;所有交互元素支持键盘可达与可见 focus 状态;表单必须有 label 与错误提示关联;不使用颜色作为唯一信息载体。5. 跨平台适配:定义移动 / 平板 / 桌面三档断点与栅格规则,说明布局降级策略。6. 可落地性:所有设计必须能映射到具体前端实现方案,禁止输出无法实现的视觉效果。# 约束- 禁止默认使用紫色系渐变、居中大标题 + 三张卡片的通用落地页范式。- 禁止引入未在技术栈中确认的 UI 库;如需新增,先说明理由并等我确认。- 所有尺寸、颜色必须来自设计 token,不允许出现魔法数字。- 图标使用统一线性风格与统一线宽。# 输入产品:[名称与一句话定位]目标用户与使用场景:[ ]信息架构:[页面/模块列表]技术栈:[如 React + TypeScript + Tailwind CSS]品牌调性:[如 专业、克制、数据密集]# 预期输出1. 设计原则(3–5 条,说明取舍理由)2. 色彩 / 字体 / 间距 / 圆角 / 阴影 token 表3. 页面布局描述(分区 + 各区域信息优先级)4. 组件清单(表格:组件名 / 职责 / 关键 Props / 状态 / 对应页面)5. 可访问性检查项6. 响应式断点策略
提示词输出 token 表之后,最好让它直接产出可执行的配置文件,而不是停在描述层面:
{"color": {"primary": { "500": "#2563EB", "600": "#1D4ED8" },"surface": { "base": "#FFFFFF", "sunken": "#F8FAFC" },"text": { "primary": "#0F172A", "secondary": "#475569" },"semantic": { "success": "#16A34A", "warning": "#D97706", "danger": "#DC2626" }},"space": { "1": "4px", "2": "8px", "3": "12px", "4": "16px", "6": "24px", "8": "32px" },"radius": { "sm": "4px", "md": "8px", "lg": "12px", "full": "9999px" },"font": { "family": "system-ui, -apple-system, 'Segoe UI', sans-serif","size": { "xs": "12px", "sm": "14px", "base": "16px", "lg": "20px", "xl": "28px" } }}
有了这份 token,后续所有组件代码都引用变量,AI 就很难再”随手编一个颜色”。
编码阶段的提示词重点不是”帮我写个功能”,而是 限定改动范围与文件边界 。
# 任务实现功能:[功能描述],对应需求编号 [P0-3]# 输入上下文- 技术栈与目录约定:[粘贴环节 1 确认的目录结构]- 相关已有文件:[文件路径列表]- 数据模型 / 接口定义:[粘贴]# 执行要求1. 只修改实现该功能必需的文件,并在开头列出"将要修改的文件清单",等我确认后再输出代码。2. 严格复用已有工具函数与组件,不重复实现同类逻辑;如需新增公共方法,先说明放置位置。3. 完整输出被修改文件的内容,不要使用"// 其余代码保持不变"这类省略写法。4. 必须包含错误处理、加载态与空态;外部调用需设置超时与重试。5. 不引入新依赖;如确实必要,单独列出并说明体积与许可影响。6. 代码注释只解释"为什么",不解释"是什么"。# 预期输出## 修改文件清单## 完整代码## 自测步骤(含预期结果)## 已知限制与后续 TODO
第 3 条尤其重要。让 AI 输出省略代码,是”越写越乱”最常见的技术原因——它会悄悄改掉你没看到的地方。
“改一个 bug 坏三个地方”通常不是模型笨,而是提示词允许它 猜测式修补 。修复提示词必须强制根因分析。
# 角色你是擅长根因分析的高级工程师。你的原则:先定位,再修改;不理解原因绝不动代码。# 缺陷信息现象:[实际行为]期望:[预期行为]复现步骤:1.2.3.报错信息 / 日志:[完整粘贴]相关文件:[路径]最近改动:[描述,例如"上一次修改了 X 函数"]# 执行要求1. 先输出"可能原因列表",按可能性排序,每条说明判断依据(引用具体代码行或日志)。2. 指出如何用最小实验验证每个假设(打印、断点、单测、接口对比)。3. 只针对已确认的根因给出修复方案,并说明为什么这个修复不会引入回归。4. 列出受影响范围:哪些调用方、哪些页面、哪些边界情况需要回归测试。5. 输出一个可复现该 bug 的测试用例,修复后应通过。6. 如果信息不足以定位,明确指出还缺什么信息,不要编造。# 预期输出## 根因分析## 验证方法## 修复方案(完整代码)## 影响范围与回归清单## 测试用例
配合一份固定的回归检查清单使用,效果更稳:
npm test / pytest 无新增失败)
# 任务为 [项目名] 编写部署方案与配置。# 输入- 技术栈:[ ] 运行环境:[Node 20 / Python 3.11 等]- 部署目标:[云服务器 / 容器 / Serverless / 静态托管]- 现有 CI:[有/无,工具]# 执行要求1. 输出构建 → 检查 → 发布 → 验证 → 回滚 五阶段流程,每阶段给出具体命令。2. 环境变量集中管理,禁止在代码或配置文件中硬编码密钥;给出 .env.example。3. 提供 Dockerfile(多阶段构建,非 root 用户运行)与 CI 配置。4. 定义健康检查端点与失败判定条件。5. 明确回滚触发条件与回滚命令。6. 列出上线前检查清单与上线后 30 分钟观察指标。# 预期输出## 部署流程图(文字)## 配置文件(完整内容)## 上线检查清单## 回滚预案
上面五个环节的共同难点,是 AI 需要同时”记住”大量上下文:需求文档、目录约定、数据模型、已有代码、报错日志。上下文一超,它就会忘掉你定过的规范,开始自由发挥。
ERNIE 5.5 Flash Preview 是文心系列基础模型 ERNIE 5.5 Flash 的预览版本,重点优化了编程、智能体、知识工作与深度研究能力,支持 1M tokens 长上下文,可结合工具调用与 Agent 工作流完成多步骤任务。对应到本文的流程:
| 环节 | 模型可承担的工作 | 需要配合的外部条件 |
|---|---|---|
| 需求澄清 | 生成澄清问题、功能分级、接口与数据模型草案 | 无 |
| UI/UX 设计 | 输出设计规范、token 表、组件清单、可访问性检查项 | 界面预览需在浏览器中运行生成的前端代码 |
| 编码实现 | 生成/重构代码、跨文件改造、写测试 | 代码需在本地或云端 IDE 中执行与验证 |
| 验证调试 | 读长日志定位根因、生成复现用例 | 依赖实际运行环境与日志输入 |
| 部署上线 | 生成 Dockerfile、CI 配置、回滚预案 | 需在真实构建与发布环境中执行 |
需要说明的是,它是文本模型:渲染界面、跑测试、构建镜像、执行部署这些动作,都要由它生成代码或脚本,再由浏览器、终端、CI 等外部工具与 Agent 环境实际执行,而不是模型自身直接完成。
想验证效果,最直接的方式是把上面任意一个模板填好后,在 ERNIE 5.5 Flash Preview 在线体验 里跑一遍,重点观察两件事:它是否按格式输出、是否在信息不足时主动反问而不是编造。开发者也可以前往 百度智能云千帆模型详情页 了解模型能力与 API 接入方式,把这些提示词固化进自己的开发工具链。
如果不想记五个模板,记住这一个骨架也能覆盖大部分场景:
# 角色你是 [具体领域 + 资历] 的专家,擅长 [核心能力]。# 目标[一句话说明要达成的结果,可量化]# 输入- 技术栈/规范:[ ]- 已有代码/资料:[ ]- 限制条件:[性能、时间、依赖、兼容性]# 执行要求1. 信息不足时先提问,不要假设。2. 先给方案与改动清单,我确认后再输出完整实现。3. 严格遵守上述规范,不擅自引入新依赖或改变目录结构。4. 不省略代码,不使用占位式省略。5. 说明取舍理由与已知局限。# 预期输出[固定小标题结构,例如:分析 → 方案 → 完整代码 → 自测步骤 → 风险]
| 症状 | 根因 | 对应改法 |
|---|---|---|
| AI 擅自换框架/加库 | 未锁定技术栈 | 在提示词中固定技术栈并禁止变更 |
| 代码里出现”其余保持不变” | 未禁止省略输出 | 明确要求完整文件内容 |
| 改 A 坏 B | 允许猜测式修补 | 强制根因分析 + 影响范围清单 |
| 界面能用但很丑 | 缺设计规范约束 | 使用 UI Designer 提示词 + 设计 token |
| 长对话后 AI 忘了约定 | 上下文超限 | 分段任务、每轮重述关键约束、使用长上下文模型 |
| 一次改动横跨十几个文件 | 未限定改动边界 | 要求先输出文件清单并等待确认 |
AI 编程能不能用在真项目上,取决于你有没有把软件工程的约束写进提示词。三步就能开始:
建议先挑一个自己的小项目,把这套模板跑完整一轮,再逐步沉淀成团队自己的提示词库。现在就可以带着需求去 ERNIE 5.5 Flash Preview 在线体验 试一次,对比结构化提示词和随口提问的输出差距——这个对比,通常比任何教程都更有说服力。