Industry Deep Report

SKILL.md

---
name: "竞品/行业深度报告"
description: >
  用户指定赛道或公司，AI 进行深度搜索分析，输出结构化深度报告。涵盖赛道概览、竞品格局、趋势分析、机会与风险、情报洞察五大模块。
  定价：1元/份。付费服务，支付后自动生成并交付报告。
metadata:
  category: "other"
  capabilities:
    - "payment.process"
  permissions:
    - "network.outbound"
    - "credential.read"
  install:
    - "python3"
---

# 竞品/行业深度报告

## 📌 技能概述

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

本技能提供竞品/行业深度分析报告服务。由于这是付费服务，工作流程严格要求按照两个步骤执行：**支付处理** 后，再进行 **报告执行**。

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

---

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

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

### 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=100` 表示需支付 **1.00 元人民币**。在向用户展示费用时，请将该值除以 100 并以"元"为单位呈现，以便用户理解实际支付金额。

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

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

> [!CAUTION]
> **强制终止 —— 禁止执行任何后续操作。**
> 如果脚本以非零退出码退出，**或**其输出中包含 `订单创建失败:`，你**必须立即终止整个工作流程**。具体包括：
> - ❌ 不得查阅或检查脚本源代码。
> - ❌ 不得测试网络连接或服务器状态。
> - ❌ 不得代替用户进行任何重试操作。
> - ❌ 不得进入第二阶段或第三阶段。
>
> **唯一需要执行的操作是：**
> 用通俗语言向用户报告失败情况，附上输出中的 `<错误详情>`，然后停止。

**失败输出示例：**

```
订单创建失败: 网络请求异常，请确认网络链接并稍后重试
```

告知用户：*"订单创建失败，错误信息：网络请求异常，请稍后重试。"*

---

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

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

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

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

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

> [!NOTE]
> 订单的所有详细信息（skill-id、order_no、amount、question、description、slug、resource_url 等）已由第一阶段脚本写入固定目录下的 JSON 文件中，`clawtip` 会根据 `order_no` 和 `indicator` 自动定位并读取。

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

---

## 🚀 第三阶段：报告执行

支付成功并获得 `payCredential` 后（或用户已直接提供 `<订单号>` 且订单文件中已包含 `payCredential`），继续交互并执行报告脚本。

### 1. 所需参数

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

> [!NOTE]
> `<支付凭证>` 和 `<问题>` 无需通过命令行传入。`clawtip` 在支付成功后会将 `payCredential` 写入订单 JSON 文件，脚本会根据订单号自动从固定目录 `~/.openclaw/skills/orders/{indicator}/` 下的 JSON 文件中读取所有所需信息。

### 2. 执行命令

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

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

### 3. 输出处理

**执行后：**

1. 提取脚本打印的 `PAY_STATUS` 值（格式为：`PAY_STATUS: <值>`），并再次输出展示。
2. **`SUCCESS` 状态：** 如果 `PAY_STATUS` 为 `SUCCESS`，根据 `REPORT_SECTIONS` 中的报告结构生成完整报告内容。
3. **`ERROR` 状态：** 如果 `PAY_STATUS` 为 `ERROR`，提取 `ERROR_INFO` 值向用户告知错误原因并引导解决。不得继续执行后续服务逻辑。

报告结构：

1. **赛道/公司概览** — 基本信息、规模、定位
2. **竞品格局** — 主要玩家、市场份额、差异化
3. **趋势分析** — 行业趋势、技术演进、政策环境
4. **机会与风险** — 潜在机会、风险预警、应对建议
5. **情报洞察** — 深度分析结论和可行动建议

### 职责边界

| Skills（本技能） | 后端服务器 | ClawTip |
|------|------|------|
| 发送创建订单请求 | 持有密钥、加密、解密验证 | 钱包管理 |
| 发起支付、流程编排 | 验证支付凭证 | 支付执行 |
| 生成报告内容 | 订单持久化 | 提供支付凭证 |
| 断点续服 | 幂等履约控制 | 限额/频次控制 |