前言¶
做 WebGAL 视觉小说时，脚本要同时照顾命令语法、演出衔接和分支变量。单靠通用大模型容易写出半角标点不对、漏分号、或把 changeScene 和 callScene 混用的问题。把引擎规则写进 Agent Skill，对话里就能按 WebGAL 约定出稿、查错和优化，而不是每次从零口述规范。
这是什么¶
webgal Skill助手（坐标 @user_0064faa7/webgalskill，版本 1.0.0）是 SkillHub 社区技能，分类为 content-creation，发布者 user_0064faa7（SkillHub 页面标注作者 zhenruyan）。它在 Agent 中扮演「WebGAL 剧本编写专家」：熟悉 WebGAL 的命令格式、演出控制、变量与场景跳转，协助编写、查错和优化脚本，并按模块引用内置参考文档。
Skill 标注 requires_api_key=false，不依赖额外 API Key。SkillHub 页面统计（以页面展示为准）：评分 100000，下载 955。
官方入口：
- API / 安装标识：
https://api.skillhub.cn/user_0064faa7/webgalskill - SkillHub 详情页：
https://www.skillhub.cn/skills/user_0064faa7/webgalskill
核心功能¶
下面介绍 Skill 包内 SKILL.md 与 references/ 已写明的能力，不超出该范围。
语法与输出约定¶
Agent 按以下规则处理 WebGAL 语句：
- 语句一般以半角分号
;结尾，分号后为注释。 - 基本形态为
指令:值 -参数1 -参数2=值;，冒号与分号须为半角英文。 - 输出脚本时使用
ws语言标记的代码块，并在代码外做简要说明。
分模块知识库（按需加载）¶
Skill 将命令说明拆成 9 个参考文件，每个文件顶部有命令速查表，便于 Agent 按任务加载：
| 模块 | 文件 | 覆盖内容（摘要） |
|---|---|---|
| 基础 | references/base.md |
none、-next、-concat、-notend |
| 对话 | references/dialogue.md |
角色对话、旁白、变量插值、注音、文本框、结束与电影模式 |
| 背景与立绘 | references/bg-and-figure.md |
changeBg、changeFigure、小头像、CG 解锁 |
| 场景与分支 | references/scenes.md |
changeScene、callScene、choose、标签跳转 |
| 变量 | references/variable.md |
setVar、随机数、-when、getUserInput、全局与存档域 |
| 音频 | references/audio.md |
BGM、语音 -V、playEffect、unlockBgm |
| 视频 | references/video.md |
playVideo 及跳过控制 |
| 动画 | references/animation.md |
setAnimation、setTransition、自定义动画表 |
| 特效 | references/special-effect.md |
pixiInit、pixiPerform 等 |
SKILL.md 中还提供命令目录索引（场景跳转、变量、音频、立绘、特效等）和固定工作流：意图识别 → 按需检索 → 编写脚本 → 注释解释 → 用 -next / -concat / -notend 串联演出。
安装与启用¶
先做 CLI 检查，再把 Skill 装到当前 Agent 实际使用的 skills 目录；装错目录时 Agent 不会加载（SkillHub 安装文档中的说明）。
1. 安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装（含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装 webgal Skill助手¶
搜索确认包名后，使用命名空间安装（SkillHub 搜索结果的推荐写法）：
skillhub search webgal
skillhub install webgalskill --namespace user_0064faa7 --dir <你的 Agent skills 目录>
SkillHub 详情页亦提示：按 https://skillhub.cn/install/skillhub.md 安装 @user_0064faa7/webgalskill。
常用 Agent 的 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
安装完成后按你所用客户端要求重启或刷新 Skill 列表。本文未单独核实 Claude Code / Codex CLI 的启用差异，除目录外请以对应该产品的官方说明为准。
典型用法¶
启用 Skill 后，用自然语言描述演出或逻辑即可；Agent 应按 SKILL.md 工作流引用对应 references/*.md 并输出 ws 代码块。
示例 1：对话中切换立绘（来自 references/base.md）
WebGAL:测试语句插演出！马上切换立绘...... -notend;
changeFigure:k1.png -next;
切换立绘！马上切换表情...... -notend -concat;
changeFigure:k2.png -next;
切换表情！ -concat;
示例 2：分支选择（SKILL.md 索引中的语法）
choose:选项1:文件1.txt|选项2:文件2.txt;
示例 3：带淡入的 BGM（SKILL.md 音频小节）
bgm:文件名.mp3 -volume=80 -enter=3000;
向 Agent 说明目标场景（例如「写一段带选项跳转的开场」「给这段对话加 BGM 淡出」），比逐条背命令更符合 Skill 设计。
适用场景与注意¶
适合谁
- 使用 WebGAL 引擎做 Galgame / 视觉小说的作者或程序员。
- 希望在 Cursor、Claude Code 等带 Skills 的 Agent 里统一脚本风格、减少语法笔误的人。
限制与注意
- Skill 提供的是语法与最佳实践指引，不会替代 WebGAL 编辑器或运行时的资源路径、素材命名；图片、音频文件名需与你工程目录一致。
- 部分参考文件在
SKILL.md中标记为「待按需加载」，复杂演出（动画 JSON、animationTable.json等）仍需对照官方引擎文档与本地工程结构。 - 社区来源（
source: community），版本为 1.0.0；升级可用skillhub的升级能力，安装前建议在 SkillHub 页面确认版本与说明。 - 无需 API Key，但 Agent 本身仍受你所用模型的上下文与是否加载
references影响；长剧本宜分场景迭代。
结尾¶
webgal Skill助手把 WebGAL 的分模块命令速查和工作流写进 Skill，让 Agent 在内容创作类任务里按引擎语法写脚本、查错和优化。若你做 WebGAL 项目并已在用 SkillHub，可按上文命令装入对应 skills 目录。
官方地址：https://api.skillhub.cn/user_0064faa7/webgalskill
SkillHub 页面：https://www.skillhub.cn/skills/user_0064faa7/webgalskill
