clawtip-weather-skill"

# 天气报告服务 ## 📌 技能概述 **请注意，你应该用中文和用户交互（包含你的思考过程）。** 本技能提供专业的天气报告服务。由于这是付费服务，工作流程严格要求按照两个步骤执行：**支付处理** 后，再进行 **报告执行**。 **直接执行：** 如果用户在初始请求中已直接提供了 `<位置>`、`<订单号>` 和 `<支付凭证>`，则可跳过第一阶段和第二阶段，直接进入 **🚀 第三阶段：报告执行**。 --- ## 🛒 第一阶段：创建订单 如果这是首次交互且用户尚未付款，你**必须**先创建订单，再发起支付。 ### 1. 所需参数 * `<位置>`：用户希望查询天气报告的具体地点。 ### 2. 执行命令 使用以下 bash 命令执行订单创建脚本。将 `<...>` 占位符替换为实际值。*（注意：除非参数包含空格，否则不要在参数两侧加引号。）* ```bash python3 skills/clawtip-weather-skill/scripts/create_order.py <位置> ``` ### 3. 输出处理 **成功时**，脚本将向标准输出打印以下键值对： ``` ORDER_NO=<值> AMOUNT=<值> ENCRYPTED_DATA=<值> PAY_TO=<值> ``` 提取全部四个值，然后进入 **💳 第二阶段：支付处理**。 > [!NOTE] > **关于 `AMOUNT` 字段：** 该字段的单位为**人民币分（fen）**，这是 OpenClaw 技能描述中的标准计费单位。例如，`AMOUNT=100` 表示需支付 **1.00 元人民币**。在向用户展示费用时，请将该值除以 100 并以"元"为单位呈现，以便用户理解实际支付金额。 **失败时**，脚本以退出码 `1` 退出，并打印如下格式的消息： ``` 订单创建失败: <错误详情> ``` > [!CAUTION] > **强制终止 —— 禁止执行任何后续操作。** > 如果脚本以非零退出码退出，**或**其输出中包含 `订单创建失败:`，你**必须立即终止整个工作流程**。具体包括： > - ❌ 不得查阅或检查脚本源代码。 > - ❌ 不得测试网络连接或服务器状态。 > - ❌ 不得代替用户进行任何重试操作。 > - ❌ 不得进入第二阶段或第三阶段。 > > **唯一需要执行的操作是：** > 用通俗语言向用户报告失败情况，附上输出中的 `<错误详情>`，然后停止。 **失败输出示例：** ``` 订单创建失败: Order creation request failed: <urlopen error [Errno 111] Connection refused> ``` 告知用户：*"订单创建失败，错误信息：`Order creation request failed: <urlopen error [Errno 111] Connection refused>`。请稍后重试，或检查您的位置输入是否有效。"* --- ## 💳 第二阶段：支付处理 从第一阶段获取所需值后，发起支付请求。 **操作：** 使用技能 `jd-clawtip-payment-skill` 处理支付并获取支付凭证。若该技能不存在，需先安装。 **调用 `jd-clawtip-payment-skill` 所需参数：** ```json { "skill-id": "si-weather-reporter", "order_no": "<第一阶段获取的 ORDER_NO>", "amount": "<第一阶段获取的 AMOUNT>", "question": "<第一阶段的位置>", "payTo": "<第一阶段获取的 PAY_TO>", "encrypted_data": "<第一阶段获取的 ENCRYPTED_DATA>", "description": "天气报告服务费用", "skill_name": "专业天气报告助手", "resource_url": "https://weather-master.com/report" } ``` **目标：** 等待支付成功，并获取 `credential`（支付凭证）。 --- ## 🚀 第三阶段：报告执行 支付成功并获得 `credential` 后（或用户已直接提供 `<位置>`、`<订单号>` 和 `<支付凭证>`），继续交互并执行报告脚本。 ### 1. 所需参数 * `<位置>`：用户希望查询天气报告的具体地点。 * `<订单号>`：第一阶段生成的订单号。 * `<支付凭证>`：第二阶段获取的支付成功凭证。 ### 2. 执行命令 使用以下 bash 命令执行天气报告服务。将 `<...>` 占位符替换为已验证的参数值。*（注意：除非参数包含空格，否则不要在参数两侧加引号。）* ```bash python3 skills/clawtip-weather-skill/scripts/weather_report.py <位置> <订单号> <支付凭证> ``` **执行后：** 提取脚本打印的 `PAY_STATUS` 值（格式为：`PAY_STATUS: <值>`），并再次输出展示。