提示词工程技巧
提示词工程是为像 itBuilder 这样的 AI 模型编写高效指令的艺术。良好的提示词能带来更好的结果、更少的错误和更高效的工作流。
通用原则
-
清晰具体： 明确说明你希望 itBuilder 做什么，避免歧义。
- 错误示例： 修复代码。
- 正确示例： 修复
calculateTotal函数导致其返回结果错误的 bug。
-
提供上下文： 使用 上下文引用 指定具体文件、文件夹或问题。
- 正确示例：
@/src/utils.ts重构calculateTotal函数以使用 async/await。
- 正确示例：
-
拆解任务： 将复杂任务分解为更小、定义明确的步骤。
-
给出示例： 如果你有特定的编码风格或模式，提供示例。
-
指定输出格式： 如果你需要特定格式的输出（如 JSON、Markdown），请在提示词中说明。
-
迭代优化： 如果初始结果不理想，可以不断优化你的提示词。
思考与执行
引导 itBuilder 采用“先思考，后执行”的流程通常很有帮助：
- 分析： 让 itBuilder 分析当前代码，找出问题或规划方案。
- 规划： 让 itBuilder 列出完成任务的步骤。
- 执行： 让 itBuilder 按步骤逐一实现。
- 复查： 每一步完成后仔细检查结果再继续。
使用自定义指令
你可以通过自定义指令进一步调整 itBuilder 的行为。自定义指令分为两类：
- 全局自定义指令： 适用于所有模式。
- 模式专用自定义指令： 仅适用于特定模式（如 Code、Architect、Ask、Debug 或自定义模式）。
自定义指令会被添加到系统提示词中，为 AI 模型提供持久性指导。你可以用它们来：
- 强制执行编码风格规范。
- 指定首选库或框架。
- 定义项目专用约定。
- 调整 itBuilder 的语气或个性。
详见 自定义指令 章节。
处理歧义
如果你的请求存在歧义或细节不足，itBuilder 可能会：
- 做出假设： 可能会根据自己的判断继续，但未必符合你的预期。
- 追问澄清： 可能会使用
ask_followup_question工具向你提问以澄清需求。
通常建议一开始就提供清晰具体的指令，以避免不必要的反复沟通。
提供反馈
如果 itBuilder 没有产生理想结果，你可以通过以下方式反馈：
- 拒绝操作： 当 itBuilder 提议你不想要的操作时，点击“拒绝”按钮。
- 说明原因： 拒绝时说明为什么拒绝，这有助于 itBuilder 从错误中学习。
- 重述请求： 尝试重新表述你的任务或提供更具体的指令。
- 手动修正： 如果只有少量小问题，也可以在接受更改前直接修改代码。
示例
良好提示词：
@/src/components/Button.tsx重构Button组件，使用useState替换useReducer。
不良提示词：
修复按钮。
良好提示词：
新建一个名为
utils.py的文件，并添加一个名为calculate_average的函数，接收一个数字列表并返回其平均值。
不良提示词：
写点 Python 代码。
良好提示词：
@problems解决当前文件中的所有错误和警告。
不良提示词：
全部修复。
遵循这些技巧，你可以编写高效提示词，充分发挥 itBuilder 的能力。