节日查询

节日查询工具，支持中国农历日期、传统节日、二十四节气、欧美主流节日查询。当用户提到 "今天是什么节日"、"农历几号"、"什么时候端午节"、"查一下清明节"、"感恩节是哪天"、 "2025年有什么节日"、"这个月有哪些节日"、"二十四节气"、"冬至是几号"、"圣诞节"、 "情人节"、"万圣节"、"复活节是哪天"、"...

Security Scan

The skill's code and instructions align with a local festival/date lookup tool (no credentials, no network endpoints shown), but the provided source was truncated and the SKILL.md requests an extra dependency and a pip flag that deserve a quick manual check before installing.

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.

Assessment

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.

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

依赖安装

首次使用前确保依赖已安装（通常已预装）：

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 年
• 欧美/国际节日：元旦、情人节、愚人节、劳动节、母亲节、父亲节、万圣节、感恩节、平安夜、圣诞节、复活节等
• 农历转换：天干地支年份、生肖、农历月日