prompt-engineer

提示词工程

为用户的目标模型创建或修订提示词。让通用提示词保持可移植，并且只加载相关的模型指南。每个页面都会将观察到的行为与提示词调整、提示词措辞和注意事项联系起来。使用匹配的模式，而不是把整份指南粘贴到提示词中。这些指南涵盖提示词，不涵盖 API 请求设置；行为不会自动迁移到其他模型。

工作流

1. 明确目标、受众、模型、授权、输出和有代表性的失败案例。仅询问会实质影响提示词的缺失信息。
2. 阅读所需的共享参考资料和下方目标模型页面。从此技能目录解析路径。
3. 添加文本前，先移除过时或重复的指导。保留具有约束力的要求。
4. 对于复杂提示词，使用 Role · Goal · Success criteria · Constraints · Tools · Output · Stop rules；省略不会改变行为的部分。
5. 每次只更改一个提示词或配置变量，并比较有代表性的案例。在可用时，衡量任务成功率、输出有效性、工具行为、延迟、令牌数和成本。
6. 提供修订后的提示词、简要的变更摘要，以及验证证据或计划。标明未执行的检查。

共享参考资料

阅读	适用场景
references/core_prompting.md	定义清晰度、上下文、角色、输出、示例或依据
references/advanced_patterns.md	设计 Agent、工具路由、委派、长上下文或交接
references/quality_improvement.md	审查累积的技能／仓库指令，优化、评估、保护或排查提示词

模型指南

目标	阅读	主要区别
GPT-6.1 Sol	references/gpt_6_1_sol.md	支持的 effort 迁移、任务与审批约定、选择性采用 Astra 观察到的模板、工具与对话兼容性
GPT-6.1 Terra	references/gpt_6_1_terra.md	视觉、计算机使用和写作任务约定；从 medium effort 开始（支持 none）；从 GPT-5.6 Terra 进行相同 effort 的迁移；选择性采用 Astra 观察到的模板
GPT-6 Astra、Sol、Luna	references/gpt_6.md	OpenAI 关于审批暂停、技能指令冲突、写作风格、委派和验证的官方模板；Sol/Luna 对 effort 的敏感度
GPT-5.6 Sol、Terra、Luna	references/gpt_5_6.md	精简提示词、简洁的默认设置、高 effort 和专业模式提示词、程序化工具阶段、利于缓存的排序
GPT-5.5	references/gpt_5_5.md	结果优先的基准、检索限制、有依据的草稿、明确验证
Claude Fable 5.1	references/claude_fable_5_1.md	进度可见性、批处理、只追加提醒、在输出额度内完成任务
Claude Fable 5	references/claude_fable_5.md	长任务完成、有依据的进度、按任务划分的独立验证、拒绝处理
Claude Opus 5.5	references/claude_opus_5_5.md	始终启用思考、进度节奏、有界的无人值守续行、粘贴内容边界
Claude Haiku 5.5	references/claude_haiku_5_5.md	effort、按日期引导搜索、JSON 和工具使用、长任务 Agent 完成、验证和拒绝处理
Claude Opus 5	references/claude_opus_5.md	将回复长度与 effort 分开、移除冗余验证、限制委派范围
Claude Opus 4.8	references/claude_opus_4_8.md	可引导的思考、字面范围、工具触发、设计备选方案
Claude Sonnet 5.5	references/claude_sonnet_5_5.md	重新校准 effort、持续推进编码工作、范围限制、静默工具循环、搜索与验证提示词、中途消息放置
Claude Sonnet 5	references/claude_sonnet_5.md	默认启用思考、通过提示词而非采样实现多样性、字面范围与审查回忆

迁移时，如果源模型和目标模型页面均已列出，请同时阅读这两页。编写跨模型提示词时，将通用要求放在主约定中，并仅隔离影响行为的差异。单模型任务无需加载所有页面。

通用规则

• 说明结果和完成标准；将常规路径选择留给模型。
• 提供相关背景，并简要说明重要限制的原因。
• 仅对安全、权限、必填字段和禁止操作等真正不变的要求使用绝对措辞。对于需要判断的事项，使用条件规则。
• 当用户或解析器依赖输出长度、章节、格式和验证时，请明确指定。宿主会强制执行机器输出要求时，使用架构定义。
• 在有帮助时，使用描述性 XML 标签分隔混合的指令、上下文、示例和不可信文档。简单提示词无需标记。
• 仅在示例能改善经测量的行为时保留。确保示例遵守书面约定。
• 对重要主张要求提供证据，允许存在不确定性，并规定缺少证据时的处理方式。
• 要求提供结论、证据、观察到的行为和验证结果。不要要求模型在回复文本中重构私有推理过程。
• 根据模型和任务调整验证与委派。保留必需的检查、实际审批关卡，以及执行框架的并发和执行规则。
• 在提示词中提及工具或能力，并不会让模型获得这些工具或能力。仅针对宿主实际提供的工具编写提示词。

提示工程可以减少错误，但无法彻底消除错误。在优化时，仍须保留安全、业务、证据、权限和下游解析器方面的限制。