tavern-mmd
yofengi/tavern-mmd
Claude Code skill: create SillyTavern & MMD (sexyai.top) character cards, worldbooks, status bars and global CSS themes
Instalação
npx convez-ai yofengi/tavern-mmd1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
tavern-mmd
为 MMD(魅魔岛 / sexyai.ai) 和 本地酒馆 SillyTavern 创建角色卡、世界书、美化(状态栏 / 全局美化)的 Claude Code Skill。
完全自包含的纯文档型 skill:不依赖 MCP server、Python 或 Node 脚本,安装即用。
为什么需要这个 skill
MMD 是在线(uni-app 套壳)酒馆平台,与本地 SillyTavern 有显著差异:
- 当前 MMD 支持
<script>与 ES6(官方推荐 ES5 写法);旧版 MMD 禁止<script>、CSP 严格审查 DOM 属性内的 JS、仅支持 ES5 - 正则限额 30 条(findRegex ≤ 1000 字符、replaceString ≤ 20000 字符),导入格式与本地酒馆不同
- 角色卡仅支持 chara_card_v2(不识别 v3),整卡只能用 png 导入(不能直接导入 json 整卡)
- 不支持酒馆助手、MVU 变量框架、STScript
通用的角色卡创作流程在 MMD 上会产出无法运行的卡。本 skill 内置 平台差异矩阵,根据目标平台自动选择可行的技术方案(如 MMD 状态栏首选混合态雷达法:模型只输出纯键值对,JS 引擎动态装配 UI)。
功能
| 能力 | 说明 |
|---|---|
| 三平台支持 | 当前 MMD(支持 <script>/ES6)/ 旧版 MMD(不支持 <script>,ES5)/ 本地酒馆 SillyTavern |
| 角色卡创作 | 标准流程(快问快答)与深度共创流程(开放讨论 + 方案收敛)两种模式 |
| 世界书制作 | 三阶段流程(规划 → 总纲 → 展开),蓝绿灯策略、token 预算、递归控制 |
| 状态栏 | 首选混合态雷达法(特征嗅探 + 动态DOM + 双轨生命周期 + 七重防御);KV V4.0 轻量备选 |
| 全局美化 | MMD uni-app 界面类名速查(41 个选择器)+ CSS 变量主题架构 + 日夜切换 |
| 项目管理 | 每个项目独立文件夹(main.md / plan.md / 资料 / 工作 / output),断点续作 |
| 质量保障 | 写作规则(绝对零度 / 八股化扫描 / 具体性检查)+ 27 项交付前检查清单 |
审核与预览脚本
skill 自带两个纯 Python 标准库脚本(零依赖,全 agent 通用),AI 会根据 skill 指引在交付前自行调用,用法详见 skills/tavern-mmd/scripts/README.md。
- JSON 格式审核:AI 调用
scripts/validate.py对导入 json 做静态审核(JSON 合法性、BOM、双重转义、平台红线、字符数限额、v2 与世界书字段)。 - 状态栏 / 全局美化预览:AI 调用
scripts/build-preview.py生成 HTML 沙箱,再用 agent 的 Preview 工具自行查看渲染、测交互。
⚠️ 渲染沙箱是标准浏览器渲染,不一定能暴露状态栏在 MMD 上的所有问题(如 markdown 管线把换行解析成空
<p>撑出的空白条),状态栏 / 美化仍需实机导入 MMD 验证。
安装
skill 本体是纯 Markdown,任何能读文件的 AI 编程助手都能用。各 agent 的存放位置:
| Agent | Skill 位置 | 指令位置 | 调用方式 |
|---|---|---|---|
| Claude Code | ~/.claude/skills/ | ~/.claude/commands/ | 触发词自动激活 + /指令 |
| OpenCode | 原生兼容 ~/.claude/skills/(或 ~/.config/opencode/skills/) | ~/.config/opencode/commands/ | /指令 |
| Pi | ~/.pi/agent/skills/(或 .pi/skills/ 项目级) | 技能即指令 | /skill:tavern-mmd |
| Codex CLI | ~/.codex/skills/ | ~/.codex/prompts/ | /指令名 |
| Trae IDE | 无技能目录 → 仓库复制进项目 | .trae/rules/ 或项目根 AGENTS.md | 规则常驻 / #规则名 |
| 任意 agent | 任意路径 clone | 规则文件加一句指路 | 见下方"通用兜底" |
Claude Code
cp -r skills/tavern-mmd ~/.claude/skills/
cp commands/*.md ~/.claude/commands/
Windows:
~/.claude即C:\Users\<用户名>\.claude。安装后开启新会话生效。 若不想占用全局指令命名空间,可只装 skill 本体——直接对话(如"给旧版 MMD 做个状态栏")也能触发。
OpenCode
OpenCode 会自动发现 ~/.claude/skills/*/SKILL.md,按 Claude Code 方式安装 skill 即可零配置复用。指令另复制一份:
cp -r skills/tavern-mmd ~/.claude/skills/ # OpenCode 自动发现
cp commands/*.md ~/.config/opencode/commands/ # /mmd /beautify 等指令
OpenCode 没有 Claude Code 那样的触发词自动路由,建议在 ~/.config/opencode/AGENTS.md 加一行下方"通用兜底"的指路句。
Pi
cp -r skills/tavern-mmd ~/.pi/agent/skills/
聊天中输入 /skill:tavern-mmd 调用。commands 目录下的指令文件内容可手动复制为提示模板(~/.pi/agent/prompts/),或直接在对话里描述任务。
Codex CLI
cp -r skills/tavern-mmd ~/.codex/skills/
cp commands/*.md ~/.codex/prompts/ # 以 /mmd /beautify 等方式调用
Trae IDE
Trae 没有技能目录,走"仓库进项目 + 规则指路":
- 把本仓库(至少
skills/tavern-mmd/文件夹)复制到你的项目里 - 在项目根新建
AGENTS.md(Trae 原生支持,且兼容 CLAUDE.md),或在.trae/rules/project_rules.md中写入下方指路句 - commands 的指令文件在 Trae 中不可用,需要哪个流程就把对应 .md 内容粘贴进对话
通用兜底(任意 agent)
clone 本仓库到任意位置,在该 agent 的规则文件(AGENTS.md / 系统提示 / rules)里加一句:
制作酒馆角色卡、世界书、状态栏或全局美化(MMD/SillyTavern 相关)时,
必须先完整阅读 <仓库路径>/skills/tavern-mmd/SKILL.md,
并按其中"任务路由"表读取对应 references 文档后再动工。
路径注意:
commands/里的 mmd/oldmmd/st 三个指令内写的是~/.claude/skills/tavern-mmd/...绝对路径。skill 装在其他位置时,请把指令文件里的路径替换为实际位置(或依赖 agent 自己的技能发现机制,不用指令文件)。
指令
指令分两个维度,自由组合:
平台指令(设定目标平台)
| 指令 | 平台 |
|---|---|
/mmd | 当前 MMD(支持 <script>/ES6,推荐 ES5 写法) |
/oldmmd | 旧版 MMD(禁 <script>,onerror 点火器 + ES5) |
/st | 本地酒馆 SillyTavern(无限制) |
任务指令(执行制作)
| 指令 | 用途 |
|---|---|
/cardplan | 角色卡标准工作流:弹窗快问快答 → plan.md → 执行 |
/cardplanmax | 角色卡深度工作流:开放讨论 → 方案收敛 → 分节设计确认 → 分段执行 |
/worldbook | 制作世界书,输出可导入 json |
/beautify | 制作美化(全局美化 / 状态栏) |
/helpmmd | 显示全部指令帮助 |
组合示例
/oldmmd → /beautify # 旧版 MMD 状态栏(雷达法四条正则,产出可导入json)
/st → /worldbook # 本地酒馆世界书(全字段,json 直接导入)
/mmd → /cardplanmax # 从零共创一张当前 MMD 完整角色卡
产出物
| 产出 | 本地酒馆 | MMD(新旧同) |
|---|---|---|
| 角色卡 | chara_card_v3 json | chara_card_v2 json(MMD 仅识别 v2) |
| 世界书 | SillyTavern 世界书 json | 同左 |
| 正则 | 正则脚本 json(直接导入) | MMD 导入 json(首选);手填清单 .md 备选 |
目录结构
skills/tavern-mmd/
├── SKILL.md # 入口:平台差异矩阵、任务路由、项目文件树规则
├── references/
├── platforms/ # 三平台技术规范
│ ├── mmd.md # 当前 MMD(script 差异 + 待验证标注)
│ ├── mmd-old.md # 旧版 MMD(红线分级、ES6 禁用清单、五大架构模式)
│ └── sillytavern.md # 本地酒馆(position 表、正则字段)
├── creation/ # 创作规则
│ ├── character.md # 角色写作(绝对零度 / 八股化 / 具体性)
│ ├── worldbook.md # 世界书三阶段流程 + 条目规划表
│ ├── opening.md # 开场白三要素
│ └── style.md # 文风条目模板
├── beautify/ # 美化方案
│ ├── statusbar-radar.md # 混合态雷达法状态栏(MMD首选:五级分类+防御体系)
│ ├── statusbar.md # KV V4.0 状态栏(轻量备选:三段正则模板 + 数据继承)
│ ├── global-css.md # 全局美化(uni-app 类名速查 + 主题变量)
│ └── regex-rules.md # 正则设计原则与平台限额
├── output/ # 产出格式权威参考
│ ├── card-json.md # chara_card_v3 完整字段 + v2 差异(MMD 交付格式)
│ ├── worldbook-json.md # 独立世界书 json + 与卡内条目字段差异对照
│ └── regex-output.md # 正则 json / MMD 手填清单模板
└── quality/
└── checklist.md # 交付前检查清单(含雷达法专项)
└── assets/radar-examples/ # 雷达法开源示例(西幻RPG状态栏、日夜主题集成案例)
commands/ # 8 个斜杠指令
平台差异矩阵(核心)
| 能力 | 本地酒馆 | 当前 MMD | 旧版 MMD |
|---|---|---|---|
<script> | ✅ | ✅(已确认) | ❌ → img onerror 点火器 |
| ES6+ | ✅ | ✅ 无限制,推荐 ES5 写法(已确认) | ❌ ES5 only |
| 正则导入 | json | MMD 专用 json(4 字段)或手填,≤30 条 | 同当前 MMD |
| 状态栏 | 雷达法 / KV V4.0 | 首选混合态雷达法 | 同当前 MMD |
| MVU/STScript | ✅ | ❌(保守) | ❌ |
当前 MMD 已确认支持
<script>与 ES6(推荐 ES5 写法);其余未确认能力按旧版保守处理并标"待验证",详见references/platforms/mmd.md。
致谢
- 旧版 MMD 平台限制与架构模式整理自社区MMD开发规范与类名定义 和 KV-Robust V4.0 澄清状态栏规范
- 混合态雷达法状态栏(特征嗅探 + 响应式动态 DOM,改五版)理论与开源示例 by 黑洞猫
- 创作质量体系(绝对零度原则、八股化检查等)提炼自 SillyTavern 社区角色卡创作实践
License
MIT