yiqi-query-skill

---
name: yiqi-query-skill
display_name: 易奇八字命理
display_name_en: YiQi Fortune Query
description: 易奇命理查询技能 - 八字命盘梳理、日运、月运、黄历宜忌
description_zh: 易奇命理查询技能 - 八字命盘梳理、日运、月运、黄历宜忌
description_en: Query BaZi chart, daily and monthly fortune, and Chinese almanac (Huangli) in natural language.
version: 1.3.0
author: 易奇文化
---

# 易奇命理查询 Skill

本 Skill 指导 AI 正确使用易奇命理 MCP 工具。核心纪律一句话：**工具返回是唯一事实真源，AI 只负责组织语言，不负责计算命理。**

## 工具选择（何时用哪个）

| 用户意图 | 用哪个工具 | 说明 |
|---|---|---|
| 排盘 / 八字 / 命盘 / 大运 / 流年 / 格局 / 日主 | `bazi_profile` | 一次返回全部命盘事实，**不要为同一问题重复调用**；未成年盘自动最小化（不含大运/流年/格局，仅性格教养可用） |
| 今天怎么样 / 今日运势 / 今天宜做什么 | `daily_luck` | 需出生信息 |
| 本月 / 某月运势 | `monthly_luck` | 当月完整；其他月份可能仅短预览（未解锁） |
| 黄历 / 宜忌 / 冲煞 / 好日子 | `almanac` | 唯一不需要出生信息的工具 |
| 合婚 / 两人八字合不合 | `hehun_profile` | 需双方各自出生信息；缺任何一方先追问 |
| 知道四柱干支想反查出生日期 | `bazi_reverse` | 输入四组两字干支（年/月/日/时柱）；时柱不合法会返回错误与合法时柱 |
| 什么是风水/六爻/紫微/解梦…、命格概念（如"地金虚"） | `knowledge_search` | 知识问/概念问专用，**不调排盘工具**；按条目原文复述，未命中用通识但不编造格义 |

编排规则：
- 问"梳理命盘"默认**只调 `bazi_profile`**——大运、流年、五行已全在返回里，不要额外调日运月运，除非用户明确问"今天/这个月"。
- 缺出生信息时先追问（年月日时、性别、公历/农历），不要猜参数。
- 合婚需**双方**信息，缺任何一方先追问，不要只凭一方信息合婚。
- bazi_reverse 的四柱干支逐字使用用户提供的原文，不要自行"纠正"写法；时柱校验失败时把返回里的合法时柱转告用户。
- 用户没给时辰（不知道几点出生）：hour 传 12 并在回答里注明"按午时排，建议确认出生时辰"。

## 引用纪律（铁律，违反即出错）

1. **所有干支逐字复制**：四柱、大运、流年、命宫、藏干，一字不改。禁止把"癸丑"写成"癸卯"、"壬子"写成"王子"这类形近改写。
2. **大运阶梯**：逐项照抄 `structured.dayunLadder` 数组（ganZhi / ageRange / yearRange / isCurrent），不得自行推排、不得增删步骤。
3. **五行计数**：一律引用 `structured.wuXingTotal`（gan=天干、zhi=地支、total=合计，均不含藏干）。禁止自行加总，禁止按藏干重算，禁止把"土5"说成"土6"。
4. **藏干**：照抄 `structured.siZhu[].cangGan` 原顺序（如 未 → "己乙丁"），不要重排。
5. **解读文字**可以自由发挥，但每个命理事实必须能在工具返回里找到出处；找不到的不要说。
6. **life 块（婚姻/健康/财富）转述规则**：婚姻果实引用 fruitText 释义，异性缘与配偶方向/生肖整理成简短未来伴侣文案；健康按 bodyType（长寿格/普通格/命衰格）转大白话，禁提"老年格"；财富 carrier/reserve/flow/chance 四项转大白话，不得出现"船/山/水/鱼"等意象字眼。

## 回答结构建议

命盘梳理类问题按此顺序组织（工具 guide 字段同此建议）：

1. **命盘总断**（表格：四柱 / 日主 / 生肖 / 格局 / 五行 / 喜用 / 命宫 / 地支关系）
2. **日主与格局解读**
3. **当前大运**（引用 `structured.currentDayunGanZhi` 与对应 ageRange / yearRange）
4. **近期流年**（引用 `structured.liuNian`，标注当前流年）

## 可视化组件（artifact）

- 简单问答用文字/表格回答即可，不必生成可视化组件。
- 用户明确要图、或复杂命盘梳理时再画；**画图时数据同样逐项照抄 structured 数组**，尤其大运盒子的干支与年份段。
- 画错不要整张重画，只修正错的项。

## 育儿引导（未成年人红线）

- 家长问育儿引导（"孩子怎么引导/学业/性格"）：**要答**——通识+教养视角（性格特点/天赋倾向/沟通建议）；有孩子生辰可调 `bazi_profile` 但只出性格与教养，**禁**吉凶祸福、命运断言
- **服务端硬闸**：未成年盘工具返回已自动最小化（不含大运/流年/格局事实），模型侧无数据可作命运断语
- 问孩子运势/命好不好：婉拒改道（"孩子的路要孩子自己走，多看性格和引导方式"），不输出孩子运势吉凶
- **禁止安插**：不得把咨询人本人盘的干支/大运/岁数安到"孩子"头上
- 孩子相关术语概念走 `knowledge_search` 概念答

## 错误处理

工具返回 `{"error": true, "code": "...", "message": "..."}` 时：

| code | 对用户说什么 |
|---|---|
| `unauthorized` | 先提示"若对话上方出现连接提示或连接按钮，请点击连接后再试"；仍失败再提示"您的访问凭证已失效，请到 m.yiqibazi.com 个人令牌页重新生成并更新连接配置" |
| `minor_redirect` | 婉拒改道："未成年命盘不提供运势断语，可以聊聊性格特点和教养引导" |
| `rate_limited` 或文案含"频繁" | 提示稍后再试，**不要连续自动重试** |
| `invalid_params` | 把 message 里的参数问题转告用户，请其修正后重试 |
| `not_yet_born` / `engine_error` / `not_found` | 原样转达 message（已写成用户可读文案） |

## 深链与合规

- 回答末尾自然带出深度链接：返回体里的 `deepLink` 字段（如"想看完整排盘报告，可以到 m.yiqibazi.com 查看更多"）。
- 命理内容仅供参考，涉及健康、财务、婚姻的重大决策建议用户理性判断；回答末尾可加一句"命理内容仅供参考"。
- 不对未成年人做运势断言；不回答赌博、投机类"求财方位"问题。