| name | create-world |
| description | 创建 Covel 世界包。根据用户概念直接生成 world.yaml + WORLD.md 写入 worlds/ 目录并验证。当用户想创建新世界、新地图、新世界观设定、或者说"帮我搞一个 XX 风格的世界"时使用。 |
创建 Covel 世界
根据用户的世界观概念，直接生成完整的世界包文件并写入 worlds/ 目录。
流程
1. 理解概念
用户给出概念后，如果足够清晰就直接开始。如果模糊，最多追问 1-2 个问题（不要追问技术参数——id、tags 等由你自主决定）：
2. 生成文件
在 worlds/<id>/ 下生成三个文件：
- world.yaml — 完整的世界 manifest。读取
references/world-yaml-schema.md 获取准确的字段结构和约束。schema 使用 strict 模式，不允许未定义字段。0.0.3 起优先声明 pluginPolicy 和 worldData: data/world.data.yaml，让会话准备页和世界数据导入管线使用结构化信息。
- WORLD.md — 默认 lore 文档（800-1500 字）
- WORLD.zh.md（或对应 locale）— locale 版本的 lore
创作要求：
- 至少 3 个地区、3 个阵营、4 个力量等级、3 个历史事件、3 个社会阶层
openingScenario 必须呈现即时的选择或紧张感- 按玩法选择
pluginPolicy.preset: 传统叙事用 traditional-story，对话/校园/群像用 dialogue-mode
- 视觉小说世界（对话模式的增强档）：声明
defaultViewMode: stage 进全屏舞台（背景 + 立绘 + 打字机），recommendedPlugins 加 scene-stage / character-presence / character-blueprint。资产（立绘/场景图）是渐进增强——没有也能跑（回退世界头图 + 占位卡），后续可用 scripts/generate-portraits.mjs / generate-scenes.mjs 补。结构见 references/world-yaml-schema.md 的"视觉小说资产管线"小节，成品参考 worlds/haruka-academy
- 本仓库示例世界默认声明
worldData: data/world.data.yaml; 如果生成对应数据 descriptor，必须读取 references/world-yaml-schema.md 的 worldData 小节
- 避免泛化的奇幻套路，追求独特的世界设定
- 所有 ID 字段（world id, faction id）使用 kebab-case 英文
- 其余内容使用用户的语言（默认中文）
3. 验证（按需分层）
参考 references/world-validation.md(必读) — 给出三层校验脚本和决策树。简版决策：
| 你写了什么 | 至少要跑哪几层 |
|---|
| 最小 world.yaml + WORLD.md | L1 schema(必做) |
factions 含 relations[] | + L2 引用一致性 |
| 准备对外发布 | + L3 lore 覆盖度 + L4 真实游戏跑一回合 |
L1 一行命令(必做):
node --input-type=module -e "
import { parse } from 'yaml';
import { readFileSync } from 'fs';
import { validateWorldManifest, formatValidationErrors } from '@covel/shared';
const y = parse(readFileSync('worlds/<id>/world.yaml','utf-8'));
const r = validateWorldManifest(y);
if(!r.valid){console.error(formatValidationErrors(r.errors));process.exit(1)}
console.log('schema OK');
"
校验失败则修复后重新写入。L2/L3/L4 见 references/world-validation.md。
4. 展示结果
给用户一个简洁摘要：世界名称、地区数、阵营数、力量体系、开场场景、跑了哪几层校验。问是否需要调整。
References
- 生成 world.yaml 前，读取
references/world-yaml-schema.md 了解完整字段结构和枚举值
- 需要格式参考时，读取
references/example-world.md 查看现有世界的 world.yaml 样例
- 验证阶段（特别是带 relations 或准备发布时），读取
references/world-validation.md 拿现成的校验脚本
