Definition
代码提示工程
代码提示工程是精心设计清晰、具体指令的实践，帮助 AI 编程工具产出准确、相关的结果。它涉及以适当的上下文、约束条件和示例来构建你的请求，以便 AI 理解你想要什么以及你希望如何实现。
提示词质量对编程的重要性
提示词的质量直接决定 AI 输出的质量。"修复这个 Bug"这样的模糊提示会迫使 AI 猜测你的意思。而"当缺少 email 字段时，/api/users 端点返回 500——请用 Zod 添加输入验证，并返回带有描述性错误信息的 400 响应"这样的具体提示则提供了 AI 第一次就能生成正确代码所需的一切信息。
高效代码提示的关键技巧
- +具体说明期望的结果，而不仅仅是问题
- +包含约束条件：要遵循的语言、框架、模式和规范
- +按名称引用现有文件，让 AI 知道去哪里查找以及需要匹配什么
- +必要时将复杂任务拆分为较小的连续提示
- +指定输出格式："编写一个函数"、"修改现有处理器"、"添加测试文件"
- +包含否定约束："不使用任何外部依赖"或"不修改数据库 Schema"
text
# Weak prompt
> "Add authentication"
# Strong prompt
> "Add JWT authentication to the Express API:
- Use the existing User model in lib/models/user.ts
- Add login and register endpoints to routes/auth.ts
- Protect all /api/admin/* routes with middleware
- Store JWT secret in environment variable AUTH_SECRET
- Write tests in __tests__/auth.test.ts
- Follow the error handling pattern used in routes/users.ts"使用 Claude Code 等 Agentic 工具时，可以将上下文放入 CLAUDE.md，而无需在每条提示词中重复。将编码规范、架构决策和常用模式写入 CLAUDE.md 文件。
在使用 Agentic AI 的情况下，提示工程仍然必要吗？+
必要，但重心从精确语法转移到了清晰意图。Claude Code 等 Agentic 工具可以读取项目获取上下文，但你仍需清楚地传达你想要什么以及适用的约束条件。
最常见的提示工程错误是什么？+
过于模糊。开发者经常用"添加功能 X"来提示，却没有说明在哪里、如何添加，或应遵循什么规范。你对约束条件和预期行为越具体，结果就越好。
在代码提示中应该使用少样本示例吗？+
应该，当输出格式很重要时。如果你希望 AI 遵循特定模式，展示该模式的一个示例。对于编程任务，引用遵循所需模式的现有文件（"遵循 routes/users.ts 中的风格"）通常比从零开始写示例更有效。
CLAUDE.md 文件与提示工程有什么关系？+
CLAUDE.md 是一种持久化提示工程。你只需将项目上下文写一次放入 CLAUDE.md，Claude Code 就会在每次会话中自动应用，而无需在每条提示词中重复。它将团队的规范、规则和偏好编码为持久指令。
Related terms
Master Claude Code in days, not months
37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.
START FREE →