| 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 脚本时：
强制规则：
- 脚本必须实际执行，禁止凭记忆模拟输出
- stdout 一字不漏原样输出，放在代码块内
- 完整输出在前，分析文字在后，顺序不可颠倒
- 多个脚本各自独立输出，不合并
禁止行为（出现即违约）：
- 省略："..."、"（省略N行）"、"（其余类似）"、"（以下省略）"
- 概括："输出如下"、"主要内容"、"关键部分"、"摘要"
- 借口："为节省篇幅"、"由于输出较长"
- 包装：折叠标签、翻译代替原文、只展示首尾
- 抢跑：输出前插入任何分析性文字
自检： 每次脚本执行后，确认"输出是否完整无遗漏"。如有遗漏，立即补贴，不重新执行。
后果： 截断或概括的输出视为无效，整个分析必须基于完整数据重来。
🔒 万物类象数据约束（不可越过）
所有万物类象（天干、九星、八门、八神的类象描述）只能来自以下两个数据源：
- 本地数据文件
data/wanwu_*.dat 中的实际字段值
- 脚本输出 JSON 中
wanwu 字段的内容
严禁：
- 编造数据文件中不存在的类象内容
- 将某个天干/星/门/神的类象张冠李戴到另一个上
- 为了"符合现实情况"而凭空建立干门星神与具体事物的关联
- 使用"根据XXX推测"、"可以联想为"等话术绕过数据约束
验证方法：如果你要说"X代表Y"，必须能在 data/wanwu_*.dat 或 JSON wanwu 字段中找到这条对应关系。找不到就不说。
描述模式
三种模式，由用户自然语言触发：
| 模式 | 触发示例 | 描述重点 |
|---|
| 场景 | "描述一个场景"、"画一个画面" | 环境、氛围、光线、声音、空间感 |
| 物品 | "描述一个物品"、"像什么东西" | 形状、颜色、材质、大小、质感、性质、功能 |
| 人物 | "描述一个人"、"这人什么样" | 外貌、体型、穿着、气质、性格、行为举止 |
如果用户没有明确指定模式，询问用户想要哪种描述。
输入方式
两种输入方式，互斥：
方式A: 局面模式
用户已有排局JSON，指定宫位号。
bin/qimen_wanwu.sh --palace=N --input=./qmen_birth.json
如果用户没有指定输入文件，默认使用 ./qmen_birth.json。如果文件不存在，提示用户先起局。
方式B: 手工模式
用户直接给出符号，至少一个即可，缺的不参与描述。
bin/qimen_wanwu.sh --stem=丙 --star=天冲 --gate=伤门 --deity=九天 --state=帝旺
参数全部可选，至少提供一个。
执行流程
Step 1: 确认输入
- 确认输入方式（局面/手工）和符号
- 确认描述模式（场景/物品/人物）
- 如果用户一句话说清楚了，不需要额外确认，直接执行
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 数据）
- 每个符号在一次描述中只映射一个维度，不重复使用
- 例如：天干映射颜色，九星映射形状，八门映射行为，八神映射气质
- 具体哪个符号映射哪个维度，由AI根据万物类象数据灵活分配，选最贴切的
- 十二长生参与但优先级最低，用于修饰整体状态/氛围/生命阶段
- 所有描述元素必须来自
data/wanwu_*.dat 或 JSON wanwu 字段的实际数据，严禁编造不存在的类象
- 描述必须符合基本逻辑关系，元素之间自然衔接
场景模式输出
一段完整的场景描述（200-400字），包含：
- 环境/空间（来自某个符号的场所环境/地理类象）
- 氛围/光线/色彩（来自某个符号的颜色/天象类象）
- 声音/动态（来自某个符号的事件行为类象）
- 人或物的存在感（来自某个符号的人物/器物类象）
- 整体状态（来自十二长生）
物品模式输出
一段物品描述（150-300字），包含：
- 形状/大小（来自某个符号的形态类象）
- 颜色/色泽（来自某个符号的颜色类象）
- 材质/质感（来自某个符号的器物/概念类象）
- 性质/功能/给人的感觉（来自某个符号的概念/性格类象）
- 状态/新旧/完好程度（来自十二长生）
人物模式输出
一段人物描述（200-400字），包含：
- 外貌/体型（来自某个符号的形态/体形类象）
- 肤色/面部特征（来自某个符号的颜色/身体类象）
- 穿着/气质（来自某个符号的概念/性格品质类象）
- 性格特点（来自某个符号的性格品质类象）
- 行为举止/动作习惯（来自某个符号的事件行为类象）
- 整体生命状态（来自十二长生）
输出结尾：符号-维度对照表
每次描述后，附上对照表，说明每个符号贡献了哪个元素：
丙 → 颜色(红/明亮)
天冲 → 体型(高大壮硕)
伤门 → 行为(急躁果断)
九天 → 气质(高远飘逸)
帝旺 → 整体状态(鼎盛期)
迭代修改
用户可以在描述生成后要求调整，支持以下方向：
| 调整类型 | 示例 | 处理方式 |
|---|
| 风格调整 | "更正面一点"、"更日常" | 从同一符号的万物类象中选取更正面/日常的对应项 |
| 领域聚焦 | "针对职场"、"换成江湖风" | 优先选取该领域相关的万物类象条目 |
| 环境变换 | "换成古代"、"现代都市" | 从场所环境/器物中选取时代匹配的条目 |
| 细节调整 | "让这个人更年轻"、"物品再大一点" | 调整对应维度的取象选择 |
调整始终在 data/wanwu_*.dat 数据范围内，不脱离原始数据编造新内容。如果数据文件中没有合适的替代项，告知用户当前符号组合的局限。
注意事项
- 本技能是纯画像描述，不做吉凶判断、不做运势分析
- 不需要祝福语、封局等仪轨流程
- 如果用户想从描述转入分析（如"这个人运势怎么样"），引导到对应的分析技能（qmen_event/qmen_caiguan等）
- 手工模式下只输入一个符号也可以工作，描述维度会相应减少
工作目录
所有 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/ # 数据文件（不需要直接调用）
