← 返回 Skills 市场

Lunar Calendar Vietnam

Name: Lunar Calendar Vietnam
Author: tuanxt

作者 tuanxt · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

272

总下载

当前安装

版本数

在 OpenClaw 中安装

/install lunar-calendar-vietnam

功能描述

Công cụ tra cứu Âm lịch, chuẩn xác theo hệ lịch Việt Nam (giờ GMT+7). Năng lực cốt lõi: - Dương lịch chuyển sang Âm Lịch (có Can Chi, Con Giáp Việt Nam) - Âm...

使用说明 (SKILL.md)

\x3Cskill_body>

🎯 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)

\x3Ccritical_rule status="Tối cao"> 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. \x3C/critical_rule>

Dùng bash / terminal để chạy amlich_calculator.js (ưu tiên đường dẫn tương đối để dễ chia sẻ skill):

# Chạy từ thư mục gốc của skill:
cd lunar-calendar-vietnam
node scripts/amlich_calculator.js --solar "2026-02-13"
node scripts/amlich_calculator.js --lunar "2026-01-01"

# Hoặc chạy từ bất kỳ đâu (tự neo theo vị trí SKILL.md):
node "$(dirname \"/path/to/lunar-calendar-vietnam/SKILL.md\")/scripts/amlich_calculator.js" --solar "2026-02-13"

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 \x3C/skill_body>

安全使用建议

What to consider before installing: - Functionally coherent: The files implement a Vietnamese lunar calendar and include reference docs; no obvious network calls or credential access were found in the provided files. - Runtime mismatch: The SKILL.md mandates running node scripts, but the skill metadata does not declare Node as a required binary nor provide an install step to install dependencies (minimist). Confirm your environment has a safe Node runtime and the dependency installed, or add an explicit install step before use. - Code review / sandbox: If you don't control the runtime, review amlich.js and scripts/amlich_calculator.js yourself (or run them in an isolated sandbox) before granting the agent permission to execute them. The code appears benign and implements calendar math, but executing any bundled script carries risk if the environment differs (missing exports, unexpected globals) or if future versions add network or I/O. - Operational tip: If you plan to enable autonomous agent invocation, be extra cautious — autonomous execution combined with on-disk scripts increases blast radius. Prefer manual invocation or run the script in a restricted container and verify outputs before exposing results to other systems.

功能分析

Type: OpenClaw Skill Name: lunar-calendar-vietnam Version: 1.0.0 The skill bundle is a legitimate implementation of a Vietnamese lunar calendar tool. It uses a well-known, established algorithm (amlich.js by Ho Ngoc Duc) for date conversions and provides a CLI wrapper (amlich_calculator.js) for the agent to execute. There is no evidence of data exfiltration, malicious system calls, or prompt injection; the instructions in SKILL.md are appropriately focused on ensuring the AI uses the tool for accuracy rather than hallucinating dates.

能力评估

ℹ Purpose & Capability

The name/description (Vietnamese lunar calendar) align with the included code (amlich.js + a CLI wrapper). However, the SKILL.md mandates running node scripts, yet the registry metadata lists no required binaries and provides no install step — running the code legitimately requires Node and an npm dependency (minimist) which are not declared.

ℹ Instruction Scope

SKILL.md explicitly requires invoking the terminal to run scripts in the skill bundle and to read the provided references files for deeper answers. This is within the skill's purpose but unusual because it forbids the model from computing results itself and forces executing local code; executing local scripts increases attack surface and should be done only if you trust the code or run it in a sandbox.

⚠ Install Mechanism

There is no install spec even though package.json lists a dependency (minimist). The bundle does not include node_modules, and required binaries are not declared. This mismatch means the node script may fail at runtime or require the agent/system to fetch/install packages — the lack of an explicit, safe install mechanism is an incoherence and operational risk.

✓ Credentials

The skill requests no environment variables, credentials, or external config paths. The code does not reference network endpoints or secrets in the visible files, so requested privileges are proportionate to the stated purpose.

✓ Persistence & Privilege

always is false and the skill does not request permanent presence or modify other skills. It only instructs running local scripts and reading bundled reference files; no elevated persistence or cross-skill modification observed.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install lunar-calendar-vietnam
安装完成后，直接呼叫该 Skill 的名称或使用 /lunar-calendar-vietnam 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Lunar Calendar Vietnam v1.0.0 - Initial release: provides accurate Vietnamese lunar calendar lookup and conversion. - Supports conversion between solar and lunar dates (including Can Chi and Vietnamese Zodiac). - Offers basic hoàng đạo (auspicious hours) and 24 solar terms (tiết khí). - Uses `amlich.js` for precise calculations (including leap years). - Results are returned as JSON with clear natural language explanations. - Activated by user queries such as "ngày âm", "âm lịch", "giờ hoàng đạo", or relevant Vietnamese historical date requests.

元数据

Slug lunar-calendar-vietnam

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题