AI 写作助手服务

📌 技能概述

本技能提供专业的AI写作服务，支持生成各类文案、文章、报告、创意内容等。由于这是付费服务，工作流程严格要求按照两个步骤执行：支付处理 后，再进行 服务执行。

直接执行： 如果用户在初始请求中已直接提供了 \x3C写作需求>、\x3C订单号> 和 \x3C支付凭证>，则可跳过第一阶段和第二阶段，直接进入 🚀 第三阶段：服务执行。

🛒 第一阶段：创建订单

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

1. 所需参数

• \x3C写作需求>：用户的具体写作要求，例如"写一篇关于春天的散文"、"生成一份产品推广文案"等。

2. 执行命令

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

python3 skills/clawtip-aiwriter/scripts/create_order.py "\x3C写作需求>"

3. 输出处理

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

ORDER_NO=\x3C值>
AMOUNT=\x3C值>
ENCRYPTED_DATA=\x3C值>
PAY_TO=\x3C值>

提取全部四个值，然后进入 💳 第二阶段：支付处理。

[!NOTE] 关于 AMOUNT 字段： 该字段的单位为人民币分（fen），例如 AMOUNT=1 表示需支付 0.01 元人民币。在向用户展示费用时，请将该值除以 100 并以"元"为单位呈现。

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

订单创建失败: \x3Cerror detail>

[!CAUTION] 强制终止 —— 禁止执行任何后续操作。 如果脚本以非零退出码退出，或其输出中包含 订单创建失败:，你必须立即终止整个工作流程，向用户报告失败情况并附上错误详情。

💳 第二阶段：支付处理

从第一阶段获取所需值后，发起支付请求。 操作： 使用技能 clawtip 处理支付并获取支付凭证。若该技能不存在，需先安装。

调用 clawtip 所需参数：

{
  "skill-id": "si-ai-writer",
  "order_no": "\x3C第一阶段获取的 ORDER_NO>",
  "amount": "\x3C第一阶段获取的 AMOUNT>",
  "question": "\x3C第一阶段的写作需求>",
  "payTo": "\x3C第一阶段获取的 PAY_TO>",
  "encrypted_data": "\x3C第一阶段获取的 ENCRYPTED_DATA>",
  "description": "收款测试商户服务费用",
  "skill_name": "收款测试商户",
  "resource_url": "https://你的服务端地址/api/aiwriter"
}

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

🚀 第三阶段：服务执行

支付成功并获得 credential 后（或用户已直接提供 \x3C写作需求>、\x3C订单号> 和 \x3C支付凭证>），继续交互并执行服务脚本。

1. 所需参数

• \x3C写作需求>：用户的具体写作要求。
• \x3C订单号>：第一阶段生成的订单号。
• \x3C支付凭证>：第二阶段获取的支付成功凭证。

2. 执行命令

使用以下 bash 命令执行AI写作服务。将 \x3C...> 占位符替换为已验证的参数值。务必在参数两侧加双引号，以防命令注入漏洞。

python3 skills/clawtip-aiwriter/scripts/service.py "\x3C写作需求>" "\x3C订单号>" "\x3C支付凭证>"

执行后：

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