⚠️ Alpha内测版本警告:此为早期内部构建版本,尚不完整且可能存在错误,欢迎大家提Issue反馈问题或建议
Skip to content

1.2.3 如何向 AI 下达指令——提示工程基础:如何与 AI 有效沟通

一句话破题

提示工程的本质是用结构化的语言表达清晰的意图。好的提示词不是华丽的修辞,而是精准的需求定义。

核心原则:清晰、具体、结构化

原则 1:清晰

AI 无法读心,它只能理解你表达出来的内容。

❌ 模糊:帮我优化一下这个代码
✅ 清晰:帮我优化这个函数的性能,目前它处理 10000 条数据需要 5 秒,目标是降到 1 秒以内

原则 2:具体

提供足够的上下文,让 AI 知道你在什么场景下需要什么。

❌ 泛泛:写一个登录功能
✅ 具体:用 Next.js 16 App Router 写一个登录页面,使用 Server Actions 处理表单提交,
        支持邮箱+密码登录,使用 Tailwind CSS 做样式

原则 3:结构化

用清晰的结构组织你的需求,让 AI 更容易理解和执行。

## 需求描述
实现一个用户评论组件

## 技术要求
- 框架:Next.js 16
- 样式:Tailwind CSS
- 数据:从 API 获取评论列表

## 功能要点
1. 显示评论列表(头像、用户名、内容、时间)
2. 支持点赞
3. 支持回复

## 约束条件
- 需要处理加载状态和空状态
- 需要处理错误情况

提示词模板:功能描述 + 交互方式 + 预期效果

这是一个万能的需求定义公式:

[功能描述]:我想要实现什么功能
[交互方式]:用户如何与这个功能交互
[预期效果]:成功后应该看到什么结果

示例

功能描述:实现一个搜索框组件
交互方式:用户输入关键词,按回车或点击搜索按钮触发搜索
预期效果:搜索时显示加载动画,结果返回后展示搜索结果列表,无结果时显示"未找到相关内容"

分步对话策略

不要试图一次让 AI 生成所有代码。分步走,每一步都确认无误后再进行下一步:

对话示例

你:帮我设计一个博客文章的数据结构,需要包含标题、内容、作者、发布时间、标签

AI:[生成数据结构]

你:很好,现在基于这个数据结构,帮我写一个获取文章列表的 API

AI:[生成 API 代码]

你:API 没问题,现在帮我写一个展示文章列表的组件,使用刚才的 API

AI:[生成组件代码]

关键术语清单

在与 AI 讨论代码时,使用准确的技术术语可以大幅提高沟通效率:

场景关键术语
Next.jsApp Router, Server Component, Client Component, Server Actions, Middleware
ReactuseState, useEffect, props, children, 条件渲染, 列表渲染
TypeScriptinterface, type, 泛型, 联合类型, 类型守卫
Tailwindflex, grid, responsive, dark mode, 自定义主题
数据库CRUD, 关联查询, 事务, 索引, 迁移

常见问题的提示词模板

需求开发

请帮我实现 [功能名称]。

技术栈:[Next.js/React/TypeScript 等]
要求:
1. [具体要求 1]
2. [具体要求 2]
3. [具体要求 3]

参考:[如果有类似功能的参考,贴上来]

Bug 修复

我遇到了一个问题:[描述问题现象]

相关代码:
[粘贴相关代码]

错误信息:
[粘贴完整错误信息]

我已经尝试过:
1. [尝试过的方法 1]
2. [尝试过的方法 2]

代码优化

请帮我优化以下代码:

[粘贴代码]

优化目标:
- [性能优化 / 可读性优化 / 安全性优化]

约束条件:
- [保持 API 不变 / 兼容旧版本 / 等]

避坑指南

  • 不要一口气要求太多:任务越大,AI 出错的概率越高
  • 及时纠正错误:发现问题立即反馈,不要等到最后
  • 保存有效的提示词:好的提示词可以复用
  • 理解 AI 的局限性:它的知识有截止日期,新特性可能不了解