/install lunar-calendar
\x3Cskill_body>
🎯 Purpose
提供精确到秒级的中国传统农历(夏历)转换与查询服务。本技能是确定性计算任务,严禁依赖大模型内部参数化的农历记忆(该记忆存在闰月错位风险),必须通过脚本执行可靠算法。
⏰ When to Use
- ✅ 用户输入中包含"农历"、"阴历"、"黄历"、"宜忌"、"干支"、"生肖"、"节气"
- ✅ 需要将公历日期转换为"乙巳年、正月十五"等中式表述
- ✅ 需要判断某日是否"宜嫁娶"、"忌开市"
- ✅ 查询二十四节气的具体交节时刻
- ❌ 用户仅询问"今天是几号"(请留给通用对话能力)
🧠 Process (低自由度·严格模式)
步骤1:意图识别与参数提取
- 判断转换方向:
公历→农历/农历→公历/宜忌查询 - 提取核心参数:
- 公历日期(如
2026-02-13) - 农历表述(如
二零二六年腊月廿三、闰七月) - 具体需求(仅日历/仅宜忌/详细解读)
- 公历日期(如
步骤2:调用专用脚本(严禁自行编写)
\x3Ccritical_rule status="最高优先级">
你不得尝试用Python代码现场计算农历。农历涉及复杂置闰规则和定朔算法,运行时现场编写的代码存在计算错误风险。
你必须直接调用 scripts/lunar_calculator.py。
\x3C/critical_rule>
- 调用格式示例:
python scripts/lunar_calculator.py --solar 2026-02-13
python scripts/lunar_calculator.py --lunar "2026-07-23" --leap false
python scripts/lunar_calculator.py --solar 2026-02-13 --with-fortune true
步骤3:按需加载参考资源
- 如需输出"详细宜忌解读",必须先读取 references/fortune_rules.md
- 如需解释"节气原理",读取 references/solar_terms.md
- 严禁将上述Reference全文塞入上下文,仅读取所需章节。
步骤4:结构化组装输出
强制使用以下固定模板,禁止自由发挥格式:
\x3Clunar_query_result>
\x3Csolar_date>{{输入或计算出的公历日期}}\x3C/solar_date>
\x3Clunar_date>
\x3Cyear>{{干支年}}({{生肖}})\x3C/year>
\x3Cmonth>{{农历月}}{{闰月标识}}\x3C/month>
\x3Cday>{{农历日}}\x3C/day>
\x3Cfestival>{{若有传统节日}}\x3C/festival>
\x3C/lunar_date>
\x3Csolar_term>{{节气名称}}({{交节时间}})\x3C/solar_term>
\x3Cfortune>
\x3Csuitable>{{宜:条目1、条目2}}\x3C/suitable>
\x3Cavoid>{{忌:条目1、条目2}}\x3C/avoid>
\x3C/fortune>
\x3C/lunar_query_result>
🔍 Decision Logic
graph TD
A[用户输入] --> B{包含农历/黄历关键词?}
B -->|否| C[不激活技能]
B -->|是| D{具体请求类型?}
D -->|公历转农历| E[提取日期→调用lunar_calculator.py --solar]
D -->|农历转公历| F[解析农历字符串→调用lunar_calculator.py --lunar]
D -->|查询宜忌| G[调用脚本+读取fortune_rules.md]
E --> H[组装XML输出]
F --> H
G --> H
⚠️ Constraints(防走偏)
- 禁用模糊表述:如"大概是"、"我记得农历好像是"。农历是精确历法,必须输出确定结果。
- 闰月处理:输出农历月时必须显式标注"闰"字(如"闰七月"),脚本已内置判别逻辑。
- 时间范围:本技能支持1900-2100年(脚本算法覆盖范围),超出需提示用户。
- 黄历输出:仅输出传统历书规定的宜忌项,不添加现代演绎内容(如"宜发朋友圈")。 \x3C/skill_body>
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install lunar-calendar - 安装完成后,直接呼叫该 Skill 的名称或使用
/lunar-calendar触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Lunar Calendar 是什么?
中国农历/阴历的专业查询工具。 核心能力: - 公历转农历(干支纪年、生肖、闰月标志) - 农历转公历(支持闰月精准转换) - 黄历宜忌查询(嫁娶、动土、开市等) - 节气查询(24节气精准到秒级) 触发场景:当用户询问"农历"、"黄历"、"宜忌"、"阴历"、"八字基础"、"春节日期"、"闰月"或需要处理中国传统历法计算时强制激活。 输出物:结构化日期信息 + 宜忌表 + 节气标识。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1063 次。
如何安装 Lunar Calendar?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install lunar-calendar」即可一键安装,无需额外配置。
Lunar Calendar 是免费的吗?
是的,Lunar Calendar 完全免费(开源免费),可自由下载、安装和使用。
Lunar Calendar 支持哪些平台?
Lunar Calendar 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Lunar Calendar?
由 hehuibiao(@hehuibiao)开发并维护,当前版本 v0.9.0。