Skip to content

ZJU-REAL/Easel / skills/builtin/skill-event-calendar

skill-event-calendar

Verified

查询未来 N 天的节日、纪念日、电商节点、行业事件,为创作者提供内容蹭点。 覆盖中国节假日、国际节日、电商大促、行业展会、考试节点、体育赛事等。 当用户说"未来有什么节日"、"下个月有什么可以蹭"、"节点日历"、"营销日历"、 "有什么热点可以提前准备"、"内容日历节点"、"最近有什么节日"、 "什么时候有大促"、"节日营销"时触发。 和 skill-content-calendar 的区别:content-calendar 排内容发布日程, event-calendar 提供节日和事件的数据查询,是选题灵感的上游数据源。

FileKindSize
EASEL-META.mdmarkdown2.7 KB
SKILL.mdskill md6.7 KB
references/events-china.mdmarkdown12.1 KB
scripts/lunar.pyexecutablescript11.1 KB

EASEL-META.md

View on GitHub
# EASEL-META — skill-event-calendar

本文件记录 SKILL 的移植血缘与致谢,不参与运行。

## scripts/lunar.py — 农历↔公历换算算法来源(诚实标注)

`scripts/lunar.py` 为纯 Python 标准库实现,覆盖公历 1900-2100。核心是业界广泛流传的
**lunarInfo 十六进制年表算法**:每个农历年用一个约 20bit 的整数编码「闰月位置 / 闰月大小 /
12 个月的大小月」,配合基准锚点(农历 1900 年正月初一 = 公历 1900-01-31)做天数偏移计算。

| 要素 | 说明 |
|------|------|
| 数据表 | `_LUNAR_INFO`(1900-2100,201 个十六进制数)—— 该表在众多开源农历库中完全一致,属通用历法常量 |
| 算法 | 年天数累加 + 月序(含闰月)偏移,`l2s`/`s2l` 互为逆运算 |
| 基准 | 农历 1900-01-01 == 公历 1900-01-31 |
| 依赖 | 仅标准库 `datetime` / `argparse` / `json`,无任何第三方包 |

### 参考的开源实现(致谢,仅方法论参考,未直接复制代码)

| 项目 | 地址 | 参考用途 |
|------|------|---------|
| isee15/Lunar-Solar-Calendar-Converter | https://github.com/isee15/Lunar-Solar-Calendar-Converter | lunarInfo 年表 + 天数偏移换算的经典结构 |
| jjonline/calendar.js | https://github.com/jjonline/calendar.js | 中文农历库常见的 lunarInfo 编码与月大小判定位运算写法 |

上述项目均为 MIT / 开源许可。本 SKILL 未集成其源码,仅参照公开的历法常量表与算法思路自行实现。

## 自测锚点(`python3 scripts/lunar.py selftest`)

已验证换算正确的锚点:

| 输入 | 期望公历 |
|------|---------|
| 2025 春节(农历正月初一) | 2025-01-29 |
| 2024 春节 | 2024-02-10 |
| 2023 春节 | 2023-01-22 |
| 2025 中秋(农历八月十五) | 2025-10-06 |
| 2024 中秋 | 2024-09-17 |
| 2025 端午(农历五月初五) | 2025-05-31 |
| 2023 闰二月初一(闰月) | 2023-03-22 |
| 除夕 2025(春节前一天) | 2025-01-28 |
| 腊八 2025 | 2025-01-07 |

另含 **2000-2050 每一天** 的 `s2l → l2s` 往返一致性遍历自测,全部通过。

## 使用约定

SKILL.md 规定:涉及农历节日的公历日期一律调用 `scripts/lunar.py` 换算,不靠 LLM 估算。

## 节点数据与分类体系来源(致谢,仅参考方向)

`references/events-china.md` 的节日/电商/行业节点数据与分类体系,参考了以下方向自行整理:

- GitHub 上 chinese-calendar、lunar-calendar 等中国历法开源项目
- 社媒营销日历工具(新榜营销日历、千瓜营销日历)的节点分类体系
- 电商平台官方大促日历(淘宝/京东/拼多多/抖音电商)
- 内容创作者社区的节日营销经验总结
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall