| name | prompt-craft |
| description | 根据 OpenAI 提示词工程最佳实践，帮用户创建和改进 pi 的 prompt template（/命令）。当用户想要「写一个提示词」「改进提示词」「做提示词工程」「创建 prompt template」「写一个 / 命令」，或提到提示词效果不好需要优化时，务必使用此技能。也适用于用户问「怎么让模型输出更好」这类问题。 |
Prompt Craft
基于 OpenAI 的 9 条提示词工程最佳实践，帮用户创建或改进 pi agent 的 prompt template。
工作流程
第一步：了解需求
向用户了解：
- 这个 prompt template 要完成什么任务？
- 期望的输出格式和风格？
- 有没有已知的边界情况或容易出错的点？
- 是一次性使用还是反复调用的模板？
如果用户在改造已有提示词，先让它把原文贴出来。
第二步：对照原则审视
读取 references/principles.md，对照 9 条原则逐一检查用户的提示词（或需求），列出发现的问题和改进建议。不是每条原则都适用——只提相关的。
第三步：生成改进版
为每条适用的原则，对提示词做针对性改进。在给用户的回复中，逐条说明改了什么、为什么改，然后给出完整的新版本。
第四步：输出改进后的提示词
将改进后的提示词正文展示给用户，并简要说明每条改进对应的原则。
然后询问用户是否要产出 pi prompt template 文件。如果用户说「是」「要」「保存」「产出」，进入第五步。如果用户说「不用」「就这样」，到此结束。
第五步：输出为 pi prompt template 文件
将最终版本格式化为 pi prompt template。详细格式参考 references/pi-prompt-template.md。
关键要点：
description 要简洁，一句话说清模板做什么- 如果模板需要参数，用
argument-hint 说明，<必选> 用尖括号，[可选] 用方括号
- 提示词正文中用
$1、$2 表示用户输入的参数
- 文件保存为
模板名.md，在 pi 中用 /模板名 调用
第六步：询问存放位置
问用户：
这个模板你想放在：
- 当前项目（
.pi/prompts/）——只在当前项目可用
- 全局（
~/.pi/agent/prompts/）——所有项目可用
按用户选择写入对应目录。
原则速查
每当你审查提示词时，对照这 9 条：
- 最新模型——提醒用户使用能力最强的模型
- 分隔符——指令与上下文用
### 或 """ 分隔
- 具体化——上下文、结果、长度、格式、风格都要明确
- 示例驱动——给出期望的输出格式示例
- 零样本优先——先不加示例，不够再加
- 精确描述——数字比模糊词好（"3-5句" > "简短"）
- 正向引导——说该做什么，不只说不该做什么
- 引导词——代码生成末尾加
import / SELECT 等
- 参数合理——事实型用
temperature=0，创意型可提高
交付物
每次输出应包含：
- 原则对照检查清单（哪些适用、哪些不适用）
- 改进说明（改了哪几条原则对应的内容）
- 改进后的提示词正文
- 询问用户是否需要产出 prompt template 文件
- 如果用户确认，产出完整的 prompt template（含 frontmatter）并写入对应目录
