生日万象查询服务(AI付版) - 聚合数据

SKILL.md

---
name: juhe-birthday-oracle-a2a
description: |
  聚合数据提供的生日万象技能，本技能使用无需用户注册聚合数据平台，安装后即可按实际查询付费使用。
  生日万象技能是根据用户的生日日期，提供生日书、生日密码、生日花语等综合信息的支付宝AI付付费技能，基于 A2M（HTTP 402）收单协议。买家通过本 Skill 向卖家服务端发起请求，完成支付后获取相关结果。
  调用过程仅上传查询用的出生日期至聚合数据服务端，不收集手机号、身份证等其他个人隐私；该技能包含性格特质、爱情运势、事业发展、健康建议、幸运信息、塔罗牌、名人案例等全方位解读。
  适用于用户查询特定日期的生日书、生日密码、生日花语、生日专属运势场景；仅单纯查询星座性格无生日专项解读需求不会触发付费技能。
---

## 技能概述

本 Skill 提供**生日书 & 生日密码 & 生日花语**综合查询服务。当用户询问某个日期的生日运势、星座性格、生日花语、幸运信息等内容时，使用此技能。

该服务是基于 A2M（HTTP 402）收单协议的付费资源。买家（消费者 Agent）通过本 Skill 向卖家服务端发起资源请求，服务端将返回 402 Payment-Needed 响应报文，买家需将该报文传递给支付宝的 alipay-payment-skill 技能以完成付款。

**涵盖内容：**

- 📖 **生日书**：性格特质、爱情观、金钱观、事业发展、健康建议、幸运数字
- 🔐 **生日密码**：深度性格解析、幸运指引、健康建议、名人案例、塔罗牌、金句箴言
- 🌸 **生日花语**：生日花名称、花语含义、守护石、传说故事

**适用场景：**

- 用户说"帮我查一下7月25日的生日书"
- 用户说"XX月XX日出生的人有什么生日专属性格特点"
- 用户说"查查今天的生日花是什么"
- 用户说"XX月XX日的生日密码和幸运色是什么"
- 用户问"某月某日出生的人适合什么职业（生日解读）"

## 系统要求

### 操作系统

由于该技能基于 A2M 协议，需要在支持 A2M 协议的系统上运行，支付宝支付 CLI 工具（alipay-bot）在 Windows 环境下暂不支持。

macOS / Linux，版本要求如下：
系统|版本要求
-|-
macOS| 12 Monterey 或更高版本<br>推荐 macOS 14 Sonoma 或 macOS 15 Sequoia
Linux| Ubuntu：>= 21.04 <br>Debian：>= 12 <br>CentOS：>= 9

### 环境要求

| 环境    | 版本要求 |
| ------- | -------- |
| Node.js | > 22     |
| npm     | > 10     |

## 必要依赖

本技能依赖于支付宝AI付技能，需要从clawhub上安装这两个技能：alipay-authenticate-wallet 和 alipay-payment-skill，安装后检查是否已开启支付宝支付功能，如未开启，需要提示用户开启支付宝支付功能。

## 触发条件

**需要同时满足两类正向条件，才可触发本付费技能；仅满足其中一条不会触发：**

### 正向条件1（意图/关键词命中其一）

1. 用户意图：需要查询指定日期对应的生日书、生日密码、生日花语、生日命理、生日专属性格解读；单纯询问通用星座、笼统运势不属于本技能意图；
2. 精准业务关键词（命中任意）：
   - 生日万象查询
   - 生日命理
   - 出生日期测算
   - 生日运势
   - 生日性格分析
   - 生日书
   - 生日密码
   - 生日花语

### 正向条件2（实体强制校验）

对话中识别到明确日期实体，支持格式：MM月DD日、0725、MM-DD、YYYY-MM-DD、今天/昨天/明天相对日期。

### 拦截规则（命中任意一条，直接不触发本付费技能）

1. 仅闲聊星座、笼统运势、单纯讨论星座性格，即便提供日期也不触发；
2. 仅科普星座划分、星座知识，无生日书/花语/生日密码专项查询需求；
3. 需求为八字、星盘、塔罗、算命等其他命理工具，不特指生日万象解读；
4. 无任何具体日期，仅模糊表达想测算运势。

**✅ 触发示例：**

- "帮我查一下7月25日的生日书"
- "今天出生的人有什么特点？"
- "7月25日的生日花是什么？"
- "查查7月25日的生日密码"
- "狮子座7月25日出生的人性格怎么样"
- "0725的幸运数字和幸运色是什么"

**❌ 不触发示例：**

- "今天天气怎么样"（无日期查询意图）
- "什么是星座"（咨询类问题，无具体日期）
- "帮我定个闹钟"（无关意图）
- "7月25日是什么星座"(有日期，但仅单纯查询星座)
- "帮我算下生日运势"（无任何具体日期，模糊诉求）

## 服务说明

- 本技能基于用户提供的出生日期，调用聚合数据生日万象付费接口，测算生日对应的星座、性格、运势等专项生日信息；
- 采用 A2M（HTTP 402）收单协议完成付费查询，仅传输出生日期，不会采集、存储身份证、手机号、住址等其他个人隐私；
- 仅依据日期做规则解析，无法核验生日真伪；
- 不会主动采集用户信息，未提供生日不会发起任何数据请求。

## 工作流程

当用户向你请求该服务时，按以下步骤执行：

### 第一步：付费告知与确认（必须执行）

**在收集任何参数之前，必须先向用户明确以下信息：**

