Prompt Creator
可配置项
作者、模型、更新说明和版本号都是可选顶部信息。用户未提供、当前提示词也没有时,省略对应字段,不写空值、占位符或猜测值;全部缺省时,整个头部省略。
先给可直接使用的完整提示词,再在代码块外简短询问是否需要补充顶部信息;已提供或已明确不需要时不重复询问。顶部信息不影响正文交付,不作为开始修改或保存的前置条件。
保存仅在用户要求或已有保存授权时执行;未指定保存位置时可使用下方默认目录,不为可选配置阻塞正文交付。已有作者设置可沿用。
| 配置 | 默认值 | 用途 |
| --- | --- | --- |
| PROMPT_AUTHOR | 不填则省略 | 可选头部的 Author 字段 |
| PROMPT_SAVE_ROOT | ~/Documents/prompts | 提示词文件保存根目录 |
质量内核
提示词是给模型执行的代码。目标是让接口清晰、依赖最少、职责单一、没有隐藏分支。
默认不要引入框架名、重度增强模板、技巧堆叠或特殊模块。只有当添加结构能减少复杂度、减少歧义或提高复用性时才加入。
按任务需要选择步骤和判断标准,不把“是否开启深度思考”作为前置问题。模型信息未知时先写通用可执行版本;用户明确提供模型能力或任务确有依赖时,再针对性调整。需要判断、比较或取舍时写清标准,只要求结论、理由摘要和可验证结果,不要求输出完整思考过程。
接口字段
按需使用这些字段;空字段省略,不用占位。
| 字段 | 作用 | 代码类比 | | --- | --- | --- | | Task | 要完成的目标 | function name | | Context | 必要背景和依赖 | closure vars | | Input | 用户会提供什么 | params | | Output | 必须返回什么 | return type | | Constraints | 必须、禁止、边界 | type constraints | | Success | 合格标准 | tests |
角色、语气、步骤、示例只在必要时添加。角色不能替代任务;语气不能替代输出要求;示例不能替代规则。
工作流
- 根据用户目标确定需要的输入、输出、步骤和判断标准,不为可选模型信息暂停。
- 收集最少必要字段。缺少关键信息才提问;不影响初版质量的偏好先用保守默认。
- 写提示词骨架,先保证主路径可执行,再补边界和失败处理。
- 加示例时只加能抽象方法的示例:它必须说明格式、边界或风格中的至少一项。
- 自检后先输出干净版完整提示词,再按需询问是否补充顶部信息;只有用户要求解释时,额外给说明版。
- 用户要求保存时再写文件;已有保存授权直接执行。未指定文件名时使用
${PROMPT_SAVE_ROOT}/<task-slug>/prompt.md,不要为了文件名强加版本头部。
自检清单
输出前必须检查并修正:
- MECE:指令是否互斥且覆盖主路径、边界和失败情况。
- 冲突:目标、约束、输出格式、优先级是否互相矛盾。
- 冗余:是否用不同说法重复同一条规则。
- 歧义:术语、输入范围、成功标准是否可执行。
- 范围膨胀:是否因为小需求添加了不必要实体、模块或流程。
- 示例质量:示例是否提炼方法,而不是给提示词打补丁。
- 注释污染:是否出现括号式补丁说明或营销式强调词。
- 可维护性:未来改一个规则时,是否能只改一个段落。
输出契约
默认用单一代码块输出完整 Markdown 提示词;以下正文结构按需取用,空章节省略:
# <标题>
## 任务
<可执行、可衡量的目标>
## 背景
<仅保留完成任务必需的信息>
## 输入
<输入格式、字段、来源或占位符>
## 输出
<输出格式、结构、长度、顺序>
## 约束
<必须、禁止、边界、优先级>
## 成功标准
<自检项或验收条件>
若生成执行型提示词,步骤必须确定、少分支。若生成判断型提示词,必须写清判断标准和输出哪些理由摘要,但不要要求输出完整思考过程。
需要顶部信息时,只添加已提供的字段;用户授权补写时再生成更新说明或版本号,不默认添加 Initial version。
可选 Git 管理
保存提示词文件后,可以提示用户是否需要 Git 记录;Git 不是默认流程,也不是强制项。
- 只有用户明确要求 Git 记录时,才执行 Git 命令。
- 先运行
git status确认改动范围。 - 若用户确认提交,使用
git add <具体文件>;不要默认使用git add .。 - Commit message 建议:
prompt(<task-slug>): v<version> - <update summary>。 - Push 不是默认步骤;只有用户明确要求 push 时才执行,并先说明目标 remote 和 branch。
配套 Skill
当提示词需要局部修订、诊断或版本回滚时,使用 prompt-optimizer。
安装:
claude skill add https://github.com/WiseWong6/wise-skills/tree/master/prompt-optimizer