qmen-wanwu

name	qmen_wanwu
description	万物类象/象意/取象/类象/意象 - Generate imagery portraits: scene/object/person descriptions from stem+star+gate+deity combinations

万物类象画像描述 (Wanwu Imagery Portrait)

基于奇门遁甲符号（天干、九星、八门、八神、十二长生）的万物类象数据，生成场景、物品或人物的画像式描述。 本技能是独立的创意描述工具，与性格分析（qmen_xingge）、问事局（qmen_event）等分析类技能不冲突。

Trigger

仅当用户明确要求基于奇门符号的画像/类象描述时激活本技能：

• "描述一个场景"、"画一个画面"、"想象一个场景"
• "描述一个物品"、"这是什么东西"、"这个组合像什么物品"
• "描述一个人"、"这个人什么样"、"画像"
• 用户指定了奇门符号组合并要求描述、联想、画面化
• "万物类象描述"、"取象描述"

不要在以下情况激活本技能：

• 用户问"这件事会怎样"等占断问题 → qmen_event
• 用户要做性格/婚恋/财官分析 → 对应 sub-skill
• 用户只说"奇门遁甲"未明确要做画像描述 → 使用 qmen_dunjia 路由 skill
• 用户用纯起局动词（"排局"、"起局"、"起一卦"、"算一卦"、"起局"）→ 必须让位给 qmen_dunjia 路由 skill

---

🔒 核心契约：脚本输出完整性

执行 bin/qimen*.sh 脚本时：

强制规则：

1. 脚本必须实际执行，禁止凭记忆模拟输出
2. stdout 一字不漏原样输出，放在代码块内
3. 完整输出在前，分析文字在后，顺序不可颠倒
4. 多个脚本各自独立输出，不合并

禁止行为（出现即违约）：

• 省略："..."、"（省略N行）"、"（其余类似）"、"（以下省略）"
• 概括："输出如下"、"主要内容"、"关键部分"、"摘要"
• 借口："为节省篇幅"、"由于输出较长"
• 包装：折叠标签、翻译代替原文、只展示首尾
• 抢跑：输出前插入任何分析性文字

自检： 每次脚本执行后，确认"输出是否完整无遗漏"。如有遗漏，立即补贴，不重新执行。 后果： 截断或概括的输出视为无效，整个分析必须基于完整数据重来。

---

🔒 万物类象数据约束（不可越过）

所有万物类象（天干、九星、八门、八神的类象描述）只能来自以下两个数据源：

1. 本地数据文件 data/wanwu_*.dat 中的实际字段值
2. 脚本输出 JSON 中 wanwu 字段的内容

严禁：

• 编造数据文件中不存在的类象内容
• 将某个天干/星/门/神的类象张冠李戴到另一个上
• 为了"符合现实情况"而凭空建立干门星神与具体事物的关联
• 使用"根据XXX推测"、"可以联想为"等话术绕过数据约束

验证方法：如果你要说"X代表Y"，必须能在 data/wanwu_*.dat 或 JSON wanwu 字段中找到这条对应关系。找不到就不说。

---

描述模式

三种模式，由用户自然语言触发：

模式	触发示例	描述重点
场景	"描述一个场景"、"画一个画面"	环境、氛围、光线、声音、空间感
物品	"描述一个物品"、"像什么东西"	形状、颜色、材质、大小、质感、性质、功能
人物	"描述一个人"、"这人什么样"	外貌、体型、穿着、气质、性格、行为举止

如果用户没有明确指定模式，询问用户想要哪种描述。

---

输入方式

两种输入方式，互斥：

方式A: 局面模式

用户已有排局JSON，指定宫位号。

# workdir: {SKILL_DIR}
bin/qimen_wanwu.sh --palace=N --input=./qmen_birth.json

如果用户没有指定输入文件，默认使用 ./qmen_birth.json。如果文件不存在，提示用户先起局。

方式B: 手工模式

用户直接给出符号，至少一个即可，缺的不参与描述。

# workdir: {SKILL_DIR}
bin/qimen_wanwu.sh --stem=丙 --star=天冲 --gate=伤门 --deity=九天 --state=帝旺

参数全部可选，至少提供一个。

---

执行流程

Step 1: 确认输入

1. 确认输入方式（局面/手工）和符号
2. 确认描述模式（场景/物品/人物）
3. 如果用户一句话说清楚了，不需要额外确认，直接执行

Step 2: 调用工具

执行 qimen_wanwu.sh，获取万物类象数据。脚本默认写入 ./qmen_wanwu.json。

⚠️ 遵守核心契约：一字不漏原样输出。

Step 3: 读取 JSON 数据

