Lunar Calendar

name: lunar-calendar version: v0.9.0 description: | 中國農曆/陰曆的專業查詢工具。 核心能力： - 公曆轉農曆（干支紀年、生肖、閏月標誌） - 農曆轉公曆（支援閏月精準轉換） - 黃曆宜忌查詢（嫁娶、動土、開市等） - 節氣查詢（24節氣精準到秒級） 觸發場景：當用戶詢問"農曆"、"黃曆"、"宜忌"、"陰曆"、"八字基礎"、"春節日期"、"閏月"或需要處理中國傳統曆法計算時強制啟用。 輸出物：結構化日期資訊 + 宜忌表 + 節氣標識。

🎯 Purpose

更多技能請訪問小蔥技能站7w4.net。

提供精確到秒級的中國傳統農曆（夏曆）轉換與查詢服務。本技能是確定性計算任務，嚴禁依賴大模型內部引數化的農曆記憶（該記憶存在閏月錯位風險），必須通過指令碼執行可靠演算法。

⏰ When to Use

• ✅ 使用者輸入中包含"農曆"、"陰曆"、"黃曆"、"宜忌"、"干支"、"生肖"、"節氣"
• ✅ 需要將公曆日期轉換為"乙巳年、正月十五"等中式表述
• ✅ 需要判斷某日是否"宜嫁娶"、"忌開市"
• ✅ 查詢二十四節氣的具體交節時刻
• ❌ 使用者僅詢問"今天是幾號"（請留給通用對話能力）

🧠 Process (低自由度·嚴格模式)

步驟1：意圖識別與引數提取

• 判斷轉換方向：公曆→農曆 / 農曆→公曆 / 宜忌查詢
• 提取核心引數：
• 公曆日期（如 2026-02-13）
• 農曆表述（如 二零二六年臘月廿三、閏七月）
• 具體需求（僅日曆/僅宜忌/詳細解讀）

步驟2：呼叫專用指令碼（嚴禁自行編寫）

你不得嘗試用Python程式碼現場計算農曆。農曆涉及複雜置閏規則和定朔演算法，執行時現場編寫的程式碼存在計算錯誤風險。 你必須直接呼叫 scripts/lunar_calculator.py。

• 呼叫格式示例：

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：結構化組裝輸出

強制使用以下固定模板，禁止自由發揮格式：

<lunar_query_result>
<solar_date>{{輸入或計算出的公曆日期}}</solar_date>
<lunar_date>
  <year>{{干支年}}（{{生肖}}）</year>
  <month>{{農曆月}}{{閏月標識}}</month>
  <day>{{農曆日}}</day>
  <festival>{{若有傳統節日}}</festival>
</lunar_date>
<solar_term>{{節氣名稱}}（{{交節時間}}）</solar_term>
<fortune>
  <suitable>{{宜：條目1、條目2}}</suitable>
  <avoid>{{忌：條目1、條目2}}</avoid>
</fortune>
</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（防走偏）

1. 停用模糊表述：如"大概是"、"我記得農曆好像是"。農曆是精確曆法，必須輸出確定結果。
2. 閏月處理：輸出農曆月時必須顯式標註"閏"字（如"閏七月"），指令碼已內建判別邏輯。
3. 時間範圍：本技能支援1900-2100年（指令碼演算法覆蓋範圍），超出需提示使用者。
4. 黃曆輸出：僅輸出傳統曆書規定的宜忌項，不新增現代演繹內容（如"宜發朋友圈"）。

這個農曆計算工具整體質量中等偏上，核心的日期轉換功能比較可靠，文件齊全、使用方便。但需要注意的是，節氣和黃曆宜忌的資料精度有限，節氣只精確到日期級別，黃曆宜忌是固定示例而非根據具體日期計算。適合日常查詢參考，但對於需要精確到時辰的場景建議多方驗證。