技能介绍

要解决什么问题

命理报告若只靠模型「凭感觉」写格局、宫位和断语，读者无法核对依据，公历农历边界、真太阳时和换日规则也极易出错。本技能面向可复核的个人阅读版 PDF：每次从当次输入重新排盘，八字与紫微两套系统独立计算，合参时只标注一致与差异，不强行统一结论。

技能如何工作

输入必须覆盖性别、公历或农历（含闰月）、出生年月日时分、时间可信度 以及报告类型（lifetime、annual 或 both）。尽量收集出生地；有地点无经度时先查经度，无法确认则按民用钟表时间排盘并在报告中说明。境外出生需确认当地 UTC 时差与夏令时还原口径。

固定流程包括：校验历法往返（references/calendar/validation.json 须零失败）、书籍清单与质量、生成出生信息 JSON、运行 scripts/generate_report.py（年度报告以香港天文台响应时间换算的北京时间为准，网络异常时停止而非用本机日期绕过）、核对 report-result.json 后渲染 PDF。知识检索通过 scripts/search_knowledge.py；上传版正文在 references/books/library.b85.txt，须经检索脚本解码，不得把编码正文直接交给用户。八字结论优先《滴天髓》《穷通宝鉴》《子平真诠》等核心典籍；紫微优先两版《紫微斗数全书》；引用须带文件名与页码或 EPUB 章节，风水、奇门、六壬等不得替代主判断。

判断顺序上，八字走历法边界 → 月令 → 透干 → 根气 → 格局与用神链；紫微走命身宫 → 五行局 → 主辅星 → 四化 → 三方四正与大限流年。一生报告需逐步写清各步大运的起止年、十神作用及行动建议。

适用边界

报告属传统文化研究与个人参考，不构成医疗、投资、法律或重大决策建议；避免「必然」「一定富贵」类断言。交节附近、23 点换日、时辰边界、经度缺失或时间不确定时须在文中显著提示复核。修改历法、排盘或检索逻辑后应运行 scripts/self_check.py，覆盖男女、闰月、节气前后、境外时区等场景，而非单命盘验收。

截图预览

使用场景

客户提供了公历或农历出生时辰（含闰月与时间可信度），需要按本次输入重新排盘并交付一生、年度或双份独立 PDF。
维护本技能时改动了历法、八字引擎或 search_knowledge 检索逻辑，需要跑 self_check 覆盖男女、23 点换日与境外时区等回归用例。
撰写结构性断语前，要用 `search_knowledge.py` 在典籍库中检索滴天髓、子平真诠或紫微全书，并在报告末尾附录文件名与页码。
报告类型为 annual 或 both 时，须以香港天文台响应时间换算的北京日期为年度基准；网络或时间源异常时应中止生成。

适合人员

面向咨询交付的命理从业者，典型诉求是输出命主可翻阅、且关键结论能对照古籍出处的 PDF，而非聊天式断语。
维护 SkillHub 上 `@user_4c01d36b/mingli-canjian` 的打包者，需要保证 validation.json 零失败、书籍 manifest 无空文本且年度报告不绕过天文台时间。
系统学习子平与紫微、希望报告按「历法边界→格局→大限流年」顺序展开并标注两套系统差异的研究者。
出生经度或时辰可信度不足，但仍需要生成明确提示复核项、且不使用必然富贵类断言的个人参考读者。