writing-system-prompts

系统提示词工程

结构胜过巧思。具体示例胜过抽象指令。

系统提示词是与模型之间的契约。每一行都必须以可测试的方式改变模型行为；其余内容都应删去，包括模型或其运行框架已经默认执行的事项。

章节顺序

按此顺序编写，并跳过不适用的章节。阅读 章节指南，了解每个章节的规则 以及正反示例。

1. Identity and role
2. Mission and stop criteria
3. Communication style
4. Core workflow
5. Tool usage rules
6. Domain-specific rules
7. Safety and constraints
8. Edge cases and error handling
9. Examples
10. Runtime context (injected at run time)

优质提示词的特点

• 角色具体明确，而不是“AI 助手”。
• 明确完成标准：何时停止，何时应当提问。
• 用数字限定回复长度（“少于 4 行”），不要用形容词（“简洁”）。
• 为 Agent 设定重试上限和升级处理路径。
• 对安全关键操作和破坏性操作分别设定限制，并各自说明原因；每项原因只说明一次。
• 提供 3-10 个具体示例，展示长度和语气、工具调用决策及边缘情况，且至少包含一组从错误到正确的示例。示例是提示词中回报最高的部分。
• 设置运行时上下文章节，说明每次会话都会变化的值。

编写

• 推断对话和提供的文件已经回答了哪些问题。
• 只询问剩余问题，一次性发出并等待回复：AI 要做什么、用户是谁、它有哪些工具、“完成”是什么样、哪些事情绝不能发生，以及预期的输出格式。
• 在围栏代码块中提供提示词，随后每项假设单独占一行。

审查

将提示词对应到章节顺序，指出缺失和位置不当的章节。 标记其中存在的每项审查反模式。 然后进行修改。除非用户要求其他格式，否则按以下格式报告：

## Findings

| Section | Issue | Fix |
| ------- | ----- | --- |

## Revised prompt

```text
<the full revised prompt>
```