poml

像写代码一样编排提示词,告别混乱,提升 AI 应用开发效率。

poml 是一种提示词编排标记语言,旨在解决复杂 AI 提示词难以管理和复用的问题。它通过结构化的标记语法,将提示词拆分为可组合的模块,支持变量、条件逻辑和模板继承,让开发者能够像写代码一样编写、测试和版本控制提示词。poml 提供 CLI 工具和 TypeScript SDK,可无缝集成到现有开发流程中,支持从本地文件或远程仓库加载提示词,并自动生成针对不同 LLM 的格式化输出。其核心能力包括:模块化提示词设计、动态内容注入、多模型适配和提示词版本管理,显著提升提示词的可维护性和协作效率。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 4966
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类开源模型
开发团队microsoft
所属国家
定价模式free
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型llm,markup-language,prompt,vscode-extension
GitHub 星标★ 4966
30天Star增速
HF 下载量
上线时间2024-11-29 00:00:00
最近更新2026-09-22 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Node.js 与 npm(POML 为 TypeScript 项目,官方提供 CLI 与 SDK)
  • 可访问 GitHub 与 npm 的网络环境
  • 准备一张示例图片 photosynthesis_diagram.png

安装与启动步骤

  1. 1准备运行环境

    POML 由 TypeScript 开发,官方提供 CLI 工具和 SDK,使用前请在本机安装 Node.js 与 npm,版本要求见仓库文档。

  2. 2获取项目源码

    从 GitHub 克隆仓库到本地,后续可查看仓库 README 的 Installation 章节获取真实安装命令。

    git clone https://github.com/microsoft/poml.git
    cd poml
  3. 3创建示例提示词

    README 要求把示例内容保存为 example.poml,文件中包含 role、task、output-format 三个语义组件。

    cat > example.poml << 'EOF'
    
      You are a patient teacher explaining concepts to a 10-year-old.
      Explain the concept of photosynthesis using the provided image as a reference.
      
        Keep the explanation simple, engaging, and under 100 words.
        Start with "Hey there, future scientist!".
      
    
    EOF
  4. 4放置配套图片

    示例引用了图片作为上下文,请确保 photosynthesis_diagram.png 与 example.poml 位于同一目录。

  5. 5渲染并测试提示词

    README 提到提示词可用灵活格式渲染并交给视觉模型测试,但节选中未给出具体命令,请以仓库文档为准。

如何确认成功

README 节选未给出安装命令,暂无法确认启动成功;文件保存成功后内容应包含 role、task、output-format 三个标签。

常见问题

Q:安装命令是什么?

A:本次 README 节选的 Installation 章节没有正文内容,请打开 GitHub 仓库页面查看该章节,按其中给出命令安装 CLI 或 TypeScript SDK。

Q:为什么示例需要一张图片?

A:示例让模型参考图片解释光合作用,因此 photosynthesis_diagram.png 必须与 example.poml 放在同一目录,否则引用会失效。

Q:支持哪些大模型?

A:README 说明 POML 可生成针对不同 LLM 的格式化输出,并可用视觉模型测试示例,具体适配清单请查阅官方文档。

注意事项

  • README 节选缺少 Installation 具体命令,安装步骤请以仓库最新文档为准,不要照搬本教程推测内容。
  • 示例文件必须与 photosynthesis_diagram.png 同目录,否则图片引用无效。

核心亮点

  • 结构化语法支持模块复用和条件逻辑,大幅减少重复提示词
  • 内置多模型适配层,一套提示词可输出到 OpenAI、Claude 等
  • CLI 与 SDK 双形态,方便集成到 CI/CD 和现有 TypeScript 项目

不足之处

  • 生态较新,社区模板和最佳实践积累有限
  • 文档/社区待观察

适用场景

  • 复杂 AI 应用的提示词工程管理
  • 团队协作开发提示词,需要版本控制和代码审查
  • 跨多个 LLM 提供商部署统一提示词逻辑

替代项目

LangChain、Promptify、Guidance

项目介绍

poml 是开发框架领域的开源项目,由 microsoft 开发,2024 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(4,966)位列前 9%,在开发框架分类的 803 个项目里位列前 10%。

近 41 天,它的 GitHub 星标从 4,943 增加到 4,966,净增 23。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-22。MIT许可证,完全免费,无付费版本。

它主要面向的使用场景是:复杂AI应用的提示词工程管理。同类可对比的替代方案包括 LangChain、Promptify、Guidance。

上一篇:AgentVerse

下一篇:lollms-webui

同类项目推荐

langchain 开源

组装 AI 应用的乐高积木,从想法到上线不换工具

The agent engineering platform.

★ 146874 2026-08-09
transformers 开源

全球最大的模型仓库全家桶,想用的模型一把抓

Transformers: the model-definition framework for state-of-the-art machine learning m···

★ 166529 2026-08-09
pi 开源

一套 TypeScript 工具包,快速搭出能写代码的 AI agent

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

★ 108504 2026-09-12