# holidays_skill

**Repository Path**: web/holidays_skill

## Basic Information

- **Project Name**: holidays_skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 节假日查询技能

## 功能说明

这是一个符合 OpenClaw 规范的节假日查询技能，可以帮助用户查询指定日期的节假日状态，包括工作日、假日、节日等信息。

## 支持的查询类型

1. **单个日期查询**：查询指定日期的详细节假日信息
2. **月份查询**：查询指定月份的所有节假日
3. **年份查询**：查询指定年份的所有节假日
4. **多个日期查询**：同时查询多个日期的节假日状态

## 使用方法

### 示例查询

- **查询今天是否为节假日**：
  ```
  今天是节假日吗？
  ```

- **查询特定日期的节假日信息**：
  ```
  2026年5月1日是什么节日？
  ```

- **查询月份节假日**：
  ```
  2026年10月有哪些节假日？
  ```

- **查询年份节假日安排**：
  ```
  2026年的节假日安排是什么？
  ```

- **查询今天的黄历宜忌**：
  ```
  今天宜做什么？
  ```

- **查询特定日期的黄历信息**：
  ```
  2026年5月1日的黄历是什么？
  ```

## 技术实现

### 核心依赖

- 无第三方依赖，直接调用免费的节假日查询 API

### API 接口

本技能使用以下 API 接口：

- **API 地址**：http://tool.bitefu.net/jiari/
- **请求方式**：GET
- **参数说明**：
  - `d`：日期，格式为 YYYYMMDD（单个日期）、YYYYMM（月份）、YYYY（年份）或多个日期用逗号分隔
  - `back`：返回格式，设置为 json
  - `info`：返回详细信息，设置为 1（仅用于单个日期查询）

### 返回结果说明

- **状态码**：
  - 0：工作日
  - 1：假日
  - 2：节日

- **详细信息**（当 info=1 时）：
  - status：0 失败，1 成功
  - type：0 工作日，1 假日，2 节日
  - day：年月日
  - unixtime：unix 时间戳
  - yearname：农历年
  - nonglicn：农历月日(中文)
  - nongli：农历月日
  - shengxiao：生肖
  - jieqi：节气
  - weekcn：星期(中文)
  - week1：星期(简写)
  - week2：星期(数字)
  - week3：星期(英文)
  - daynum：一年中第几天
  - weeknum：一年中第几周
  - avoid：忌（黄历）
  - suit：宜（黄历）

## 开发指南

### 目录结构

```
holidays_skill/
├── SKILL.md        # 技能定义文件（必需）
└── README.md       # 说明文档
```

### 技能定义文件格式

SKILL.md 文件包含以下部分：

1. **技能名称**：节假日查询技能
2. **描述**：简洁描述技能用途
3. **使用方法**：说明触发条件
4. **指令**：详细的处理逻辑和 API 调用方法

### 开发步骤

1. 创建技能目录：`mkdir -p holidays_skill`
2. 创建 SKILL.md 文件，编写技能定义
3. 创建 README.md 文件，编写说明文档
4. 将技能目录放入 OpenClaw 的技能目录中

### 调试方法

#### 1. 测试技能

使用 OpenClaw 命令行工具测试技能：

```bash
# 使用指定消息测试智能体
openclaw agent --message "今天是节假日吗？"

# 或者使用交互式模式
openclaw agent
```

#### 2. 查看技能加载状态

```bash
# 查看已加载的技能列表
openclaw skills list

# 查看特定技能的内容
openclaw skills show holidays_query

# 验证技能文件格式
openclaw skills validate d:\www\gg\holidays_skill
```

#### 3. 热加载技能

在修改技能文件后，可以使用斜杠命令热加载技能，无需重启 OpenClaw：

```
/reload-skills
```

#### 4. 排查问题

如果技能没有按预期工作，可以检查以下几点：

- 技能目录结构是否正确
- SKILL.md 文件格式是否符合规范
- YAML frontmatter 是否正确配置
- API 调用是否正常（可以使用浏览器或 curl 测试 API）
- 查看 OpenClaw 日志获取详细错误信息

#### 5. 测试用例

建议使用以下测试用例验证技能：

- **测试用例 1**：`今天是节假日吗？`
  期望：返回今天的节假日状态

- **测试用例 2**：`2026年5月1日是什么节日？`
  期望：返回劳动节相关信息

- **测试用例 3**：`2026年10月有哪些节假日？`
  期望：返回国庆节相关信息

- **测试用例 4**：`2026年的节假日安排是什么？`
  期望：返回2026年所有节假日

## 提交市场方法

1. **准备工作**：
   - 确保技能功能完整，无错误
   - 编写详细的 README.md 文档
   - 测试技能在不同场景下的表现

2. **提交流程**：
   - 登录 OpenClaw 开发者平台
   - 点击「发布技能」
   - 填写技能信息，包括名称、描述、版本等
   - 上传技能目录（包含 SKILL.md 和 README.md）
   - 提交审核

3. **审核标准**：
   - 技能功能是否完整
   - 是否符合 OpenClaw 技能规范
   - 文档是否详细清晰
   - 是否存在安全隐患

4. **发布后**：
   - 定期更新技能，确保 API 调用正常
   - 收集用户反馈，持续优化技能

## 注意事项

- 本技能使用的是第三方免费 API，可能存在调用限制
- 建议在查询大量日期时分批查询，避免超过 API 限制
- 如遇 API 不可用情况，技能会返回相应的错误信息

## 版本历史

- v1.0.0：初始版本，支持单个日期、月份、年份和多个日期查询