前言¶
做 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
