前言¶
做命理類 Agent 應用時，常見的痛點是：十二個體系散落在不同腳本里，農曆干支、時區校正、排盤算法各自爲政，維護成本高；解釋文本缺出處、異文混雜，很難對用戶負責。下面介紹的 Skill 試圖用「引擎 + 知識資產 + 自檢」的方式把這件事收斂到一套裏。
這是什麼¶
一句話定位：覆蓋十二命理體系的知識與執行引擎，把農曆干支、排盤、釋義、產品化流程和安全邊界打包成可調用的 Skill。
由長沙探奇玩新科技有限公司發佈，來源標記爲 enterprise，當前版本 3.4.6，在 SkillHub 上座標 @org-be4i17hs/mingli-assistant。定位是傳統文化科普與娛樂參考，不承擔醫療、投資、法律等實際決策職責。
核心功能¶
引擎驅動¶
核心計算由 mingli_core.py 承擔：農曆干支四柱、十神、稱骨、建除宜忌、平太陽時校正、子時換日雙口徑、每日幸運映射。其中平太陽時校正內置 1986-1991 夏令時扣回邏輯與 39 城經度表，子時換日提供雙口徑切換。
深域計算（周易 64 卦五模式起卦、變卦互卦體用，紫微排盤，六爻納甲，九宮飛星年月盤）不由本地腳本完成，而是由服務器同源引擎按次計算並返回結構化結果。本地免費域不包含深域，需要服務端另行驗收。
知識資產落盤¶
稱骨歌 52 檔男女命全量、星座日期表、塔羅 78 張正逆位牌義、生肖釋義均隨包落盤，本地免費域即可用。雲端調用可配合紫微星曜釋義與十神釋義等擴展內容。釋義要求有出處、異文有標註，缺失傳統文本時如實說明，不杜撰。
內置自檢¶
selftest.py 提供一鍵自檢。當次實測 66 項，本地免費域 66 項全部通過；其中包含第三方排盤庫黃金用例與 384 例六爻納甲全量對拍。深域（周易/紫微/六爻/飛星）未隨包分發，需服務端另行驗收。
產品化機制¶
Skill 內置了一整套面向用戶的流程組件，便於直接複用：
- 資料完整度按 S/A/B/C 分級，並生成資料引導卡，提示用戶補全生辰等信息。
- 手相面相照片解讀分三步走，避免一次性全量輸出。
- 起名採用結構化問卷，按步驟收集姓氏、輩分、忌諱等字段。
- 體系分流菜單，讓用戶在八字、紫微、六爻等入口間選擇。
- 時間節奏層，控制單次輸出的信息量與節奏。
- 語氣三檔，可按場景切換。
- HTML 玄學報告與今日運勢單卡片兩種成品格式。
- 排盤截圖轉錄復算流：用戶上傳排盤截圖時，先轉錄再復算校驗。
- 時辰倒推（可選），缺時辰時按可用信息反推。
- 會話內生辰複用，同一會話內已錄入的生辰不重複索取。
- 出解前質檢清單，輸出前逐項覈對。
安全邊界¶
安全機制內置在輸出流程中，不是事後補丁：
- 理性結尾爲硬性要求，所有解讀末尾必須帶理性提示。
- 禁止恐嚇式營銷話術。
- 不做疾病、壽命斷言。
- 危機轉介與心理援助熱線在識別到風險信號時觸發。
- 未經本人同意，不爲其占卜（即不代他人問卜）。
- 紅線話題（重病/官司/投資標的/壽元）只做引導，不下斷語。
安裝與啓用¶
Skill 託管在 SkillHub 上，座標 @org-be4i17hs/mingli-assistant，官方地址：
https://api.skillhub.cn/org-be4i17hs/mingli-assistant
SkillHub 頁面：
https://www.skillhub.cn/skills/org-be4i17hs/mingli-assistant
標籤信息：pricing_type=paid，requires_api_key=false。按 SkillHub 通用流程，通過其平臺安裝該 Skill 後，在支持 SKILL.md 格式的 Agent 環境（如 Claude Code、Cursor、Codex CLI）中即可按 Skill 名稱調用。具體安裝命令以 SkillHub 頁面當前展示爲準，此處不替官方寫命令。
典型用法¶
以下用法來自 Skill 的設計結構，非虛構案例：
1、用戶輸入生辰信息後，mingli_core.py 完成農曆干支四柱計算，平太陽時校正會按內置經度表與夏令時規則處理 1986-1991 年區間。
2、調用稱骨時，引擎從落盤的稱骨歌 52 檔男女命全量表中取檔，釋義按性別與四柱結果匹配。
3、用戶選擇紫微排盤後，請求發往服務器同源引擎，返回結構化結果；本地免費域不覆蓋此路徑。
4、用戶上傳手相照片後，按三步流程逐段解讀，每步輸出前經過出解前質檢清單。
5、用戶問及重病、官司、投資標的或壽元時，Skill 只做引導，輸出理性提示，不下斷語。
適用場景與注意¶
適合誰：需要快速搭建命理科普類 Agent、又不想從零實現干支與排盤算法的開發者；需要一套帶安全邊界和產品化流程的模板的團隊。
需要注意的點：
- 深域（周易/紫微/六爻/飛星）不在本地免費域，需服務端另行驗收，部署前要確認服務端能力。
- 平太陽時校正的經度表覆蓋 39 城，不在這 39 城範圍內的地區精度會下降。
- 1986-1991 夏令時規則只覆蓋這段時間，其他年份的夏令時處理不在此列。
- Skill 定位是傳統文化科普與娛樂參考，不適合用於醫療、投資、法律等實際決策場景。
- 釋義文本有出處標註要求，接入後若自行擴展釋義，需沿用同樣的出處與異文標註規範。
- 平臺評分與下載量爲抓取時點數據（抓取時顯示評分 100000、下載 1486，分類 life-service），接入前建議到 SkillHub 頁面複覈當前數值。
結尾¶
這個 Skill 的價值在於把命理應用裏最繁瑣的兩件事——算法引擎和知識文本——做了分層處理：本地域覆蓋基礎計算與落盤釋義，深域走服務端同源引擎，產品化和安全邊界作爲內置流程，省去了從零搭建的成本。官方地址見上文 SkillHub 鏈接。
