xmtp-agents

使用 Agent SDK 构建和扩展 XMTP 代理。 在以下情况下使用：(1) 创建或配置 XMTP 代理，(2) 实施代理功能（命令、附件、反应、组、事务、内联操作或域解析）。

# XMTP agents

Build event-driven messaging agents on the XMTP network. This skill is the entry point; use the sub-skills below for specific features.

## When to apply

- Starting or configuring a new XMTP agent
- Adding behavior: commands, attachments, reactions, groups, payments, inline actions, or address/domain resolution

## Sub-skills

| Sub-skill | Use when |
|-----------|----------|
| **building-agents** | Setup, env vars, text/lifecycle events, middleware |
| **handling-commands** | Slash commands, validators, message filters, type guards |
| **handling-attachments** | Send/receive files, remote attachments, upload storage |
| **sending-reactions** | Send or receive reactions, thinking/reply patterns |
| **managing-groups** | Create groups, add members, roles, welcome-on-install |
| **handling-transactions** | USDC transfers, balance checks, transaction references |
| **creating-inline-actions** | Inline actions, confirmation/selection helpers, config menus |
| **resolving-domains** | Resolve addresses, Farcaster profiles, extract mentions |

## How to use

1. Pick the sub-skill that matches the task (e.g. slash commands → `handling-commands`).
2. Read that sub-skill’s `SKILL.md` and its `rules/` for step-by-step guidance.
3. For SDK or API details, use the xmtp-docs skill (index + specific page fetch).

## Quick start

Install the Agent SDK, create an agent from env, handle text, then start:

```bash
npm install @xmtp/agent-sdk
```

Create the agent and handle messages using patterns from **building-agents** (setup, events, middleware). For commands, attachments, reactions, groups, transactions, inline actions, or resolution, use the corresponding sub-skill above.

---

## 中文说明

# XMTP agents

在 XMTP 网络上构建事件驱动的消息代理。本技能是入口点；针对具体功能请使用下面的子技能。

## 何时使用

- 启动或配置一个新的 XMTP 代理
- 添加行为：命令、附件、反应、群组、支付、内联操作，或地址/域名解析

## 子技能

| 子技能 | 使用场景 |
|-----------|----------|
| **building-agents** | 设置、环境变量、文本/生命周期事件、中间件 |
| **handling-commands** | 斜杠命令、验证器、消息过滤器、类型守卫 |
| **handling-attachments** | 发送/接收文件、远程附件、上传存储 |
| **sending-reactions** | 发送或接收反应、思考/回复模式 |
| **managing-groups** | 创建群组、添加成员、角色、安装时欢迎 |
| **handling-transactions** | USDC 转账、余额检查、交易引用 |
| **creating-inline-actions** | 内联操作、确认/选择助手、配置菜单 |
| **resolving-domains** | 解析地址、Farcaster 资料、提取提及 |

## 如何使用

1. 选择与任务匹配的子技能（例如斜杠命令 → `handling-commands`）。
2. 阅读该子技能的 `SKILL.md` 及其 `rules/` 以获取分步指导。
3. 关于 SDK 或 API 细节，使用 xmtp-docs 技能（索引 + 具体页面抓取）。

## 快速开始

安装 Agent SDK，从环境变量创建代理，处理文本，然后启动：

```bash
npm install @xmtp/agent-sdk
```

使用 **building-agents** 中的模式（设置、事件、中间件）创建代理并处理消息。对于命令、附件、反应、群组、交易、内联操作或解析，使用上面对应的子技能。