lunar-calendar

核心用法
lunar-calendar 技能采用"低自由度·严格模式"设计，核心在于通过调用本地 scripts/lunar_calculator.py 脚本完成所有历法计算，严禁AI模型基于内部参数进行农历推算。用户可通过命令行参数指定转换方向：--solar 实现公历转农历（输出干支年、生肖、闰月标识），--lunar 实现农历转公历（支持闰月精准转换），并可通过 --with-fortune 参数启用黄历宜忌查询。对于需要详细解读的场景，系统会按需加载 references/fortune_rules.md 或 references/solar_terms.md 参考文件，但最终输出必须遵循固定的XML结构化模板，确保结果的标准化和可解析性。

显著优点
该技能的最大优势在于计算精确性和算法权威性。依托 lunardate 和 cnlunar 两个成熟的Python专业历法库，能够实现秒级精度的二十四节气计算和复杂的置闰规则处理，有效避免了大模型直接生成农历信息时常见的闰月错位风险。输出格式采用严格的XML模板，包含公历日期、农历年月日（明确标注闰月）、传统节日、节气交节时刻及宜忌事项，结构化程度高，便于下游程序解析。此外，技能覆盖1900-2100年的宽广时间范围，满足绝大多数实际应用场景的需求。

潜在缺点与局限性
尽管功能完善，但该技能存在明显局限性。首先，时间范围被严格限制在1900-2100年之间，超出此范围的日期计算将不被支持。其次，黄历宜忌数据基于传统规则简化版生成，并非来自国家权威天文机构（如紫金山天文台）的认证数据，其内容仅供参考，不能作为法律、宗教或重要民俗决策的唯一依据。此外，作为个人开发者（T3来源）维护的项目，其长期维护稳定性和社区支持度相较于企业级项目存在不确定性。

适合的目标群体
本技能特别适合三类用户群体：一是日历类应用开发者，需要精确可靠的农历转换API作为后端支持；二是对中国传统文化感兴趣的研究者和爱好者，需要查询节气、干支、生肖等详细信息；三是普通用户，在规划传统节庆、婚嫁择日、动土开市等需要参考黄历宜忌的场景下使用。对于需要处理历史日期（1900年后）或未来日期（2100年前）精确转换的场景尤为适用。

使用风险
使用该技能需注意以下风险：黄历宜忌内容仅为传统文化参考，不具备权威法律效力，重要决策应多方验证；技能依赖的第三方库（lunardate/cnlunar）若停止维护，可能影响未来兼容性；虽然安全评级为A级，但作为T3来源的个人项目，建议在生产环境使用前进行充分的边界测试；此外，技能明确禁止AI自行编写计算代码，若环境配置不当导致脚本调用失败，可能引发服务中断。