前言¶
做命理類應用時，開發者最頭疼的不是算法本身，而是幾件事的疊加：曆法數據（萬年曆、節氣、真太陽時）不準，排盤結果無法解釋出處，古籍引用查無來源，最後輸出一份報告還要自己排版生成 PDF。命理參鑑（@user_4c01d36b/mingli-canjian）就是針對這一串痛點給出的技能方案：以八字爲主系統，紫微斗數做交叉參照，內置 1900—2100 年的歷法與節氣參考、真太陽時校正以及傳統命理典籍全文庫，輸入公曆或農曆出生信息，輸出可追溯的命理報告並生成可下載 PDF。
下面介紹這個 Skill 的定位、能力、安裝啓用方式、典型用法和適用邊界。
這是什麼¶
命理參鑑是一個面向開發者的 Agent Skill，座標 @user_4c01d36b/mingli-canjian，版本 1.0.0，由社區開發者 user_4c01d36b 發佈，來源標記爲 community，分類爲 professional。它解決的是這樣一類需求：用戶給出生日期（公曆或農曆）和出生時間，需要一份結構完整、口徑統一、能引用古籍的命理報告，而不是零散的排盤結果。
按官方說明，報告內容僅用於傳統文化研究與個人參考，這是使用前提，不是免責聲明式套話。
核心功能¶
- 八字爲主系統：先做四柱排盤，作爲報告的核心框架。
- 紫微斗數交叉參照：在主斷之後用紫微盤做交叉校驗，用於解釋不一致或補充視角，而不是另起一套獨立結論。
- 曆法與節氣參考：內置 1900—2100 年萬年曆與節氣數據，覆蓋跨世紀出生日期的換算與節氣定位。
- 真太陽時校正：對出生時間做真太陽時修正，這是八字排盤裏容易被忽略但會影響時辰判定的環節。
- 古籍全文庫：內置傳統命理典籍全文，報告結論可以回溯到原文出處。
- 報告生成與 PDF 輸出：支持三類報告——一生綜合報告、逐步大運分析、年度命理報告，並輸出可下載的 PDF 文件。
三個報告類型對應的輸入和口徑是統一的：公曆或農曆出生信息均可，報告內部口徑以八字爲主、紫微爲輔。
安裝與啓用¶
按 SkillHub 頁面信息，該 Skill 標籤爲 requires_api_key=false，即不需要 API Key 即可使用。社區來源（community）與 professional 分類意味着它面向有 Skill 使用經驗的開發者，通常通過 SkillHub 頁面安裝或在支持 Skill 的 Agent 環境中按座標引用。
安裝方式以官方頁面爲準：
官方地址：https://api.skillhub.cn/user_4c01d36b/mingli-canjian
SkillHub 頁面：https://www.skillhub.cn/skills/user_4c01d36b/mingli-canjian
座標：@user_4c01d36b/mingli-canjian
需要說明的是，本次抓取的資料中沒有列出具體安裝命令、目錄路徑或配置文件字段，因此這裏不給出未經覈實的命令。該 Skill 基於通用 SKILL.md 格式，啓用方式與所用 Agent 環境（Cursor、Codex CLI、Claude Code 等）相關，差異請以官方頁面說明爲準。
典型用法¶
使用入口是用戶的自然語言請求，以下幾類請求會觸發該 Skill：
- 排八字：用戶給出出生信息，Skill 先做真太陽時校正，再排出四柱。
- 排紫微斗數：作爲交叉參照，與八字結論互相校驗。
- 分析一生或逐步大運：輸出一生綜合報告或按大運逐步展開。
- 生成年度命理報告：針對某一年給出年度口徑的報告。
- 引用命理古籍：需要把結論落到典籍原文時，從內置全文庫檢索並標註出處。
- 生成可下載 PDF：報告完成後輸出 PDF 文件。
一個可復現的最小流程：
用戶輸入：公曆 1985-04-12 14:30，男
→ 真太陽時校正
→ 八字排盤（主系統）
→ 紫微斗數排盤（交叉參照）
→ 生成報告（一生綜合 / 大運 / 年度）
→ 輸出 PDF
引用古籍時，報告會給出所引典籍與原文段落，便於用戶自行覈對。
適用場景與注意¶
適合的場景：需要把八字與紫微排盤、曆法換算、古籍引用、PDF 排版一次性做完的開發者；做個人命理類報告工具；做傳統文化研究資料整理。
需要注意的點：
- 內容定位是傳統文化研究與個人參考，不是醫療、投資或其他決策依據。
- 農曆換算與節氣數據依賴內置的 1900—2100 年曆法庫，範圍外的日期需要另行處理。
- 八字與紫微結論可能不一致，Skill 的設計是交叉參照，使用者需要理解兩者的口徑差異。
- 古籍引用來自內置全文庫，覈對原文時建議以原書爲準。
- 社區來源的 Skill 維護節奏依賴發佈者，遇到問題優先到 SkillHub 頁面反饋。
結尾¶
命理參鑑的價值在於把命理報告裏最容易出錯的幾件事——曆法數據、真太陽時、古籍出處、PDF 輸出——統一到一套可追溯的流程裏，並且主次分明（八字爲主、紫微爲輔），而不是給一堆互不相干的排盤結果。如果你的需求落在排八字、排紫微、大運分析、年度報告或古籍引用這幾類，可以直接使用。
官方地址：https://api.skillhub.cn/user_4c01d36b/mingli-canjian
