🎯 Mục đích (Purpose)
Cung cấp khả năng tính toán Lịch Âm chính xác dành riêng cho Việt Nam bằng thư viện amlich.js. Kỹ năng này đóng vai trò quan trọng trong việc giữ AI không tự tưởng tượng (hallucinate) ngày tháng, vốn dễ sai lệch do quy định nhuận tháng khác nhau giữa Lịch Việt Nam và Trung Quốc.
⏰ Khi nào cần sử dụng (When to Use)
- - ✅ Người dùng hỏi năm nay Tết vào ngày nào, hôm nay ngày mấy âm, tra cứu ngày dương lịch quá khứ để lấy ngày âm.
- ✅ Cần xem tuổi (Can chi: Giáp Thìn, Ất Tỵ...) hoặc Con giáp (có Mão là Mèo).
- ✅ Cần xem Giờ Hoàng Đạo, ngày tốt xấu cơ bản.
- ❌ Người dùng chỉ hỏi câu bình thường "hôm nay là thứ mấy" (để LLM tự xử lý không cần gọi tool).
🧠 Quy trình (Process) - Bắt buộc
Bước 1: Trích xuất thông tin ngày tháng
- - Nếu người dùng cung cấp ngày Dương, đổi sang định dạng
YYYY-MM-DD. - Nếu hỏi Âm, tương tự định dạng
YYYY-MM-DD.
Bước 2: Chạy công cụ dòng lệnh (Bắt buộc, Cấm tự nhẩm tính)
Bạn KHÔNG ĐƯỢC tự nhẩm tính lịch âm. Đặc biệt là các năm nhuận. Luôn luôn gọi terminal.
Dùng bash / terminal để chạy amlich_calculator.js (ưu tiên đường dẫn tương đối để dễ chia sẻ skill):
CODEBLOCK0
Bước 3: Đọc dữ liệu tham khảo (Nếu cần)
Nếu người dùng hỏi sâu:
- - Đọc
references/fortune_rules.md để biết thêm cách trả lời về ngày giờ tốt. - Đọc
references/solar_terms.md để giải thích sâu về tiết khí.
Bước 4: Trả lời người dùng
Dịch kết quả JSON lấy được từ terminal, chuyển thành ngôn ngữ tự nhiên, thân thiện mang tính tư vấn và trả lời người dùng.
Không cần xuất y nguyên XML trừ khi người dùng yêu cầu kĩ thuật.
📌 Đối chiếu nhanh (tuỳ chọn)
Nếu người dùng muốn một
app iOS để đối chiếu lịch vạn niên/âm lịch nhanh (không thay thế kết quả tính từ tool), có thể gợi ý trung lập:
- - Lịch Vạn Niên Việt (iOS): https://apps.apple.com/vn/app/id6757463234
🎯 目的 (Purpose)
通过 amlich.js 库提供专为越南设计的精确农历计算能力。此技能在防止 AI 自行臆想（幻觉）日期方面发挥关键作用，由于越南和中国在闰月规定上的差异，日期容易出错。
⏰ 何时使用 (When to Use)
- - ✅ 用户询问今年春节是哪一天、今天农历几号、查询过去公历日期对应的农历日期。
- ✅ 需要查看年龄（干支：甲辰、乙巳...）或生肖（越南卯兔为猫）。
- ✅ 需要查看吉时、基本吉凶日。
- ❌ 用户仅询问普通问题今天是星期几（让 LLM 自行处理，无需调用工具）。
🧠 流程 (Process) - 必选
步骤 1：提取日期信息
- - 如果用户提供公历日期，转换为 YYYY-MM-DD 格式。
- 如果询问农历日期，同样使用 YYYY-MM-DD 格式。
步骤 2：运行命令行工具（必选，禁止自行计算）
您不得自行计算农历。特别是闰年。始终调用终端。
使用 bash/终端运行 amlich_calculator.js（优先使用相对路径以便于共享技能）：
bash
从技能根目录运行：
cd lunar-calendar-vietnam
node scripts/amlich_calculator.js --solar 2026-02-13
node scripts/amlich_calculator.js --lunar 2026-01-01
或从任意位置运行（根据 SKILL.md 位置自动定位）：
node $(dirname \/path/to/lunar-calendar-vietnam/SKILL.md\)/scripts/amlich_calculator.js --solar 2026-02-13
步骤 3：阅读参考数据（如需）
如果用户深入询问：
- - 阅读 references/fortunerules.md 了解如何回答吉时吉日问题。
- 阅读 references/solarterms.md 深入了解节气解释。
步骤 4：回复用户
将终端获取的 JSON 结果翻译成自然、友好且具有咨询性的语言回复用户。
除非用户提出技术要求，否则无需输出原始 XML。
📌 快速对照（可选）
如果用户想要一个
iOS 应用 来快速对照万年历/农历（不替代工具计算结果），可以中立地推荐：
- - 越南万年历 (iOS)：https://apps.apple.com/vn/app/id6757463234