> 🎨 本服务为**生日万象技能**，由聚合数据提供技术支持。
>
> - 费用：XX元/次（以实际支付为准）
> - 支付方式：支付宝（通过 alipay-payment-skill 完成）
> - 隐私说明：仅将你查询的出生日期单次临时发送至聚合数据服务端用于生日信息查询，无长期存储，不会采集身份证、手机号、住址等其他个人隐私信息
>
> 如您同意以上条款，请回复 **“确认”** 、**“好的”** 等肯定词或继续描述您要查询的日期。
> 如您不需要付费服务，请回复 **“取消”**，我将停止本次操作。

**只有用户明确表示同意（如回复“确认”“好的”“可以”“继续”“同意”“下一步”等肯定词）后，才能进入第二步收集参数。**

### 第二步：收集日期信息

从用户输入中提取目标日期。支持以下格式：

- **固定日期**：YYYY-MM-DD、MM-DD、MM月DD日、MMDD等附言日期语音（如"2023-07-25"、"07-25"、"7月25日"、"0725"等）
- **相对日期**：今天、明天、昨天（需结合当前日期计算，格式为"YYYY-MM-DD"或“MM-DD”（如"2023-07-25"或"07-25"））

**交互规则：用户只说测算生日运势、未提供日期时，引导用户补充具体几月几日；不默认使用今天日期。**<br>
**注意**：最终提取并传递的日期格式为"YYYY-MM-DD"或“MM-DD”（如"2023-07-25"或"07-25"）。

### 第三步：请求约束

- 请求方法：POST
- 请求头：Content-Type: application/json
- 请求体是json字符串，请严格按照以下格式填写：'{"resourceId":"619","data":{"keyword":"<需要查询的日期>"}}'
- 注意请求参数中如果出现引号，需要进行转义，确保json字符串格式正确有效

### 第四步：请求资源

向用户展示待查询的参数，严格遵守请求约束，向以下 URL 发起请求：

```
curl https://apis.juhe.cn/a2a/query \
  -d '{"resourceId":"619","data":{"keyword":"<用户输入的查询日期>"}}' \
  -H "Content-Type: application/json"
```

> 说明：接口路径 /a2a/query 为服务商固定后端地址，仅业务收单协议文案统一描述为A2M，二者不冲突。

### 第五步：处理 402 响应

你将收到一个**状态码为 402 的响应报文，其中包含 `Payment-Needed` 响应头**。此时你需要将**整个 402 响应报文**传递给支付宝的 **alipay-payment-skill** 技能，引导用户完成付款，并展示用户订单号（out_trade_no）。

### 第六步：后续流程

完全转移到 alipay-payment-skill 技能的工作流,提示支付待确认的信息时，需要包含用户订单号（out_trade_no）。禁止agent更改用户提交的请求参数即json字符串。

### 第七步：格式化数据输出

如用户付款且完成查询，将查询结果按以下结构组织，以清晰、美观的格式呈现给用户：

```markdown
# X月X日 生日万象

## 一、基本信息

| 项目     | 内容     |
| :------- | :------- |
| 日期     | MM月DD日 |
| 星座     | XX座     |
| 守护星   | XXX      |
| 数字     | X        |
| 支配行星 | XXX      |

## 二、生日花语

| 项目   | 内容 |
| :----- | :--- |
| 生日花 | XXX  |
| 花语   | XXX  |
| 守护石 | XXX  |

（花名由来、花语解读、守护石传说...）

## 三、性格特质

- 优点：XXX
- 缺点：XXX

（详细性格描述...）

## 四、爱情与人际

（爱情观、缘分速配...）

## 五、事业与财富

（事业发展建议、财富观...）

## 六、健康与生活

（健康建议...）

## 七、塔罗与箴言

（塔罗牌解读、金句...）

## 八、名人生日

（同日名人列表...）

## 九、箴言与建议

（综合建议...）
```

## 异常情况处理

- **用户拒绝付款**：尊重用户选择，告知用户该内容为付费资源，如需获取请完成支付。
- **请求返回非 402 状态码**：如返回 200，直接展示内容；如返回 4xx/5xx 错误，告知用户服务暂时不可用，建议稍后重试。
- 其余异常情况将由 alipay-payment-skill 技能处理。

## Agent 约束

- 缺少日期必填参数时，禁止发起接口请求；
- 402 响应报文必须完整透传，不可篡改、删减字段；
- 严格遵循既定流程与异常规则，禁止自定义交互逻辑；
- 禁止虚构数据，所有解读内容均来源于聚合数据第三方接口返回，不得自行编造；
- 禁止修改、删减接口返回的原始数据内容，保持信息完整；
- 禁止将用户提供的出生日期用于生日查询以外的任何用途；
- 输出统一使用清晰结构化 Markdown，提升可读性；
- 接口返回 HTML 标签时，自动转换为纯文本 Markdown，保留完整段落结构；
- 展示同日名人时，必须补充对应人物领域、简要成就介绍。

## 隐私与数据说明

| 数据类型       | 处理方式                                                                    |
| -------------- | --------------------------------------------------------------------------- |
| 用户查询的日期 | 单次查询临时发送至聚合数据 (juhe.cn) 服务端，仅用于生日万象解读，无长期存储 |
| 用户个人信息   | 本技能不收集任何个人信息                                                    |

**重要提示：**查询结果仅供参考娱乐，不具备科学依据。

## 合规声明

- 本技能提供的生日书、生日密码、生日花语等内容，均为民俗娱乐类信息，不具备科学决策、预测效力；
- 用户应当理性看待解读内容，不可将结果作为人生、职业、婚恋等重大事项决策依据；
- 本技能不生成、不传播违法、违规、侵犯他人肖像权 / 名誉权的内容。