# Postmark 邮件技能集

`邮件发送` `AI编程助手` `Postmark` `邮件模板` `Webhook`

# Postmark Skills

[Agent Skills](https://github.com/anthropics/skills)，适用于 [Postmark](https://postmarkapp.com) 邮件平台。教 AI 编程助手如何使用 Postmark API 发送事务性邮件、处理入站消息、管理模板及配置 Webhook。

## 可用技能

| 技能 | 描述 |
|-------|-------------|
| [`postmark-send-email`](./postmark-send-email/) | 通过 Postmark API 发送邮件——支持单封、批量、大批量及模板发送，兼容事务性和广播消息流。 |
| [`postmark-inbound`](./postmark-inbound/) | 通过 Postmark 入站 Webhook 处理收到的邮件，构建邮件回复、邮件转工单、文档提取等工作流。 |
| [`postmark-templates`](./postmark-templates/) | 使用 Handlebars 语法创建和管理服务端邮件模板，支持布局继承、模板验证及跨服务器推送。 |
| [`postmark-webhooks`](./postmark-webhooks/) | 配置投递、退信、打开、点击、垃圾投诉及订阅变更等事件的 Webhook。 |
| [`postmark-email-best-practices`](./postmark-email-best-practices/) | 涵盖送达率优化、合规要求（CAN-SPAM、GDPR、CASL）、事务性邮件设计、列表管理、安全测试及发送可靠性。 |

## 安装

```bash
npx skills add ActiveCampaign/postmark-skills
```

安装指定技能：

```bash
npx skills add ActiveCampaign/postmark-skills --skill postmark-send-email
```

## 使用方法

安装后，AI 编程助手会在相关场景中自动调用这些技能。示例提示语：

- "用 Postmark 发送一封欢迎邮件"
- "为支持工单系统搭建入站邮件处理流程"
- "创建一个订单确认邮件的 Postmark 模板"
- "添加退信和投递 Webhook 以跟踪邮件状态"
- "通过 Postmark 批量发送 200 封通知邮件"
- "如何为 Postmark 配置 SPF、DKIM 和 DMARC？"
- "CAN-SPAM 和 GDPR 对我的邮件列表有哪些要求？"
- "帮我设计一封密码重置邮件"

## Postmark 官方及社区 SDK

- **Node.js / TypeScript** — [`postmark`](https://www.npmjs.com/package/postmark)
- **Python** — [`postmarker`](https://pypi.org/project/postmarker/)*
- **Ruby** — [`postmark`](https://rubygems.org/gems/postmark)
- **PHP** — [`wildbit/postmark-php`](https://packagist.org/packages/wildbit/postmark-php)
- **.NET** — [`Postmark`](https://www.nuget.org/packages/Postmark)

<small>* 免责声明：第三方 SDK 按"原样"提供，不附带任何形式的保证。Postmark 对其使用所产生的任何损失或问题不承担责任。</small>

## 前置条件

1. 一个 [Postmark 账户](https://account.postmarkapp.com/sign_up)
2. 已验证的发件域名或发件人签名
3. 你的 Server API Token（可在 [Postmark Servers](https://account.postmarkapp.com/servers) 获取）
4. 将 Token 设置为环境变量：`POSTMARK_SERVER_TOKEN`

## 为什么选择 Postmark？

- **消息流** — 将事务性邮件与广播邮件分离，提升送达率
- **每批次 500 封** — 是同类产品的 5 倍
- **批量附件** — 批量发送时支持附加文件
- **服务端模板** — 支持布局继承的 Handlebars 模板，无需客户端渲染
- **完整的入站处理** — 通过 Webhook 解析并路由收到的邮件
- **15 年以上送达率专业经验** — 受到全球 10 万余名开发者信赖

## 许可证

MIT