Prompty — One Prompt File for VS Code/Python/TS

简介

Prompty 是基于 Markdown 的 .prompty 提示词格式：同一份文件可在 VS Code、Python、TypeScript 中运行，模板与 provider 配置一致。

• 适合谁： 需要跨 IDE 与运行时统一提示词、并希望配置与模板可复现的团队
• 可搭配： VS Code 插件、Python 包、TypeScript 包，支持 OpenAI/Anthropic/Foundry 等 provider
• 准备时间： 10–25 分钟

实战建议

• 量化建议：把 .prompty 纳入 git，并对变更走 PR 评审。
• 数据点：.prompty 把 model/provider 配置与模板放在同一文件里。

常用打法：把提示词当“接口契约”管理

用 .prompty 把提示词变成可协作的契约：

• 明确输入变量，
• 固化 provider + model 设置，
• 正文保持可读的 Markdown。

常用打法：同一份提示词跑三处

1）VS Code 里写与预览； 2）Python 里做批处理/评测； 3）TypeScript 里跑在线服务。

这样可以减少“不同运行时各写一份模板”的漂移。

FAQ

Prompty 稳定吗？ 答：仓库标注 v2 alpha，API/格式可能变化。

不装 VS Code 也能用吗？ 答：可以，Python/TypeScript 运行时都能执行 .prompty。

密钥怎么管理？ 答：用环境变量引用（如 ${env:OPENAI_API_KEY}），不要写进仓库。