技能介绍

要解决什么问题

八字排盘依赖公历/农历换算、早晚子时规则与性别等参数，手写或查表容易出错。若还要从四柱反推可能的公历时刻，或查某日黄历，通常要换多套工具。本技能把小笨羊八字 API封装成 MCP 工具链，由模型做意图路由与参数抽取，代码只负责带密钥调用接口并返回 result["raw"]。

技能如何工作

模型按固定流程：检查 API 密钥 → 选工具 → 补全参数 → 关键字参数调用 scripts.tools → 整理 raw 展示。

| 用户意图 | 工具 |
|---------|------|
| 按公历或农历时间 + 性别出盘 | getBaziDetail（solarDatetime 与 lunarDatetime 二选一） |
| 由八字反查公历时间列表 | getSolarTimes（四柱空格分隔，如 戊寅己未己卯辛未） |
| 指定公历日（默认今天）黄历 | getChineseCalendar |

getBaziDetail 必填 gender（0 女 / 1 男）；可选 eightCharProviderSect（1 或 2）控制 23:00–23:59 的日柱归属。参数不全时用 AskUserQuestion 向用户追问，禁止模型自行编造排盘结果。

适用边界与注意点

必须配置环境变量或经 scripts.config.set_api_key 写入的 XBYAPIKEY；无密钥时只能引导用户到 xiaobenyang.com 获取，不得缺密钥仍假装出盘。
技能描述中的「性格分析、命运预测」来自上游 API 能力边界；你侧应如实展示 API 返回，勿夸大或补写命理结论。
农历时间格式示例：2000-5-5 12:00:00；公历建议 ISO 如 2008-03-01T13:00:00+08:00。

使用场景

修族谱时家属只报农历生日与性别，需要在对话里调用 `getBaziDetail` 生成四柱再写入谱书记录。

手头只有空格分隔的四柱字符串、缺少公历出生时刻，需用 `getSolarTimes` 拉取候选时间列表供人工核对。

策划婚嫁、开张等民俗活动前，指定公历活动日，用 `getChineseCalendar` 查询当日黄历宜忌作安排参考。

出生时间在 23:00–23:59 的个案，需切换 `eightCharProviderSect` 分别出盘，对比日柱是否与手工盘一致。

适合人员

运营民俗或传统文化专栏、稿件里要写准四柱与黄历条目、不能手写换算的内容编辑

帮亲友整理家谱、要把口述农历生日转成可存档八字字段、并愿意配置 XBY_APIKEY 的记录者

在小笨羊 API 之上做命理类 Agent 原型、需要模型严格走路由与三工具而非编造数据的集成开发者

维护对话式玄学体验产品、需在无密钥时阻断排盘并引导用户去 xiaobenyang.com 取钥的技能运营

SkillHub

@org-rn88lg3j/ba-zi

八字计算器