前言¶
用戶在對話裏給出出生時間、性別，並提到排盤、八字、大運或流年時，Agent 需要一套可復現的歷法與排盤規則，而不是憑模型記憶拼湊干支。自己從零實現真太陽時、節氣與十神等細節，工作量大，也容易和常見排盤口徑不一致。下面介紹 SkillHub 上的社區 Skill「八字排盤」，把輸入約束和輸出項寫進 SKILL.md，由 Agent 在合適場景下調用。
這是什麼¶
「八字排盤」是 SkillHub 座標 @user_1854b633/bazi-paipan 下的 life-service 類 Skill，當前版本 2.1.0，來源爲 community，發佈者爲 user_1854b633。頁面標註 requires_api_key=false，安裝後不需要額外 API Key。
它根據出生時間、出生地、性別做八字排盤，並說明支持真太陽時修正與 VSOP87 節氣算法，且無需第三方依賴（以官方簡介爲準）。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_1854b633/bazi-paipan
- API 座標頁：https://api.skillhub.cn/user_1854b633/bazi-paipan
核心功能¶
以下能力均來自官方簡介，未在資料中出現的細節不展開。
輸入
- 出生時間
- 出生地（用於真太陽時等地域相關修正）
- 性別（排盤規則中會用到）
輸出
- 四柱干支
- 藏幹、十神、十二長生
- 空亡、納音
- 五行統計
- 刑衝合害、神煞
- 大運（10 步）
- 流年分析（可指定年份）
觸發場景（Skill 自述）
當用戶提供出生時間與性別，並要求算命、排盤、八字、命盤、大運、流年或神煞分析時，Agent 應啓用該 Skill。
安裝與啓用¶
SkillHub 頁面給出的安裝方式是：先按官方安裝文檔配置環境，再安裝本 Skill 座標。
1. 安裝 SkillHub CLI（若尚未安裝）
文檔地址：https://skillhub.cn/install/skillhub.md
檢查是否已安裝：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝「八字排盤」到當前 Agent 的 skills 目錄
安裝時必須使用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被 Agent 加載。常見路徑如下（摘自 SkillHub 安裝文檔）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
以 Cursor 爲例：
skillhub install user_1854b633/bazi-paipan --dir ~/.cursor/skills/
頁面亦支持將下面這句提示詞發給 AI，由 Agent 按 https://skillhub.cn/install/skillhub.md 完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_1854b633/bazi-paipan`。
安裝或更新 Skill 後，按你所用客戶端的要求重啓或刷新 Agent，使 SKILL.md 生效。
典型用法¶
公開資料未附帶固定 CLI 子命令示例；用法體現在 Skill 定義的觸發條件與輸入字段上。對話中可以按下面方式組織信息，便於 Agent 命中該 Skill：
- 提供公曆或農曆的出生日期與時間（儘量精確到時辰，並說明是否已含夏令時等特殊情況）。
- 說明出生地（城市或經緯度級信息，以 Skill 內說明爲準）。
- 說明性別。
- 寫明需求：例如「排四柱」「看大運十步」「分析某年流年」或「神煞、刑衝合害」等。
Agent 讀取 SKILL.md 後，應按 Skill 內腳本或流程輸出簡介中列出的各欄位；若需指定流年年份，在問題裏直接寫出目標年份即可（官方簡介支持可指定年份的流年分析）。
適用場景與注意¶
適合誰
- 希望在 Cursor、Claude Code、Codex 等支持 Skills 的 Agent 裏，用統一規則做八字排盤與大運、流年解讀的開發者或產品搭建者。
- 不想爲排盤單獨接第三方付費 API，且接受社區 Skill 維護節奏的場景（本 Skill 標註無需 API Key）。
使用上需注意
- 排盤與命理解讀屬於傳統文化範疇，輸出僅供參考，不宜當作醫療、投資等決策依據。
- 出生地與時區、真太陽時修正會直接影響四柱邊界，用戶輸入應儘量完整、一致。
- 社區來源（community）意味着版本與行爲以 SkillHub 上 2.1.0 及後續更新爲準；升級前可在 SkillHub 頁面查看變更說明。
- SkillHub 頁面展示的評分爲 100000，下載 13731 次、安裝 5 次（抓取時點數據，以後臺頁面爲準）。
結尾¶
「八字排盤」把出生時間、地點、性別與一整套傳統命盤要素（含 VSOP87 節氣與真太陽時修正）封裝成 Agent Skill，適合在用戶主動提出排盤、大運、流年等需求時啓用。安裝走 SkillHub 標準流程，座標爲 @user_1854b633/bazi-paipan。詳情與安裝提示見：https://www.skillhub.cn/skills/user_1854b633/bazi-paipan
