SuperAPI AI 工具集

enhance-prompt

智能体与模型

查看项目

更新于 10-16 04:04

技能介绍

用途

Enhance Prompt 用于在把提示词发送给 LLM 或编码智能体之前对其进行增强。它拦截用户的原始提示词,注入上下文与引导,并返回可直接执行的版本。该技能强调快速、不臃肿、不生成子智能体——它只是打造一条更好的用户消息。

触发边界:适用于在发送给 LLM 或编码智能体前增强提示词;不适用于改进一般写作(邮件、文章)、构建技能文件或审查代码。

核心理念

该技能不是为文风而改写,而是做三件事:

  • 引导智能体“如何思考”,而不仅仅是“思考什么”
  • 预判智能体会在哪里出错,并提前阻断这些失败
  • 注入停止条件,让智能体知道何时完成

工作流程

第 1 步——阅读与诊断(静默)

阅读提示词,就以下问题形成内部判断(不向用户展示):

  • 叙事弧是什么?好的提示词讲述一个故事:我们在这里 → 问题在这里 → 完成的样子是什么
  • 智能体首先会做什么?开场动作决定一切。如果不清晰,智能体会停滞或跑偏。
  • 它会在哪里卡住?歧义、缺失上下文、范围蔓延、没有退出条件——预判失败模式。
  • 是否与代码相关?如果是,智能体可以看到文件系统、运行命令、读取文件。不要重复它能自行发现的内容。
  • 完成信号是什么?智能体如何知道停止?大多数提示词忘记这一点,导致智能体空转。

第 2 步——通过运行时的 ask-user 工具进行规划(第 1 轮,默认)

默认执行第 1 轮。对于非平凡提示词,一轮简短的前置规划比增强后再改写更便宜地捕捉错位。

派发一次用户提问调用,最多捆绑 4 个问题,覆盖最可能改变增强方向的轴。工具名称取决于运行时:

  • claude-code / kimi-cli → AskUserQuestion
  • codex / qwen-code / mistral-vibe → ask_user_question
  • gemini-cli / deepagents / github-copilot / pi → ask_user
  • cline / roo → ask_followup_question
  • cursor / continue → AskQuestion
  • droid → AskUser
  • antigravity → suggested_responses
  • opencode → question
  • 未知运行时 → 散文回退(相同选项,以 markdown 呈现)

每个问题:2-4 个选项,除非 multiSelect: true 明显正确否则互斥;第一个选项标记为“(Recommended)”,基于第 1 步诊断而非静态默认;短标签(1-5 个词),一行描述;不要手动添加“Other”——Claude Code 会自动提供,大多数其他运行时会模仿此约定。

仅在以下情况跳过第 1 轮:提示词是一行外科手术式编辑且意图明确(“修复 README 第 12 行的拼写错误”);用户明确说“只增强,不要问”;第 1 步诊断显示提示词已经很好 → 走轻触路径并附一行说明。

第 2a 步——第 2 轮(条件性,更窄)

第 1 轮答案返回后评估:答案是否暴露了第 1 轮无法预料的新歧义?

仅在以下情况触发第 2 轮:某个答案将增强引向第 1 轮未覆盖的轴;用户选择“Other”并输入了引入新轴的文本。

以下情况跳过第 2 轮:第 1 轮已理清全貌 → 直接进入第 3 步;你想用第 2 轮“复核”第 1 轮答案 → 不,直接继续。

第 2 轮是对运行时 ask-user 工具的一次调用,1-3 个聚焦问题。两轮总问题预算:≤ 7。如果超出预算,做出合理默认并附说明继续。

第 3 步——增强

对提示词应用以下层:

  • 第 1 层:叙事结构——给提示词一个开头-中间-结尾。智能体需要知道:我们在哪里、问题是什么、成功的样子是什么。
  • 第 2 层:思考引导——不仅说做什么,还说如何着手:“在触碰 Y 之前先理解 X”“先检查 Z 是否存在——如果不存在,方法就变了”“把这个问题当作 [框架] 问题来思考,而不是 [错误框架] 问题”。
  • 第 3 层:失败预防——阻断智能体最可能出错的 2-3 种方式:“不要重构周边代码——只碰被要求的部分”“如果测试套件还不存在,说出来而不是创建一个”“范围:仅此文件,不是整个模块”。
  • 第 4 层:上下文注入(代码感知)——如果提示词针对编码智能体,不要解释智能体能看到的。而是:如果用户提到具体文件/路径就点名;如果从上下文明显就提及可能的技术栈;假设智能体能 tree、cat、grep、git log——不要重复该能力。
  • 第 5 层:验证与停止——每条增强后的提示词必须以验证步骤(“实现后运行 X 确认其工作”)、完成信号(“当 [具体可观察条件] 时你就完成了”)、停止条件(“如果遇到 [阻碍],停下来询问而不是猜测”)结尾。

第 4 步——展示并提供深化

在代码块中展示增强后的提示词。下方用一行解释关键改进。然后始终以如下内容结尾:

Want me to dig deeper? I can add more context, tighten the scope, or research the topic first.

如果用户说“run it”——直接执行增强后的提示词。完全重置框架。

力度校准

  • 输入已经很好(意图清晰、具体、有约束):轻触——仅添加停止条件 + 验证。说“This is solid — I just added a done signal.”
  • 意图尚可,细节模糊:中等——添加叙事弧 + 失败预防 + 停止。
  • 原始想法或意识流:完全重构——全部 5 层。展示转变。

决策规则

  • 如果提示词已经很好:说出来,仅添加停止条件,提供按原样运行的选项
  • 如果提示词针对编码智能体:假设有文件系统访问,跳过解释它已有的工具
  • 如果提示词提到特定技术:除非准确性关键(如 API 版本),否则不要研究它。执行工作的智能体可以自行查阅
  • 如果提示词是系统/智能体提示词(定义行为而非请求任务):保留“You are...”框架,添加边缘情况处理和升级标准
  • 永远不要为完整性添加填充技巧——每个添加都必须修复特定的失败模式

不应做的事

  • 除非用户要求,否则不要五样本示例
  • 不要“智能体自己写提示词”的元提示
  • 不要 26 条原则堆砌或学术提示工程
  • 永远不超过 2 轮 ask-user——且每轮不超过 4 个问题(Claude Code 上限;保持可移植)
  • 不要对外科手术式单行提示词强制第 1 轮——第 1 步诊断明确时跳过
  • 不要“Option A / B / C”填充标签——每个选项必须是用户可比较的有意义选择
  • 不要手动添加“Other”选项——Claude Code 会自动提供,大多数运行时会模仿
  • 不要改写用户的声音——增强内容,保留语气
  • 不要生成子智能体——此技能增强用户消息,仅此而已

参考路由

  • references/ask-user-tools.md:派发规划轮时——为当前运行时在 16 个映射智能体中选择正确工具名,无结构化工具时提供散文回退
  • references/planning-questions.md:运行第 2 步(第 1 轮)时——规范轴库、选择“(Recommended)”选项、交换规则、示例
  • references/enhancement-layers.md:应用 5 个增强层时——每层的详细指导
  • references/code-prompt-patterns.md:提示词针对编码智能体时——文件路径、验证、技术栈感知
  • references/failure-modes.md:预测和预防常见智能体失败模式时

适用场景与限制

适用场景:在把提示词发送给 LLM 或编码智能体之前增强提示词。

限制:不适用于改进一般写作(邮件、文章)、构建技能文件或审查代码。该技能不生成子智能体,仅增强用户消息。关于收费、价格、平台等信息,资料中暂未提供。