关于 prompt-enhance
用于改写编码或知识 Agent 提示词的 skill,会检查目标、范围、输出格式和成功标准等缺口,并返回可执行版本。它不进行访谈,而是在安全时采用合理假设,无法判断时标注待补信息。
主要功能
- 01梳理目标、范围与约束
- 02检查矛盾和缺失信息
- 03补充输出格式与成功标准
- 04生成精炼的可执行提示词
适用场景
- 01改进含糊的编码任务描述
- 02整理涉及代码库文件的 Agent 指令
- 03在信息不足时标出假设与待补项
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ owainlewis/ agent-skills --skill prompt-enhance安装后在 Claude Code 中输入/prompt-enhance确认已加载。
详细介绍
提示词增强
返回一条经过完善、可供编码或知识 Agent 执行的提示词。
不要进行访谈。
信息缺失时,使用合理假设或 [NEEDS: ...]。
工作流程
- 阅读输入和引用的上下文:仓库、文件、
AGENTS.md、CLAUDE.md、README.md以及相关代码。 - 解决明确无歧义的指代,例如“那个东西”或“那个脚本”。
- 识别缺陷:目标模糊、意图不明确、要求矛盾、范围缺失、输出格式缺失、成功标准缺失、负面表述、过早停止的脚手架内容、无关信息。
- 重写提示词。保留原意。删除冗余内容。保留实质要求。
- 返回完善后的提示词,然后按需提供
Changed、Assumptions和Gaps行。 - 提供一项操作:立即执行、保存到
prompts/<slug>.md,或停止。
原则
- 用一句话开门见山地说明目标。
- 直接说明输出、格式、约束和范围。
- 解决矛盾,或说明优先级。
- 明确说明工作范围和范围之外的内容。
- 仅在顺序重要时使用编号步骤。
- 优先使用肯定式指令。
- 仅包含会影响工作的上下文。
- 明确输出约定:格式、结构、长度、路径、命名和覆盖行为。
- 说明成功标准:测试、文件、观察到的行为或其他证明。
- 除非确实受阻,否则应基于合理假设继续执行。
- 仅在角色会影响语气或判断时指定角色。
- 当指令、上下文、示例和粘贴的输入可能混淆时,应将它们分开。
- 仅在需要明确格式或风格时提供示例。
缺失信息
- 安全时使用合理默认值,并在
Assumptions下记录。 - 不存在安全默认值时,使用
[NEEDS: <missing detail>]。 - 不要提问。访谈时使用
clarify。
输出
Refined prompt:
<rewritten, self-contained prompt that reads cold>
---
Changed: <substantive improvements>
Assumptions: <defaults baked in, omit if none>
Gaps: <remaining [NEEDS: ...] items, omit if none>
然后提供以下选项:立即执行、保存到 prompts/<slug>.md,或停止。
示例
输入:
用脚本下载播客 MP3 并转录,使用 Whisper,别弄得太慢,把缓存放在合适的地方
输出:
Refined prompt:
Build a Python CLI script that downloads podcast episodes from an RSS feed and transcribes each MP3 with OpenAI Whisper.
Input: RSS feed URL as a required argument.
Output: save each MP3 and transcript (`.txt`, same basename) under `data/<podcast-slug>/`.
Caching: skip any episode whose MP3 and transcript already exist.
Performance: download and transcribe episodes concurrently.
Failure: exit non-zero for a bad feed URL; skip and log individual episode failures.
Success: running twice performs no redundant downloads or transcriptions.
Out of scope: UI, speaker diarization, non-MP3 formats.
---
Changed: added input, output, caching, concurrency, failure handling, and success criteria.
Assumptions: RSS feed input; local `data/` output.
评论
支持 Markdown