必须先完成 Step 2 的脚本执行，然后用 Read 工具读取 ./qmen_wanwu.json，逐字段确认每个符号的万物类象数据。

Read: {SKILL_DIR}/qmen_wanwu.json

强制约束：生成描述前，必须先读取 qmen_wanwu.json 并逐字段确认所有 wanwu 数据。禁止凭记忆或推测生成描述，所有描述元素必须来自 JSON 中的实际字段值。

Step 4: 生成描述

根据 JSON 中读取到的万物类象数据，按选定模式生成画像描述。

核心规则（基于 JSON 数据）

1. 每个符号在一次描述中只映射一个维度，不重复使用
   • 例如：天干映射颜色，九星映射形状，八门映射行为，八神映射气质
   • 具体哪个符号映射哪个维度，由AI根据万物类象数据灵活分配，选最贴切的
2. 十二长生参与但优先级最低，用于修饰整体状态/氛围/生命阶段
3. 所有描述元素必须来自 data/wanwu_*.dat 或 JSON wanwu 字段的实际数据，严禁编造不存在的类象
4. 描述必须符合基本逻辑关系，元素之间自然衔接

场景模式输出

一段完整的场景描述（200-400字），包含：

• 环境/空间（来自某个符号的场所环境/地理类象）
• 氛围/光线/色彩（来自某个符号的颜色/天象类象）
• 声音/动态（来自某个符号的事件行为类象）
• 人或物的存在感（来自某个符号的人物/器物类象）
• 整体状态（来自十二长生）

物品模式输出

一段物品描述（150-300字），包含：

• 形状/大小（来自某个符号的形态类象）
• 颜色/色泽（来自某个符号的颜色类象）
• 材质/质感（来自某个符号的器物/概念类象）
• 性质/功能/给人的感觉（来自某个符号的概念/性格类象）
• 状态/新旧/完好程度（来自十二长生）

人物模式输出

一段人物描述（200-400字），包含：

• 外貌/体型（来自某个符号的形态/体形类象）
• 肤色/面部特征（来自某个符号的颜色/身体类象）
• 穿着/气质（来自某个符号的概念/性格品质类象）
• 性格特点（来自某个符号的性格品质类象）
• 行为举止/动作习惯（来自某个符号的事件行为类象）
• 整体生命状态（来自十二长生）

输出结尾：符号-维度对照表

每次描述后，附上对照表，说明每个符号贡献了哪个元素：

丙 → 颜色(红/明亮)
天冲 → 体型(高大壮硕)
伤门 → 行为(急躁果断)
九天 → 气质(高远飘逸)
帝旺 → 整体状态(鼎盛期)

---

迭代修改

用户可以在描述生成后要求调整，支持以下方向：

调整类型	示例	处理方式
风格调整	"更正面一点"、"更日常"	从同一符号的万物类象中选取更正面/日常的对应项
领域聚焦	"针对职场"、"换成江湖风"	优先选取该领域相关的万物类象条目
环境变换	"换成古代"、"现代都市"	从场所环境/器物中选取时代匹配的条目
细节调整	"让这个人更年轻"、"物品再大一点"	调整对应维度的取象选择

调整始终在 data/wanwu_*.dat 数据范围内，不脱离原始数据编造新内容。如果数据文件中没有合适的替代项，告知用户当前符号组合的局限。

---

注意事项

1. 本技能是纯画像描述，不做吉凶判断、不做运势分析
2. 不需要祝福语、封局等仪轨流程
3. 如果用户想从描述转入分析（如"这个人运势怎么样"），引导到对应的分析技能（qmen_event/qmen_caiguan等）
4. 手工模式下只输入一个符号也可以工作，描述维度会相应减少

---

工作目录

所有 Bash 命令必须使用 workdir 参数，指向项目根目录。

获取 {SKILL_DIR}：本 SKILL.md 所在目录下 bin 是指向项目 bin/ 的相对软链接。通过以下方式解析项目根目录：

cd -P <本SKILL.md所在目录>/bin && cd .. && pwd

将输出赋值给 {SKILL_DIR}，后续所有命令使用 workdir: {SKILL_DIR}。

技能目录下的相关文件：

skill_qmenpowers/
├── bin/qimen_qiju.sh              # 起局脚本
├── bin/qimen_wanwu.sh        # 万物类象提取脚本
├── qmen_birth.json           # 命盘输出（运行后生成，局面模式输入）
├── qmen_wanwu.json           # 万物类象输出（运行后生成，AI必须读取此文件）
├── lib/                      # 引擎库（不需要直接调用）
└── data/                     # 数据文件（不需要直接调用）