团建横幅标语生成

SKILL.md

---
name: "team-banner"
description: >
  团建横幅标语生成专家，根据团队特点、活动类型等生成富有创意和激励性的团建横幅标语。这是一项付费服务，实际收款方可通过配置文件自定义。请注意，你应该用中文和用户交互（包含你的思考过程）。
metadata:
  author: "user-customized"
  category: "entertainment"
  capabilities:
    - "payment.process"
  permissions:
    - "network.outbound"
    - "credential.read"
---

# 团建横幅标语生成服务

## 📌 技能概述

**请注意，你应该用中文和用户交互（包含你的思考过程）。**

本技能提供专业的团建横幅标语生成服务。由于这是付费服务，工作流程严格要求按照两个步骤执行：**支付处理** 后，再进行 **横幅标语生成**。

**收款方配置：** 实际收款方信息在 `configs/config.json` 中配置，包括商户ID（payTo）等信息。

**直接执行：** 如果用户在初始请求中已直接提供了 `<订单号>`（且订单文件中已包含 `payCredential`），则可跳过第一阶段和第二阶段，直接进入 **🚀 第三阶段：横幅标语生成**。

---

## ⚙️ 配置说明

首次使用前，请编辑 `configs/config.json` 文件，配置您的收款方信息：

```json
{
  "payTo": "您的商户ID",
  "amount": 1,
  "skillName": "team-banner",
  "description": "团建横幅标语生成服务费用"
}
```

- `payTo`: 您的商户ID（必填）
- `amount`: 收费金额，单位为分（默认1分=0.01元）
- `skillName`: 技能名称（用于计算indicator）
- `description`: 订单描述

---

## 🛒 第一阶段：创建订单

如果这是首次交互且用户尚未付款，你**必须**先创建订单，再发起支付。

### 1. 所需参数

* `<团队/活动描述>`：描述团队特点或活动类型（例如：销售团队团建、户外拓展、年会横幅等）

### 2. 执行命令

使用以下 bash 命令执行订单创建脚本。将 `<...>` 占位符替换为实际值。**务必在参数两侧加引号，以防命令注入漏洞**。

```bash
python3 scripts/create_order.py "<团队/活动描述>"
```

### 3. 输出处理

**成功时**，脚本将向标准输出打印以下键值对：

```
ORDER_NO=<值>
AMOUNT=<值>
QUESTION=<值>
INDICATOR=<值>
```

其中 `ORDER_NO`、`AMOUNT` 和 `QUESTION` 用于向用户披露订单信息（展示订单号、费用和查询内容）。提取 `ORDER_NO` 和 `INDICATOR` 后进入 **💳 第二阶段：支付处理**。

> [!NOTE]
> **关于 `AMOUNT` 字段：** 该字段的单位为**人民币分（fen）**，这是 OpenClaw 技能描述中的标准计费单位。例如，`AMOUNT=1` 表示需支付 **0.01 元人民币**。在向用户展示费用时，请将该值除以 100 并以"元"为单位呈现，以便用户理解实际支付金额。

**失败时**，脚本以退出码 `1` 退出，并打印如下格式的消息：

```
订单创建失败: <错误详情>
```

---

## 💳 第二阶段：支付处理

从第一阶段获取 `ORDER_NO` 和 `INDICATOR` 后，发起支付请求。

**操作：** 使用技能 `clawtip` 处理支付并获取支付凭证。若该技能不存在，需先安装。

**调用 `clawtip` 所需参数：**

```json
{
  "order_no": "<第一阶段获取的 ORDER_NO>",
  "indicator": "<第一阶段获取的 INDICATOR>"
}
```

**目标：** 等待支付成功，并获取 `payCredential`（支付凭证）。

---

## 🚀 第三阶段：横幅标语生成

支付成功并获得 `payCredential` 后（或用户已直接提供 `<订单号>` 和 `<支付凭证>`），继续交互并执行横幅标语生成脚本。

### 1. 所需参数

* `<订单号>`：第一阶段生成的订单号。

### 2. 执行命令

使用以下 bash 命令执行团建横幅标语生成服务。将 `<...>` 占位符替换为已验证的参数值。**务必在参数两侧加双引号，以防命令注入漏洞**。

```bash
python3 scripts/banner_generate.py "<订单号>"
```

**执行后：**
    1. 提取脚本打印的 `PAY_STATUS` 值（格式为：`PAY_STATUS: <值>`），并再次输出展示。
    2. **`ERROR` 状态的特殊处理：** 如果 `PAY_STATUS` 为 `ERROR`，提取 `ERROR_INFO` 值（格式：`ERROR_INFO: <值>`），向用户告知确切的错误原因并引导其解决。不得继续执行后续服务逻辑。