donate

intent

identify when a user wants to make a donation (tip, reward, gift), collect the donation amount from them, validate it against business rules, get explicit confirmation, then invoke the payment skill to process the transaction. use this skill when a user says things like "tip", "reward 50 yuan", "send a gift", or "support the streamer". do not trigger on generic payment language like "pay", "checkout", or "billing" that lacks donation intent.

inputs

parameters to collect:

• amount (number, required): donation amount in yuan. extracted from user message or collected via follow-up if missing.

external connections:

• payment skill (downstream dependency): expects to receive amount, order_type: "tip", and description fields. requires payment skill to be available and returning tradeCode and tradeLink in response.

context:

• user message text to parse for donation intent triggers and amount extraction.
• no payment credentials needed (delegated to payment skill).

procedure

1. parse user message for donation intent and amount

   • input: user message containing keywords like "打赏", "赞赏", "赏 XX 元", "刷礼物", "送礼物", "给主播打赏"
   • output: amount extracted (or null if missing)

2. collect missing amount parameter

   • input: if amount is null or empty
   • output: send prompt "您想打赏多少呢？" (how much would you like to donate?) and await user response
   • re-parse user's follow-up message to extract amount

3. validate amount

   • input: extracted or user-provided amount
   • output: if validation fails, send error prompt and loop back to step 2
   • validation rules: amount must be > 0 and <= 10000

4. request user confirmation

   • input: validated amount
   • output: send prompt "确认打赏 {amount} 元吗？（是/否）" (confirm donating {amount} yuan? yes/no) and await response

5. handle confirmation response

   • input: user's yes/no response to confirmation
   • output: proceed to step 6 if affirmative; end with cancellation message if negative (see decision points)

6. invoke payment skill

   • input: amount, order_type: "tip", description: "打赏 {amount} 元"
   • output: receive response containing tradeCode and tradeLink from payment skill
   • send transient message "正在为您创建打赏订单..." (creating your donation order) before calling

7. display payment result

   • input: tradeCode and tradeLink from payment skill response
   • output: formatted success message with emoji, trade code, payment link, and gratitude text

decision points

if amount is missing from user message: send follow-up prompt "您想打赏多少呢？" and re-parse the next user input.

if amount is <= 0 or > 10000: send error "打赏金额需要大于 0 且不超过 10000 元，请重新输入。" (donation amount must be > 0 and <= 10000 yuan) and loop back to step 2 to collect a new amount.

if user confirms with affirmative response (是, 好, 确认, 同意, etc.): proceed to invoke payment skill.

if user confirms with negative response (否, 不, 算了, 取消, 不打了, etc.): send cancellation message "好的，已取消本次打赏。期待您下次的支持～" (got it, donation cancelled. we look forward to your support next time) and end the skill without invoking payment.

if payment skill returns an error or timeout: surface the error to the user with the original error message from the payment skill. do not retry automatically. user may restart the donation flow.

if payment skill returns empty tradeCode or tradeLink: this is an error state. send message indicating order creation failed and invite user to try again later.

output contract

on success:

• user receives structured message with emoji, trade code (numeric string), payment link (valid https url), and closing gratitude text.
• skill execution ends after displaying payment result.
• no further prompts are sent unless user initiates a new donation.

on user cancellation:

• skill ends after sending cancellation acknowledgment. no payment is made.

on validation failure:

• skill loops within step 2/3 until valid amount is collected.

on payment skill error:

• error message from payment skill is surfaced to user as-is. skill ends without retry.

outcome signal

user knows the skill worked when:

• they see the formatted success message with "✅ 打赏成功！已为您创建打赏订单。", a numeric trade code, and a clickable payment link after confirming donation amount.
• they can copy the trade code or click the payment link to complete payment in their payment app.
• if they say no at confirmation, they see the cancellation acknowledgment and are not charged.
• if they enter an invalid amount, they immediately see the validation error and are prompted to try again.

source: clawhub. original author not declared in source material.