前言¶
给实际业务加一个「看日子」的功能时,常见的做法是:要么让模型凭训练记忆随口报几个日子,要么接一个第三方黄历接口再自己解析返回值。前者每次都不确定,后者把查询强依赖在某家服务上,而且返回结构往往不完整。
「择吉日」这个 Skill 解决的是前一种不确定性:把择日规则固化成代码,输入事项、福主信息和时间区间,输出候选吉日清单与择吉文书。计算全部在本地完成,不联网。
这是什么¶
「择吉日」是一个社区来源的民俗择日技能,坐标 @user_cc296e0f/zejiri,分类 life-service,当前版本 1.0.3,在 SkillHub 平台的评分为 100000、下载 930 次。
它面向需要把「择日」能力嵌入对话式产品的开发者:用户不会自己去查《协纪辨方书》,他们只会问「下个月哪天适合搬家」。这个 Skill 把这件事变成一个有确定输出的调用。
核心功能¶
已核实的能力来自官方简介与使用说明,主要包括:
1、事项覆盖:婚嫁、入宅、开业、动土、安葬、祭祀、出行、签约等事项,均可作为查询输入。
2、正统七步流程:按《协纪辨方书》的正统七步流程推算,同时提供面向普通人的简易黄历流程(口语化找日子的场景)。
3、干支与建除计算:基于 lunar-python 计算公历/农历、四柱干支、十二建除。
4、黄道与神煞:推算黄道黑道、冲煞、宜忌、吉神凶煞。
5、固定凶日:内置杨公忌、三娘煞、十恶大败、四离四绝等固定凶日校验。
6、吉时:在候选吉日中进一步给出当日吉时。
7、坐山方位校验:动土、安葬会额外校验年三煞、太岁、岁破等坐山方位信息。
8、多层筛选与排序:把上述条件作为筛选层,对候选吉日打分并排序输出。
9、择吉文书:结果除了候选清单(干支/建除/宜忌/吉时),还包含一份可直接交付的择吉文书。
官方同时声明:全程本地计算、无需联网;属于民俗文化参考属性,不是宿命定论,也不构成法律、医疗或投资意见。
安装与启用¶
官方地址:https://api.skillhub.cn/user_cc296e0f/zejiri
SkillHub 页面:https://www.skillhub.cn/skills/user_cc296e0f/zejiri
资料中未给出具体的安装命令、目录路径或配置文件字段。该 Skill 不要求 API Key(标签 requires_api_key=false),因此启用时不需要准备密钥,但具体如何挂载到 Cursor、Codex CLI 或 Claude Code,素材中没有覆盖,这里不做推测。
典型用法¶
按照官方使用说明,调用前需要提供三部分信息:
1、事项:例如婚嫁、入宅、开业、动土、安葬、祭祀、出行、签约。
2、福主信息:福主生肖或生辰。
3、可用时间区间:希望命中的日期范围。
部分事项(动土、安葬一类涉及坐山朝向)需要额外提供朝向信息。
触发词包括:择日、算日子、择吉、选黄道吉日、看黄历、挑日子,以及婚嫁择日、嫁娶选日子、入宅择日、搬家选日子、开业择日、开市择日、动土择日、开工择日、安葬择日、下葬择日、祭祀择日、出行择日、签约择日、查宜忌。
返回结果的结构固定为两块:候选吉日清单,每条含干支、建除、宜忌、吉时;以及一份可交付的择吉文书。
适用场景与注意¶
适合的场景:需要把择日作为对话式功能的设计者或产品方,尤其是面向婚庆、入宅、开业等民俗场景的助手类产品。计算在本地完成、没有外部网络依赖,这一点在离线或数据合规敏感的环境里是实打实的优势。
需要留意的地方:
1、民俗参考边界。输出是民俗文化参考,不是决策依据。如果产品面向严肃用途(如法律文书、医疗安排),需要在产品侧做明确提示。
2、信息不足时的可用性。缺少福主生肖或生辰时,筛选层会少掉一部分条件;官方说明未说明此类缺省如何兜底,接入前建议先验证空值表现。
3、坐山朝向类事项。动土、安葬等涉及坐山方位,资料建议「部分事项需坐山朝向」,这类事项的输入字段比日常查询更重,产品侧要提前设计好怎么收集朝向。
4、安装路径缺失。目前未能从官方渠道核实到具体安装命令和配置字段,接入前建议直接联系发布者或查阅官方仓库。
结语¶
「择吉日」的价值不在「算得准」,而在把算计日子这件事变成一个规则明确、输出结构固定、不依赖外部网络的调用。对做民俗场景助手的开发者来说,它是一个可以直接对接的占位方案;对需要更高权威性的场景,仍需在产品层面加提示。
官方地址:https://api.skillhub.cn/user_cc296e0f/zejiri