资源与延伸阅读

提示词工程会随模型与 API 更新。以厂商文档为准；本课抓的是合同习惯（角色 / 任务 / 约束 / 格式、分隔、示例、schema、评估）。

OpenAI 目前把生产提示词当作 应用代码：进 Git、和功能一起评审，并用评估守门。平台上的可复用 prompt 对象正在弃用周期内（详见其 Deprecations 页）。评估请用你自己的金标题 + 脚本或第三方 runner，不要假设某一块托管 Eval 面板会永远在。

官方

资源	URL
OpenAI Prompting	https://developers.openai.com/api/docs/guides/prompting
OpenAI Prompt engineering	https://developers.openai.com/api/docs/guides/prompt-engineering
OpenAI Structured Outputs	https://developers.openai.com/api/docs/guides/structured-outputs
OpenAI 从 prompt 对象迁出	https://developers.openai.com/api/docs/guides/prompting/migrate-from-prompt-object
Anthropic Prompting best practices	https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices
Anthropic 文档首页	https://platform.claude.com/docs

读完本课只跟一门产品课即可，不必在五个界面里各抄一套四个构件。

产物	常见路径	作用
持久政策	`AGENTS.md`、`.cursor/rules`、`CLAUDE.md`	系统合同
任务模板	`prompts/*.md` 或带类型参数的模块	拼出 user 消息
金标题	`evals/gold.jsonl`	回归
Schema	与提示词放一起的 Pydantic / JSON Schema	输出合同

写不进金标题期望的句子，多半也不该进提示词。

厂商用语对照（避免搜文档时对不上）：

本课说法	OpenAI 常见说法	Anthropic 常见说法
系统合同	`instructions` / system message	system prompt
四个构件	角色放 system，任务与示例放 user	清楚直接；XML 分节
结构化输出	Structured Outputs / schema	工具或 JSON 模式（以当时文档为准）
评估	提示词当代码 + 自建 eval	用真实任务迭代，而不是空泛套话

本教程位于垦荒学园 / Kenhuang Academy。厂商文档变更时，请提 Issue 或 PR，同步更新 docs/zh/prompt-engineering/ 与 docs/en/prompt-engineering/。不要在 PR 里加入越狱、注入利用或社会工程内容。

延伸阅读若与本课冲突（例如教攻击步骤），以本课边界与厂商安全文档为准。