← Back to Skills Marketplace
zhou-xiaobo

节日查询

by zhou-xiaobo · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
137
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install festival-query
Description
节日查询工具,支持中国农历日期、传统节日、二十四节气、欧美主流节日查询。当用户提到 "今天是什么节日"、"农历几号"、"什么时候端午节"、"查一下清明节"、"感恩节是哪天"、 "2025年有什么节日"、"这个月有哪些节日"、"二十四节气"、"冬至是几号"、"圣诞节"、 "情人节"、"万圣节"、"复活节是哪天"、"...
README (SKILL.md)

节日查询

查询中国传统节日、二十四节气、欧美主流节日。

依赖安装

首次使用前确保依赖已安装(通常已预装):

pip install --break-system-packages zhdate holidays

使用方式

脚本路径:scripts/festival_query.py

1. 查询指定日期

输入公历日期,返回农历信息、传统节日、节气、西方节日:

python3 scripts/festival_query.py --date YYYY-MM-DD

示例:

python3 scripts/festival_query.py --date 2025-10-06  # 中秋节
python3 scripts/festival_query.py --date 2025-01-29  # 春节
python3 scripts/festival_query.py --date 2025-12-25  # 圣诞节

2. 查询全年节日

列出指定年份所有节日和节气:

python3 scripts/festival_query.py --year YYYY

3. 查询指定月份节日

列出指定月份所有节日和节气:

python3 scripts/festival_query.py --month YYYY-MM

4. 查看全年二十四节气

仅显示节气日期表:

python3 scripts/festival_query.py --terms YYYY

涵盖范围

  • 中国传统节日(农历):春节、元宵、龙抬头、端午、七夕、中元、中秋、重阳、腊八、小年、除夕
  • 二十四节气:小寒 → 大寒,覆盖 2020-2030 年
  • 欧美/国际节日:元旦、情人节、愚人节、劳动节、母亲节、父亲节、万圣节、感恩节、平安夜、圣诞节、复活节等
  • 农历转换:天干地支年份、生肖、农历月日
Usage Guidance
This skill appears to be a local festival/date lookup tool and is internally consistent, but take these precautions before installing: 1) The provided source preview is truncated—inspect the full scripts/festival_query.py file to confirm there are no network calls, telemetry, or unexpected behavior in the remainder. 2) Avoid running pip with --break-system-packages on a system Python; install dependencies in a virtualenv or conda environment (python -m venv .venv; source .venv/bin/activate; pip install zhdate holidays). 3) The 'holidays' package is requested by SKILL.md but not evidently used in the shown code—confirm whether it is actually needed to reduce installed surface. 4) If you want higher assurance, run the script in an isolated environment and/or audit the full file contents for imports like requests, urllib, socket, subprocess, or any hardcoded URLs before use.
Capability Analysis
Type: OpenClaw Skill Name: festival-query Version: 1.0.0 The festival-query skill bundle is a legitimate utility for calculating and displaying Chinese traditional festivals, solar terms, and Western holidays. The Python script (scripts/festival_query.py) uses standard date arithmetic and the 'zhdate' library to perform its functions locally without any network requests, file system access, or suspicious execution logic. The documentation in SKILL.md accurately reflects the code's behavior and contains no prompt-injection attempts.
Capability Assessment
Purpose & Capability
The name/description match the included script: local calendar/lunar/holiday calculations and lookups. Minor inconsistency: SKILL.md asks to install the 'holidays' package, but the visible code imports only 'zhdate' (no use of 'holidays' in the shown portion), so that dependency may be unnecessary.
Instruction Scope
Runtime instructions are limited to running the local Python script with date/year/month/terms flags. The script performs local date and lunar calculations and returns human-readable output; there are no instructions to read unrelated system files or to transmit data externally in the visible code.
Install Mechanism
There is no registry install spec; SKILL.md recommends running 'pip install --break-system-packages zhdate holidays'. Installing PyPI packages is expected, but the '--break-system-packages' flag can modify system Python packages—use a virtual environment to avoid system changes. The packages named are standard PyPI libraries; no external arbitrary download is requested.
Credentials
No environment variables, credentials, or config paths are requested. The skill does not require secrets or access to other services based on the visible files.
Persistence & Privilege
The skill does not request always:true and has no install-time actions in the registry. It runs on demand and does not request elevated or persistent platform privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install festival-query
  3. After installation, invoke the skill by name or use /festival-query
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
首个版本:支持中国农历传统节日、二十四节气、欧美主流节日查询
Metadata
Slug festival-query
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 节日查询?

节日查询工具,支持中国农历日期、传统节日、二十四节气、欧美主流节日查询。当用户提到 "今天是什么节日"、"农历几号"、"什么时候端午节"、"查一下清明节"、"感恩节是哪天"、 "2025年有什么节日"、"这个月有哪些节日"、"二十四节气"、"冬至是几号"、"圣诞节"、 "情人节"、"万圣节"、"复活节是哪天"、"... It is an AI Agent Skill for Claude Code / OpenClaw, with 137 downloads so far.

How do I install 节日查询?

Run "/install festival-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 节日查询 free?

Yes, 节日查询 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 节日查询 support?

节日查询 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 节日查询?

It is built and maintained by zhou-xiaobo (@zhou-xiaobo); the current version is v1.0.0.

💬 Comments