| name | xiuzhen-art-generator |
| description | 生成修真/仙侠设定的受控随机提示词，并据此创作法术、功法、秘籍、法宝、神通、百艺、修真职业或相关体系。用户要求创建、随机生成、有限条件随机、构思、设计或优化修真法门时使用本技能。 |
修真百艺生成器
使用本技能生成或创作修真世界中的法术、功法、秘籍、法宝、神通、百艺或相关设定。
核心模型：
法门 = 天位(动力因：为何成力/何因增强/何时耗尽/失控何状/如何度量) x 地位(媒介/承载方式) x 人位(目的/作用)
工作流
- 首次常规生成时不要由 agent 读取
references/*.md 或 data/pools.md。脚本会从这些资料中提取创作上下文，去掉维护命令、文件路径说明、维护手册和池格式手册后一次性输出。
- 运行脚本前先确定本技能目录，也就是当前
SKILL.md 所在目录。不要假定当前工作目录就是技能目录。推荐用 python3 "$SKILL_DIR/scripts/generate_prompt.py" ...，其中 SKILL_DIR 是包含本 SKILL.md 的目录；也可以先 cd "$SKILL_DIR" 再运行 python3 scripts/generate_prompt.py ...。
- 运行
generate_prompt.py 抽取或约束天位、地位、人位。默认随机策略是小说可用率加权；用户要求“完全随机”“强随机”“force random”或“全池随机”时使用 --force-random。普通创作流程使用文本输出，不用 --json；首次文本输出包含“创作上下文包 + 本次抽样提示词”，必须整体作为创作依据。
- 同一会话里后续生成、用户说“接着生成”“继续”“再来一个”“换一个”或此前脚本已经输出过完整上下文时，运行脚本必须加
--continue（等价 --omit-context），省略重复参考 Markdown，只使用新的 generated-request。
- 后续生成不要靠自然语言反复强调已经出现过的世界观上下文；把用户的新要求、延续条件和避重方向尽量转成脚本参数，例如
--type、--realm、--theme、--rarity、--name-style、--composition-mode、--condition、--include、--exclude、--heaven-count、--earth-count、--human-count。若用户要求“别重复上次”，优先把上次核心天/地/人或不想再见的意象放进 --exclude，把仍需延续的剧情、门派、角色定位或功能偏向放进 --condition。
- 用户显式指定的
--heaven、--earth、--human、--sword-branch、--name-style、--type、--realm 是硬约束，必须保留。若强制项与境界冲突，只能写成误读、残式、低阶入口、旁门代价、局部小术或高阶传承的浅层用法。
- 用户要求剑经、剑修、剑法或“必须有剑意/剑势/剑心/剑胆/剑气/剑道”时，不要把这些剑性六纲写成
--human、--earth 或普通 --heaven 要素，除非池里确有同名普通要素。应使用 --heaven 剑，并用 --sword-branch 剑意 这类参数固定本次侧重纲目；其余语义继续放进 --condition。
- 在当前上下文中直接使用生成器打印的完整提示词，产出最终设定。
--continue 输出省略的是参考 Markdown，不是本次抽样提示词；仍要完整遵循新的 generated-request。
- 需要复现时，附上 seed、强制参数、是否使用
--continue 和自动合理化诊断。
调试、维护池子、排查抽样、扩展范畴或用户明确要求解释资料来源时，才读取参考文件：
data/pools.md：脚本加载的权威池数据。references/elements.md：要素分类与三位机制说明。references/realm-system.md：境界、尺度、身份与功法等阶链说明。references/naming.md：命名文体、后缀和避坑说明。
新增或调整要素、细分、主题偏置、条件别名、复合父级模型时，优先改 data/pools.md，改完运行 python3 scripts/validate_pools.py。
快速开始
SKILL_DIR=/path/to/xiuzhen-art-generator
python3 "$SKILL_DIR/scripts/generate_prompt.py"
python3 "$SKILL_DIR/scripts/generate_prompt.py" --type 法宝
python3 "$SKILL_DIR/scripts/generate_prompt.py" --type 功法 --realm 元婴
python3 "$SKILL_DIR/scripts/generate_prompt.py" --seed 20260512 --type 法术
python3 "$SKILL_DIR/scripts/generate_prompt.py" --condition "偏医毒蛊疫，不要纯攻击" --rarity 失传
python3 "$SKILL_DIR/scripts/generate_prompt.py" --theme 魂梦心识 --type 秘籍
python3 "$SKILL_DIR/scripts/generate_prompt.py" --type 法宝 --name-style 祭文悲怆
python3 "$SKILL_DIR/scripts/generate_prompt.py" --type 剑法 --heaven 剑 --heaven 分 --heaven 灭 --composition-mode 纯化
python3 "$SKILL_DIR/scripts/generate_prompt.py" --type 功法 --realm 元婴 --heaven 剑 --sword-branch 剑意 --condition "剑经，直指元婴"
python3 "$SKILL_DIR/scripts/generate_prompt.py" --force-random
python3 "$SKILL_DIR/scripts/generate_prompt.py" --type 秘籍 --realm 金丹 --force-random
python3 "$SKILL_DIR/scripts/generate_prompt.py" --continue --type 法术 --realm 金丹 --condition "接着上一批宗门秘传生成，偏防护和追索"
python3 "$SKILL_DIR/scripts/generate_prompt.py" --continue --type 剑法 --realm 金丹 --exclude 藏,蓄势 --condition "别重复上次蓄势剑路，仍适合长老级斗法"
约束三位：
python3 "$SKILL_DIR/scripts/generate_prompt.py" --heaven 愿 --earth 梦 --human 净化
python3 "$SKILL_DIR/scripts/generate_prompt.py" --heaven 剑 --heaven 分 --earth 形 --human 灭 --human 感应
生成原则
- 脚本输出是常规生成的唯一资料入口。不要在脚本输出之外把参考 Markdown 再输入一遍。
- 默认生成目标是小说可用率。随机项应优先落在当前境界能承担、读者能理解、剧情能使用的尺度。
--force-random 只取消未指定项的可用率加权，不取消境界适配；抽到的偏门、上古或仙古要素仍必须被降尺度、补限制或合理化。- 天位是法门的动力因，必须解释为何成力、何因增强、何时耗尽、失控何状和如何度量；不能只是氛围词、主题、权限、特效名或合法性说明。
- 地位是媒介，人位是目的。默认允许多地位、多人位，但多个要素必须形成构型，不能写成几个平行途径或几个互不相干的效果。多地位要分出主承载、传导/触发、锁定/感知、稳态/约束或代价承载；多人位要分出主效用、索敌/识别、传递/扩散、约束/封锁或收束/终局，并说明它们如何组成一个目的链。
- 主题、类型、境界或上下文只能改变权重、解释绑定、后处理或显式强制项，不能把开放维度缩成小池随机。
- 元婴只规定层级特色，如神魂、出窍、化身、远遁、生存、因果、洞府防护、传承或高阶威慑；具体效用由人位决定，不默认要求某个固定功能。
- 写功法时，目标境界高于练气必须说明功法等阶链：总纲、逐阶特殊之处、配套术法、递进/拆分/合一路径。
- 写剑修、剑法或以
剑 为道形统合时，剑 不消耗普通天位数量；其他天位仍从完整大池抽样。剑修默认比同境界普通修士更强势，强势体现在杀伤、破防、抢先手、压迫选择、越过防御资源和终结战斗。
- 剑法命名要体现境界门槛：练气可用
剑谱、剑式、剑招、剑步；筑基到金丹可用 剑图、剑章；金丹到元婴优先 剑诀、剑阵、剑意、剑心诀。金丹剑法主名要有长老级秘传、镇守一方或同阶斗法的分量，避免低阶小册、入门招式或“断后”这类掩护撤退读感。
- 剑性六纲不是固定能力清单，每一纲都必须由已抽到或绑定的真实天位解释。不要在正文复述六纲判据，要转译成具体剑路、局势、承压、修炼门槛、禁忌和后果。
- 输出不要只给名字和风味文本。最终设定应暴露机制、启动方式、限制、反噬、修炼或使用门槛，以及一个具体使用场景。
输出约定
返回：
- 设定总览：类型、境界、基调、核心用途
- 核心三位：天位、地位、人位
- 天位动力因：为何成力、何因增强、何时耗尽、失控何状、如何度量
- 复合结构与纯化取舍
- 地位媒介与施展/修炼方式
- 功法等阶链：仅当类型为功法时必填
- 人位用途与效果
- 限制、代价与反噬；若类型为剑法，改写为修炼门槛、修士风险与反噬
- 境界适配与等阶差距
- 适配场景
- 诸名：三到五个，宁缺毋滥，按贴合度排序；第一名须可直接入正文，每个名字只附一句短说明
- 一段可直接放入小说设定集的正文
