前言¶

做命理类 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 链接。