前言¶
在应用里做中国传统命理内容,常见做法是调一个排盘接口,拿到四柱结果再自己拼一段文字。问题在于:真太阳时要自己算、隐藏干支与十神要自己推、旺衰喜忌的判断口径各家不一,最后输出格式也随模型发挥,用户拿到的是一段聊天记录,不是一份能保存、能分享的文档。
下面介绍的 Skill「八字命盘心理学」(@user_cff04dbb/mingpan)把这套流程固化成一个可复用的技能:输入出生日期时间、时区、经纬度,输出排盘结果和一份以心理学视角撰写的分析报告,默认交付为独立 HTML 文档。
这是什么¶
一句话定位:把「出生信息 → 八字排盘 → 命理结构解析 → 心理取向解读 → HTML 报告」串成一条固定链路的 Agent Skill。
出品与维护:由社区作者 user_cff04dbb 发布,分类 education,来源标注为 community,当前版本 1.0.1,坐标 @user_cff04dbb/mingpan。它遵循通用 SKILL.md 格式,需要在支持该格式的 Agent 环境里启用。
它解决的问题有三层:
- 排盘准确性:把真太阳时修正、节气切分这类容易出错的环节交给 Skill,而不是让模型凭记忆推算。
- 结构完整性:四柱、藏干、十神、五行、纳音、空亡、十二长生、大运流年这些模块一次给全,避免每次输出缺项。
- 交付形态统一:默认产出单文件 HTML,用户直接在浏览器打开阅读,不依赖对话上下文。
核心功能¶
以下能力均来自官方简介,逐条对应:
- 输入 birth date-time、timezone、latitude、longitude,生成完整八字(四柱)命盘。
- 真太阳时校正(true solar time adjustment)。
- 结构化的四柱(structured pillars)、地支藏干(hidden stems)、十神(ten gods)、五行(five elements)、纳音(Na Yin)。
- 空亡(void branches)、十二长生/十二运(twelve growth phases)。
- 大运(luck cycles)与流年(annual flows)。
- 五行旺衰与用神喜忌的判定,作为心理解读的结构依据。
- 心理取向的解读,覆盖人格动力(personality dynamics)、动机(motivation)、压力模式(stress patterns)、关系模式(relationship style)、职业适配(career fit)、成长功课(growth work)与可执行建议(practical recommendations)。
- 默认输出为排版完成的独立 HTML 文档。
关于资源占用:requires_api_key=false,即不需要额外配置 API Key。
触发方式¶
Skill 自带触发词。当用户提到下列任一说法时应当启用:
- 命盘、八字排盘、四柱
- 真太阳时
- 大运流年
- 五行旺衰、用神喜忌
- 心理分析报告、性格分析
- HTML 报告
- 「问真」式的出生盘与解读(问真-like birth chart and reading)
安装与启用¶
官方页面的安装命令在抓取资料中没有给出,因此这里不杜撰具体命令。通用做法是按 SKILL.md 约定把技能目录放进 Agent 的技能目录,然后在对话中按上面触发词调用。
# 示例:将技能目录放到本地 Agent 的技能目录下(路径以你的环境为准)
ls ~/.agent/skills/
# 确认技能已被识别(命令名称按你的 Agent 实现而定)
agent skills list
需要说明的两点:
- 该 Skill 属于社区来源(
community),安装前建议先读一遍技能文件,确认它要求的输入字段和输出格式与你的产品一致。 - 是否需要 API Key:资料标注
requires_api_key=false,即不需要。
各 Agent 的差异:Cursor、Codex CLI、Claude Code 对 SKILL.md 的放置位置和加载方式不完全相同,抓取资料中没有给出对应说明,此处不分别展开。请以官方页面或本地 Agent 文档为准。
典型用法¶
下面是一个可复现的输入示例。资料中没有提供官方的完整示例输出,因此这里只给出输入侧的调用形式,输出侧按官方简介描述的能力核对。
用户提供:
出生时间:1990-06-15 14:30
时区:Asia/Shanghai
纬度:31.23
经度:121.47
Skill 的处理链路:
- 依据经纬度做真太阳时校正,得到用于排盘的实际时刻。
- 排出年、月、日、时四柱,并补齐地支藏干、十神、五行、纳音、空亡、十二长生。
- 排大运与流年。
- 判断五行旺衰与用神喜忌。
- 基于上述结构撰写心理取向解读,覆盖人格动力、动机、压力模式、关系模式、职业适配、成长功课与实用建议。
- 生成独立 HTML 文档,供用户直接阅读。
适用场景与注意¶
适合谁:
- 需要把八字排盘能力嵌入产品的开发者,尤其是希望输出形式统一为 HTML 的。
- 做内容类应用、希望把命理结构转写成人格与职业分析文本的团队。
- 不想自己实现真太阳时、藏干、十神、纳音等计算逻辑的场景。
限制与坑:
- 输入必须包含完整的出生日期时间、时区与经纬度。缺少经纬度会影响真太阳时校正的精度;只有日期没有时间则无法定时柱。
- 心理解读部分建立在命理结构之上,属于解释性内容,不构成医学或临床心理学诊断。产品中对外呈现时应做相应说明,避免被理解为专业心理评估。
- 大运、流年的起算与排法在不同流派间存在差异,Skill 内部采用的口径需要以技能文件为准;如果产品已有既定口径,需要先比对再上线。
- 该 Skill 为社区来源,当前资料显示安装量为 0、评分 100000、下载 1304,说明使用者基数很小,上线前建议自行做一轮端到端验证。
小结¶
「八字命盘心理学」的价值在于把排盘计算、结构解析和心理化解读打包成一个固定输出,默认交付 HTML,省掉了自建排盘逻辑和排版的工作量。适合需要稳定交付形态的八字/命理类应用;接入前需要核对流派口径,并对解读内容做必要的定位说明。
官方地址:https://api.skillhub.cn/user_cff04dbb/mingpan
SkillHub 页面:https://www.skillhub.cn/skills/user_cff04dbb/mingpan