convez.ai
Skill
yofengi

tavern-mmd

yofengi/tavern-mmd

Ver no GitHub
BomPluginScore · de 0 a 100

Claude Code skill: create SillyTavern & MMD (sexyai.top) character cards, worldbooks, status bars and global CSS themes

Instalação

$npx convez-ai yofengi/tavern-mmd

1 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

Estrelas
29
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 的存放位置:

AgentSkill 位置指令位置调用方式
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 没有技能目录,走"仓库进项目 + 规则指路":

  1. 把本仓库(至少 skills/tavern-mmd/ 文件夹)复制到你的项目里
  2. 在项目根新建 AGENTS.md(Trae 原生支持,且兼容 CLAUDE.md),或在 .trae/rules/project_rules.md 中写入下方指路句
  3. 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 jsonchara_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
正则导入jsonMMD 专用 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

Ver o original no GitHub

Bom para

Relacionados