SuperAPI AI 工具集

system-prompt

智能体与模型

查看项目

更新于 11-03 16:18

技能介绍

这是一个面向系统提示词工程(System Prompt Engineering)的技能文档,用于在编写、审查或改进 AI 工具、智能体、聊天机器人及 LLM 产品的系统提示词时提供结构化方法。其核心理念是:结构胜于技巧,具体示例胜于抽象指令;系统提示词被视为与模型之间的契约,每一行都应经得起测试,无法测试的内容应删去。

【用途与原则】 文档面向系统提示词的撰写与评审,强调模型对靠前的内容权重更高,因此给出了通用的分节顺序:身份与角色、任务/停止条件、沟通风格、核心工作流、工具使用规则、领域特定规则、安全与约束、边界情况与错误处理、示例、运行时上下文。

【使用方式(四步流程)】

  1. 收集需求:先确认 AI 的职责、用户是谁、具备哪些工具与能力、完成标准、绝不可发生的事项、期望的输出格式;如已有提示词,先阅读再提修改建议。
  2. 逐节撰写:按分节指南编写,不适用的章节可跳过。
  3. 添加示例:文档称这是投入产出比最高的步骤,建议增加 3 至 10 个具体示例,覆盖回复长度与语气、工具调用决策、边界情况与错误处理、以及反面到正面的对照示例。
  4. 按清单审查:交付前用文末质量清单逐项核对。

【分节要点】

  • 身份与角色:以“You are...”开头,写明具体角色、能力层级与协作关系,控制在 1 至 5 行。
  • 任务/停止条件:明确完成标准,倾向于行动而非反复确认。
  • 沟通风格:明确限制回复长度(用数字而非形容词),禁止填充语、前后缀和不必要的表情符号,代码引用使用反引号。
  • 核心工作流:定义阶段与阶段门槛,采用“阅读—计划—执行—验证”的模式,并包含验证步骤。
  • 工具使用规则:要求独立调用尽量并行、优先使用专用工具而非 shell 命令、编辑前必须先读取文件、设置重试上限(通常 3 次)、不要向用户提及工具名称。
  • 领域规则:将代码风格、命名约定等单独成节,用具体的反例与正例说明。
  • 安全与约束:使用 CRITICAL、IMPORTANT、NEVER、ALWAYS 等严重性关键词分级,约束安全、破坏性操作、范围蔓延与随意假设;关键约束可重复,但避免过度约束。
  • 边界情况与错误处理:用具体场景而非嵌套条件描述失败后的处理步骤。
  • 示例:用 XML 标签组织少样本示例,并包含 bad-example 对照。
  • 运行时上下文:为动态注入内容(工作目录、当前文件、git 分支、用户偏好等)保留占位符章节。

【高级技巧与反模式】 文档还介绍了行动前思考触发器(在改写历史、删除文件、从阅读转为写入等高危操作前强制推理)、讨论优先与行动优先模式的切换标准、多步骤任务的状态更新协议;并列出应标记的反模式:能力清单堆砌、“乐于助人且友好”等默认行为描述、营销语言、防御性免责声明、稀有情况的嵌套条件、模糊的人格指令、缺少示例、顺序工具指令等。

【质量检查清单】 交付前核对:清晰的身份、明确的完成标准、具体数字的长度上限、并行工具调用要求、先读后改规则、工具优先级、重试上限、安全相关的 NEVER/ALWAYS、3 至 10 个含反例的少样本示例、带阶段门槛的工作流、上下文效率规则、领域规则示例、错误升级路径、动态运行时上下文;同时删除能力列表、通用人格指令、营销文案、防御性免责声明及针对默认行为的规则。

【适用场景与限制】 适用于为 AI 工具、智能体、聊天机器人和 LLM 产品设计、评审与改进系统提示词。文档为方法论指导,未提供具体产品、收费、平台或量化效果信息,这些内容暂未提供。