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_v1.0.md。
自检清单
输出前必须检查并修正:
- MECE:指令是否互斥且覆盖主路径、边界和失败情况。
- 冲突:目标、约束、输出格式、优先级是否互相矛盾。
- 冗余:是否用不同说法重复同一条规则。
- 歧义:术语、输入范围、成功标准是否可执行。
- 范围膨胀:是否因为小需求添加了不必要实体、模块或流程。
- 示例质量:示例是否提炼方法,而不是给提示词打补丁。
- 注释污染:是否出现括号式补丁说明或营销式强调词。
- 可维护性:未来改一个规则时,是否能只改一个段落。
输出契约
默认输出单一 Markdown 提示词:
// {
// Author: <PROMPT_AUTHOR>
// Model: <用户提供的模型列表>
// Update: Initial version: <任务目标摘要>
// Version: v1.0
// }
# <标题>
## 任务
<可执行、可衡量的目标>
## 背景
<仅保留完成任务必需的信息>
## 输入
<输入格式、字段、来源或占位符>
## 输出
<输出格式、结构、长度、顺序>
## 约束
<必须、禁止、边界、优先级>
## 成功标准
<自检项或验收条件>
若生成执行型提示词,步骤必须确定、少分支。若生成判断型提示词,必须写清判断标准和输出哪些理由摘要,但不要要求输出完整思考过程。
Update 必须说明本版本为什么创建。若用户没有提供更新内容,默认写成 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