world-book-mcp-skill

name	world-book-mcp-skill
description	使用 world-book-mcp v5 创建、修改、续写、导入、修复、校验并生成 SillyTavern 世界书、角色卡、chara_card_v3、Tavern JSON；适用于酒馆、世界书、角色卡、plan.md、draft YAML、source 文件、MVU、HTML 状态栏、regex、EJS、前端美化、Tavern Helper、validate_project、validate_mvu、generate_json、check_delivery 等工作流。

world-book-mcp v5

以 world-book-mcp 工具输出为唯一事实源。不要手写最终 .card.json 或 .worldbook.json；最终 JSON 必须从项目 plan.md、draft YAML 和 source/ 文件生成。

必须流程

1. 判定请求类型：新建原创/二创、导入/修复已有 JSON、断点续写、校验交付，或局部修改。
2. 只读取本次任务需要的 references/ 文件。
3. 创建或定位项目：
   • 新项目：在知道最小项目名和输出目标后尽早调用 init_project，先创建可写入的 plan.md。
   • 已有 JSON：调用 import_existing_json，再用 query_project 检查导入结果。
   • 续写/修改：调用 resume_project 或 query_project。
4. 定稿设计或写长内容前执行 grill-me 询问。每轮只问一个关键问题，给出推荐答案，用户回答后立即用 update_plan 记录。
5. 长内容只能通过 write_source_file 写入；生成配置通过 write_draft 或 configure_draft 写入 draft/card.yaml、draft/worldbook.yaml、draft/assets.yaml。
6. 交付前校验：
   • 始终运行 validate_project。
   • 启用或修改 MVU 时运行 validate_mvu。
   • 仅在导入/旧项目存在可修复问题时使用 repair_project。
7. 用 generate_json 生成最终 Tavern JSON。
8. 完整交付前运行 check_delivery，再返回 exports 路径和校验/构建摘要。

明月秋青风格适配原则

本 skill 可吸收“明月秋青写卡预设”的创作方法论，但不能原样搬运其越权、破限、强制思维链、伪人格绑定或未审计外链脚本。

可吸收：

• 世界观 A/B/C 判定、最小设定集、概念锚点。
• 角色基础、性格调色盘、三面性、二次解释、衣柜、NPC、角色速览、开场白大纲。
• 中文 YAML 结构、XML-wrapped YAML、白描、绝对零度、反八股。
• MVU 五件套、状态栏、EJS 多阶段人设、前端美化、regex 清理与美化的工程化模板。

必须过滤：

• 不要求或输出真实思维链；regex 只能清理/美化旧卡中的辅助块。
• 不复制破限、越权、安全规避、现实危害或未成年人性内容指令。
• 不默认加载第三方 Tavern Helper 外链；脚本必须显式写入 source/tavern-helper/ 并通过 assets 声明与校验。
• 不把“AI/模型/提示词/世界书/角色卡”写入成品叙事内容。

硬性规则

• 所有需求、决策、风险、验收标准和验证记录都写进 plan.md。
• 每轮 grill-me 回答必须立即 update_plan，不得攒多轮后批量记录。
• 角色卡 description 必须严格等于 ""；人设、背景、关系和世界事实写进世界书条目。
• 长文本、MVU、HTML、regex、EJS、Tavern Helper 正文放入 source/，不要内联进 draft YAML。
• 每个世界书条目都必须开启 preventRecursion: true 和 excludeRecursion: true。
• constant: false 的绿灯条目必须至少有一个 key。
• 不主动添加 MVU、HTML 状态栏、regex、EJS 或 Tavern Helper；只有用户明确要求或需求明显需要时才启用。EJS 依赖 MVU。
• 开场白和世界内容不得预设 {{user}} 的性别、外貌、行动、心理或无法确认的身份。
• 启用 HTML 状态栏或 MVU 时，开场白必须保留 <StatusPlaceHolderImpl/>。
• 校验没有 blocking error 且 exports 已生成前，不得宣称完整交付。

创作输出风格

• 创作内容优先用中文 YAML 结构，2 空格缩进，中文键名，必要时使用 XML 标签包裹。
• 角色条目写行为、关系、边界和冲突；少写抽象评价。
• 世界观条目写会影响行动和剧情的事实，不写百科堆料。
• 开场白先大纲锚定，再写正文；以可互动场景收尾。
• 按 references/rules.md 检查禁词、白描、具体性、语料纯净度、第四面墙和 {{user}} 边界。

