前言¶

給實際業務加一個「看日子」的功能時，常見的做法是：要麼讓模型憑訓練記憶隨口報幾個日子，要麼接一個第三方黃曆接口再自己解析返回值。前者每次都不確定，後者把查詢強依賴在某家服務上，而且返回結構往往不完整。

「擇吉日」這個 Skill 解決的是前一種不確定性：把擇日規則固化成代碼，輸入事項、福主信息和時間區間，輸出候選吉日清單與擇吉文書。計算全部在本地完成，不聯網。

這是什麼¶

「擇吉日」是一個社區來源的民俗擇日技能，座標 @user_cc296e0f/zejiri，分類 life-service，當前版本 1.0.3，在 SkillHub 平臺的評分爲 100000、下載 930 次。

它面向需要把「擇日」能力嵌入對話式產品的開發者：用戶不會自己去查《協紀辨方書》，他們只會問「下個月哪天適合搬家」。這個 Skill 把這件事變成一個有確定輸出的調用。

核心功能¶

已覈實的能力來自官方簡介與使用說明，主要包括：

1、事項覆蓋：婚嫁、入宅、開業、動土、安葬、祭祀、出行、簽約等事項，均可作爲查詢輸入。
2、正統七步流程：按《協紀辨方書》的正統七步流程推算，同時提供面向普通人的簡易黃曆流程（口語化找日子的場景）。
3、干支與建除計算：基於 lunar-python 計算公曆／農曆、四柱干支、十二建除。
4、黃道與神煞：推算黃道黑道、衝煞、宜忌、吉神凶煞。
5、固定凶日：內置楊公忌、三娘煞、十惡大敗、四離四絕等固定凶日校驗。
6、吉時：在候選吉日中進一步給出當日吉時。
7、坐山方位校驗：動土、安葬會額外校驗年三煞、太歲、歲破等坐山方位信息。
8、多層篩選與排序：把上述條件作爲篩選層，對候選吉日打分並排序輸出。
9、擇吉文書：結果除了候選清單（干支／建除／宜忌／吉時），還包含一份可直接交付的擇吉文書。

官方同時聲明：全程本地計算、無需聯網；屬於民俗文化參考屬性，不是宿命定論，也不構成法律、醫療或投資意見。

安裝與啓用¶

官方地址：https://api.skillhub.cn/user_cc296e0f/zejiri
SkillHub 頁面：https://www.skillhub.cn/skills/user_cc296e0f/zejiri

資料中未給出具體的安裝命令、目錄路徑或配置文件字段。該 Skill 不要求 API Key（標籤 requires_api_key=false），因此啓用時不需要準備密鑰，但具體如何掛載到 Cursor、Codex CLI 或 Claude Code，素材中沒有覆蓋，這裏不做推測。

典型用法¶

按照官方使用說明，調用前需要提供三部分信息：

1、事項：例如婚嫁、入宅、開業、動土、安葬、祭祀、出行、簽約。
2、福主信息：福主生肖或生辰。
3、可用時間區間：希望命中的日期範圍。

部分事項（動土、安葬一類涉及坐山朝向）需要額外提供朝向信息。

觸發詞包括：擇日、算日子、擇吉、選黃道吉日、看黃曆、挑日子，以及婚嫁擇日、嫁娶選日子、入宅擇日、搬家選日子、開業擇日、開市擇日、動土擇日、開工擇日、安葬擇日、下葬擇日、祭祀擇日、出行擇日、簽約擇日、查宜忌。

返回結果的結構固定爲兩塊：候選吉日清單，每條含干支、建除、宜忌、吉時；以及一份可交付的擇吉文書。

適用場景與注意¶

適合的場景：需要把擇日作爲對話式功能的設計者或產品方，尤其是面向婚慶、入宅、開業等民俗場景的助手類產品。計算在本地完成、沒有外部網絡依賴，這一點在離線或數據合規敏感的環境裏是實打實的優勢。

需要留意的地方：

1、民俗參考邊界。輸出是民俗文化參考，不是決策依據。如果產品面向嚴肅用途（如法律文書、醫療安排），需要在產品側做明確提示。
2、信息不足時的可用性。缺少福主生肖或生辰時，篩選層會少掉一部分條件；官方說明未說明此類缺省如何兜底，接入前建議先驗證空值表現。
3、坐山朝向類事項。動土、安葬等涉及坐山方位，資料建議「部分事項需坐山朝向」，這類事項的輸入字段比日常查詢更重，產品側要提前設計好怎麼收集朝向。
4、安裝路徑缺失。目前未能從官方渠道覈實到具體安裝命令和配置字段，接入前建議直接聯繫發佈者或查閱官方倉庫。

結語¶

「擇吉日」的價值不在「算得準」，而在把算計日子這件事變成一個規則明確、輸出結構固定、不依賴外部網絡的調用。對做民俗場景助手的開發者來說，它是一個可以直接對接的佔位方案；對需要更高權威性的場景，仍需在產品層面加提示。

官方地址：https://api.skillhub.cn/user_cc296e0f/zejiri