prompt-craft

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 中用 /模板名 调用

第六步：询问存放位置

问用户：

这个模板你想放在：

1. 当前项目（.pi/prompts/）——只在当前项目可用
2. 全局（~/.pi/agent/prompts/）——所有项目可用

按用户选择写入对应目录。

原则速查

每当你审查提示词时，对照这 9 条：

1. 最新模型——提醒用户使用能力最强的模型
2. 分隔符——指令与上下文用 ### 或 """ 分隔
3. 具体化——上下文、结果、长度、格式、风格都要明确
4. 示例驱动——给出期望的输出格式示例
5. 零样本优先——先不加示例，不够再加
6. 精确描述——数字比模糊词好（"3-5句" > "简短"）
7. 正向引导——说该做什么，不只说不该做什么
8. 引导词——代码生成末尾加 import / SELECT 等
9. 参数合理——事实型用 temperature=0，创意型可提高

交付物

每次输出应包含：

1. 原则对照检查清单（哪些适用、哪些不适用）
2. 改进说明（改了哪几条原则对应的内容）
3. 改进后的提示词正文
4. 询问用户是否需要产出 prompt template 文件
5. 如果用户确认，产出完整的 prompt template（含 frontmatter）并写入对应目录