taiwan-calendar

台湾日历查询技能（taiwan-calendar）专为解决 AI 助手在日期查询方面的知识截止限制而设计。由于 Claude 等大型语言模型存在知识截止日期，经常无法准确回答当前年份的台湾工作日、节假日安排以及补班日（補班日）等信息。该技能通过实时对接台湾政府开放数据平台（data.gov.tw），提供权威、准确的日历查询服务，有效避免了因知识滞后导致的日期计算错误。

该技能的核心用法涵盖多种实用场景。基础查询包括 today 命令获取当日日期及工作状态，check 命令验证特定日期是否为工作日或节假日。对于批量查询，range 命令可计算指定日期范围内的工作日数量并列出节假日。在日期计算方面，add-days 支持从指定日期推算 N 个工作日后的具体日期，适用于截止日期计算；next-working 和 next-holiday 则可快速定位下一个工作日或节假日，方便行程规划。所有命令均支持多种日期格式输入，并自动处理台湾时区（Asia/Taipei）。

显著优点在于数据权威性与实时性。直接对接台湾政府行政院人事行政总处发布的官方日历数据，确保节假日、补班日信息的准确无误，相比依赖模型训练数据具有不可比拟的优势。技能内置智能缓存机制（1小时过期），在保证数据新鲜度的同时减少 API 调用频率。支持复杂的工作日算术运算，能自动跳过周末和法定节假日进行日期推算，这对合同到期、项目排期等商务场景尤为实用。

潜在缺点与局限性主要包括地域限制和来源可信度。该技能专为台湾日历设计，不支持其他地区或农历（農曆）、二十四节气查询。作为 T3 级来源（个人开发者项目），社区验证相对有限，版本号仅为 0.0.1，可能存在未发现的边界情况。此外，功能高度依赖台湾政府开放数据平台的 API 可用性，若官方服务维护或网络受限，功能将受限。

适合的目标群体包括：台湾本地用户及企业，特别是需要进行工作日计算的人力资源、财务部门；与台湾有业务往来的跨境企业，需协调两岸工作日程；项目管理者进行基于工作日的进度规划；以及任何需要准确台湾日历信息的个人用户。对于经常处理"五个工作日内提交"这类需求的职场人士，该技能能提供精确的计算支持。

使用风险主要涉及网络依赖与数据时效。技能需要稳定的互联网连接访问政府 API，虽然设有备用数据源（新北市开放数据），但仍存在服务中断可能。缓存机制虽能缓解短期网络问题，但过期后无法更新。用户需注意该技能仅适用于当前及未来年份查询，不支持历史日期验证。另外，脚本执行依赖 Python 环境及特定依赖库（requests, python-dateutil），在极端情况下可能存在环境兼容性问题。