| name | novel-worldbuilding |
| description | 管理小说世界观资产 —— 地点（location）和体系（system，含力量体系/政治/科技/宗教/经济/军事/社会）。当用户说"构建世界观"、"加一个地点"、"设计魔法体系"、"政治体系"、"修真体系"、"科技背景"、"加阵营"、"add location" 等时触发。每个 entity 保存为独立 markdown 文件，frontmatter 双向链到 characters 和 plot。 |
Novel Worldbuilding —— 世界观管理
功能
把"世界观"拆成可独立创建、独立维护、互相引用的实体文件：
- 地点（location）：城市、要塞、荒野、虚拟空间、洞穴...
- 体系（system）：力量体系 / 政治体系 / 科技体系 / 宗教体系 / 经济体系 / 军事体系 / 社会习俗
每个实体一个 .md 文件，frontmatter 标元数据，正文按模板填。所有 entity 通过 _index.md 注册表汇总。
前置条件
- 必须有
worldbuilding/_index.md（说明已 init）
- 建议先跑过
novel-brainstorm，让 story.md 有题材定位（影响世界观风格）
工作流
创建一个地点
-
读取上下文：
story.md：拿到 genre / sub-genre / tone，决定地点的整体氛围worldbuilding/_index.md：看已有地点，避免重复 / 保持一致- 如果是续作 / 同人，还要读
parent_canon.md（如有）
-
问用户基本信息（用 AskUserQuestion 一次问 2-3 题）：
- 地点名称（中文 / 英文均可）
- 类型（城市 / 要塞 / 荒野 / 海岛 / 虚拟空间 / 异空间 / 其他）
- 在全书中的作用（主舞台 / 阶段性据点 / 一次性场景）
-
对话补充细节，覆盖以下要素（不用一次问完，按重要度展开）：
- 物理描述与氛围
- 历史（跟主线相关的部分）
- 居民文化与习俗
- 注意点（主角会怎么和它互动）
- 当前状态（故事开始时这地方是什么样）
-
写文件：
- 使用
references/location-template.md 作为骨架
- 文件名 =
{name-kebab}.md（中文直接用，英文 kebab-case）
- 路径 =
worldbuilding/locations/{name-kebab}.md
-
更新 worldbuilding/_index.md 的地点表
-
反向链：如果地点 frontmatter 中列了 notable-characters，检查这些角色文件是否存在；不存在则建议用户用 novel-characters 创建，已存在则在角色文件的 locations 字段加上本地点 ID。
创建一个体系
-
读取上下文（同地点）
-
判断体系类型，参考 references/world-element-types.md 中对应类型的引导问题清单：
| 类型 | 关键问题 |
|---|
| 力量体系（修真/魔法/超能/科技力） | 来源、获取方式、等级划分、代价 / 副作用、跟世界的兼容性 |
| 政治体系 | 政体、阶级、权力来源、合法性、内部矛盾 |
| 科技体系 | 科技水平、突破点、限制、社会接受度 |
| 宗教体系 | 神祇、教义、组织、与权力的关系 |
| 经济体系 | 流通物、生产模式、贸易、阶级流动性 |
| 军事体系 | 武装、战斗逻辑、跟力量体系的关系 |
| 社会习俗 | 礼仪、禁忌、节日、性别 / 家族 / 年龄观 |
-
对话补充细节
-
写文件：
- 使用
references/system-template.md
- 路径 =
worldbuilding/systems/{name-kebab}.md
-
更新 _index.md 的体系表
-
反向链：如果体系涉及 practitioners（如魔法用户、修真者），在对应角色文件的 practices 字段标上本体系。
更新一个 entity
- 读原文件
- 改 frontmatter 和正文
- 如果改了
notable-characters / practitioners / regions 等关系字段，对应文件也要更新
- 改了名字 / 类型 / 状态，更新
_index.md
跨实体一致性检查（可选，被 novel-review 调用）
- 地点引用的角色 → 角色必须存在
- 体系约束的关系（比如"修真只有 9 个境界"）→ 角色卡里的
cultivation-level 不应越界
- 力量体系内部一致（比如等级 A 能做的事，等级 B 不应该能做）
这些检查由 check_consistency.py 实现（在 novel-review 阶段），本 skill 只负责创建。
命名约定
- 中文名：直接用（如
落雁城.md / 天枢宗.md）
- 英文名：kebab-case（如
ashen-citadel.md）
- 避免：包含
/、:、*、? 等文件系统非法字符；如必须，转为全角字符
中文长篇网文专属：常见体系类型
详见 references/world-element-types.md，包含 9 类常见体系的具体引导问题：
- 修真体系（道术 / 灵根 / 境界）
- 魔法体系（西式 / 东式 / 科学魔法）
- 异能体系（超能力 / 觉醒 / 进化）
- 科技体系（赛博朋克 / 蒸汽朋克 / 硬科幻）
- 武学体系（武侠 / 内功 / 招式）
- 修罗 / 神魔体系
- 体制 / 阶级体系
- 经济 / 资源体系
- 宗教 / 信仰体系
与其他 skill 的边界
- 不创建角色：角色由
novel-characters 管。如果对话中涉及角色（比如"这座城的城主是谁"），先在地点 frontmatter 里留 notable-characters: [-tbd-城主] 占位，由用户后续用 novel-characters 创建。
- 不写卷纲 / 章纲：那些是
novel-plot / novel-chapter。
- 不评判世界观好不好：是用户的世界，不要在创建过程中插嘴"这样设定可能会有 XXX 问题"，除非用户主动问。
输出
每次完成创建后：
- 给用户看新写的文件内容
- 提醒下一步可以做什么（继续加地点 / 加体系 / 加角色 / 设计卷纲）
