前言¶
做命理类应用时，开发者最头疼的不是算法本身，而是几件事的叠加：历法数据（万年历、节气、真太阳时）不准，排盘结果无法解释出处，古籍引用查无来源，最后输出一份报告还要自己排版生成 PDF。命理参鉴（@user_4c01d36b/mingli-canjian）就是针对这一串痛点给出的技能方案：以八字为主系统，紫微斗数做交叉参照，内置 1900—2100 年的历法与节气参考、真太阳时校正以及传统命理典籍全文库，输入公历或农历出生信息，输出可追溯的命理报告并生成可下载 PDF。
下面介绍这个 Skill 的定位、能力、安装启用方式、典型用法和适用边界。
这是什么¶
命理参鉴是一个面向开发者的 Agent Skill，坐标 @user_4c01d36b/mingli-canjian，版本 1.0.0，由社区开发者 user_4c01d36b 发布，来源标记为 community，分类为 professional。它解决的是这样一类需求：用户给出生日期（公历或农历）和出生时间，需要一份结构完整、口径统一、能引用古籍的命理报告，而不是零散的排盘结果。
按官方说明，报告内容仅用于传统文化研究与个人参考，这是使用前提，不是免责声明式套话。
核心功能¶
- 八字为主系统：先做四柱排盘，作为报告的核心框架。
- 紫微斗数交叉参照：在主断之后用紫微盘做交叉校验，用于解释不一致或补充视角，而不是另起一套独立结论。
- 历法与节气参考：内置 1900—2100 年万年历与节气数据，覆盖跨世纪出生日期的换算与节气定位。
- 真太阳时校正：对出生时间做真太阳时修正，这是八字排盘里容易被忽略但会影响时辰判定的环节。
- 古籍全文库：内置传统命理典籍全文，报告结论可以回溯到原文出处。
- 报告生成与 PDF 输出：支持三类报告——一生综合报告、逐步大运分析、年度命理报告，并输出可下载的 PDF 文件。
三个报告类型对应的输入和口径是统一的：公历或农历出生信息均可，报告内部口径以八字为主、紫微为辅。
安装与启用¶
按 SkillHub 页面信息，该 Skill 标签为 requires_api_key=false，即不需要 API Key 即可使用。社区来源（community）与 professional 分类意味着它面向有 Skill 使用经验的开发者，通常通过 SkillHub 页面安装或在支持 Skill 的 Agent 环境中按坐标引用。
安装方式以官方页面为准：
官方地址：https://api.skillhub.cn/user_4c01d36b/mingli-canjian
SkillHub 页面：https://www.skillhub.cn/skills/user_4c01d36b/mingli-canjian
坐标：@user_4c01d36b/mingli-canjian
需要说明的是，本次抓取的资料中没有列出具体安装命令、目录路径或配置文件字段，因此这里不给出未经核实的命令。该 Skill 基于通用 SKILL.md 格式，启用方式与所用 Agent 环境（Cursor、Codex CLI、Claude Code 等）相关，差异请以官方页面说明为准。
典型用法¶
使用入口是用户的自然语言请求，以下几类请求会触发该 Skill：
- 排八字：用户给出出生信息，Skill 先做真太阳时校正，再排出四柱。
- 排紫微斗数：作为交叉参照，与八字结论互相校验。
- 分析一生或逐步大运：输出一生综合报告或按大运逐步展开。
- 生成年度命理报告：针对某一年给出年度口径的报告。
- 引用命理古籍：需要把结论落到典籍原文时，从内置全文库检索并标注出处。
- 生成可下载 PDF：报告完成后输出 PDF 文件。
一个可复现的最小流程：
用户输入：公历 1985-04-12 14:30，男
→ 真太阳时校正
→ 八字排盘（主系统）
→ 紫微斗数排盘（交叉参照）
→ 生成报告（一生综合 / 大运 / 年度）
→ 输出 PDF
引用古籍时，报告会给出所引典籍与原文段落，便于用户自行核对。
适用场景与注意¶
适合的场景：需要把八字与紫微排盘、历法换算、古籍引用、PDF 排版一次性做完的开发者；做个人命理类报告工具；做传统文化研究资料整理。
需要注意的点：
- 内容定位是传统文化研究与个人参考，不是医疗、投资或其他决策依据。
- 农历换算与节气数据依赖内置的 1900—2100 年历法库，范围外的日期需要另行处理。
- 八字与紫微结论可能不一致，Skill 的设计是交叉参照，使用者需要理解两者的口径差异。
- 古籍引用来自内置全文库，核对原文时建议以原书为准。
- 社区来源的 Skill 维护节奏依赖发布者，遇到问题优先到 SkillHub 页面反馈。
结尾¶
命理参鉴的价值在于把命理报告里最容易出错的几件事——历法数据、真太阳时、古籍出处、PDF 输出——统一到一套可追溯的流程里，并且主次分明（八字为主、紫微为辅），而不是给一堆互不相干的排盘结果。如果你的需求落在排八字、排紫微、大运分析、年度报告或古籍引用这几类，可以直接使用。
官方地址：https://api.skillhub.cn/user_4c01d36b/mingli-canjian