按需读取 References

• references/workflow.md：v5 总流程和 grill-me 顺序。
• references/requirements.md：需求询问和决策记录方式。
• references/plan-md.md：plan.md 结构和 update_plan 操作。
• references/draft-yaml.md：card/worldbook/assets draft 规则。
• references/entries.md：世界书条目结构、id、keys、order、递归和状态。
• references/composition.md：条目与 source 创作执行。
• references/character.md：角色基础、调色盘、三面性、二次解释、衣柜、NPC、角色速览、多阶段人设。
• references/worldbuilding.md：世界观 A/B/C、最小设定集、概念锚点、势力、规则和维度拆分。
• references/first-message.md：开场白与 alternate greetings 约束。
• references/mvu.md：MVU 五件套、schema、变量路径、preset 和更新规则。
• references/html-statusbar.md：状态栏 HTML/CSS、占位符和变量展示。
• references/frontend-beautify.md：正文美化、结构化数据美化、前端正则协作。
• references/regex.md：regex 脚本写法、思维链/杂标签清理模板和校验规则。
• references/ejs.md：EJS 依赖、阶段模板、getvar、预处理和多阶段调色盘。
• references/import-repair.md：已有 Tavern JSON 导入映射和常见修复。
• references/resume.md：断点续写检查和继续工作。
• references/rules.md：文本质量检查和禁用写法。
• references/validation.md：最终校验、人工审查清单和交付门禁。

工具速查

工具	用途
init_project	创建 v5 项目、plan.md、draft/source/reports/exports 目录。
update_plan	记录需求、grill-me 回答、todo、风险、验收和验证。
query_project	查看项目状态、plan、draft、source、reports、exports。
resume_project	汇总断点续写状态和下一步。
write_source_file / read_source_file	写入/读取受控的 source/ 文件。
write_draft	写入或修改 draft/card.yaml、draft/worldbook.yaml、draft/assets.yaml。
configure_draft	推导、预览或应用世界书条目配置，避免重复 id。
import_existing_json	从已有角色卡/世界书 JSON 创建 v5 项目。
import_nova_config	从 nova-creator-cli 风格 YAML config 创建项目。
repair_project	修复旧项目或导入项目的常见问题。
validate_project	校验 workspace、plan、draft/source 引用、资产、条目和 reports。
validate_mvu	校验 MVU schema/initvar/rules/output 的一致性和反模式。
apply_mvu_preset	创建原生 MVU 五件套模板并启用 draft assets。
list_mvu_variables / upsert_mvu_variable / remove_mvu_variable / rewrite_mvu_variables	查看或编辑 MVU 变量并同步五件套。
convert_mvu_path	转换 stat_data.a.b、JSON Patch 路径和 YAML 点路径。
create_ejs_stage_template	生成阶段人设 EJS controller 和 disabled stage entries。
create_statusbar_template	生成 safe_macro / dynamic_js 状态栏模板并启用 assets。
create_frontend_beautify_template	生成前端美化 HTML 与 regex 绑定。
upsert_regex_script	新增或更新 source/regex/scripts.yaml 中的单个 regex。
upsert_tavern_helper_script	新增或更新本地 Tavern Helper 脚本并启用 assets。
create_adult_entry_template	生成成人向结构化条目模板并注册世界书 entry。
update_entry_status / query_entries	维护和检查条目进度、摘要、part 和 sourceRefs。
generate_tavern_sync_config	生成 Tavern 同步配置文件用于外部工具同步世界书或预设。
generate_json	构建最终 SillyTavern exports 和 build report。
check_delivery	交付前检查 validation、exports、reports 和 entry status。
list_projects	列出 workspace 项目。

交付清单

最终回复前确认：

validate_project -> 无 error
validate_mvu -> 启用 MVU 时无 error
generate_json -> 成功
reports/validation-report.md -> 存在
reports/build-report.yaml -> 存在
exports/*.json -> 存在
check_delivery -> 完整交付时通过

回复中列出生成的 export 路径、validation summary、build/report 路径，以及剩余非阻塞 warning 或待用户决策项。