gohud

Go HUD Skill

gohud 內建 AI 技能:完整 API、可直接執行的範本與預覽啟動器。把下面這一段貼給你的編碼代理,它就會裝好 gohud 並知道怎麼用。

把這一段貼給你的編碼代理

在代理裡開啟你的 Godot 專案,貼上下面這段並送出。它會裝好技能與外掛,再告訴你 gohud 能做什麼。

  1. 在 Godot 專案資料夾中開啟終端機,並在那裡啟動編碼代理 —— 例如 claude。
  2. 點下方程式碼區塊上的複製,貼到代理中並送出。
  3. 完成後,若代理要求就重新啟動它,然後問它:gohud 能做什麼?
Install gohud for this Godot 4.7+ project, then use it for all game UI
(menus, HUD bars, quick slots, dialogs, bottom sheets, forms, themes).

1. Install the gohud AI skill.
   Claude Code - run these two commands in a shell:
     claude plugin marketplace add thruthesky/gohud
     claude plugin install gohud@gohud
   Any other agent (Codex, Cursor, Gemini CLI, ...):
     git clone --depth 1 https://github.com/thruthesky/gohud.git /tmp/gohud
     Copy /tmp/gohud/skills/gohud into whichever of these folders this agent reads:
     ~/.claude/skills/gohud, .claude/skills/gohud, .agents/skills/gohud.

2. Install the add-on itself, unless addons/gohud/plugin.cfg already exists here.
   In a git repository:
     git submodule add https://github.com/thruthesky/gohud.git addons/gohud
   Otherwise copy the clone to addons/gohud without its .git folder.
   Then run: godot --headless --path . --import
   (If godot is not on PATH, ask me where Godot 4.7+ is.)

3. Check the result: addons/gohud/plugin.cfg exists and the import printed
   no "SCRIPT ERROR" or "Parse Error" lines.

4. A new skill loads when the agent starts. Tell me if I have to restart you,
   then tell me what gohud can do and how to preview it.

Docs: https://thruthesky.github.io/gohud/
這段刻意用英文書寫 —— 那是所有代理讀得最準的語言。你自己發問用什麼語言都行,技能會用你寫的語言回答。

或者輸入兩行指令 —— Claude Code

這會把技能以 Claude Code 外掛安裝。在終端機中:

claude plugin marketplace add thruthesky/gohud
claude plugin install gohud@gohud

已經在 Claude Code 裡了?改為輸入:

/plugin marketplace add thruthesky/gohud
/plugin install gohud@gohud

接著重新啟動 Claude Code 並輸入 /gohud:features —— 列出 gohud 的功能就代表技能已裝好。gohud 外掛本體仍需放在 addons/gohud: 安裝 →

各代理存放技能的位置

想手動安裝?把 skills/gohud 資料夾放到代理讀取的位置。先找到的那個生效。

代理資料夾放在哪指令寫法
Claude Code — 外掛claude plugin install gohud@gohud/gohud:preview · /gohud:features
Claude Code — 僅技能~/.claude/skills/gohud/gohud preview · /gohud features
Claude Code — 僅本專案.claude/skills/gohud/gohud preview
Codex · Cursor · Gemini CLI — 其他.agents/skills/gohud—

你會得到的指令

打開藝廊:每一個控制項、可挑選所有預設集的選擇器,以及完整圖示組。在你的 Godot 專案裡輸入它,用的就是你自己的 addons/gohud;不在專案裡的話,就用外掛內附的 那一份,或重新複製一份。它跑在一個用完即丟的沙箱專案裡,所以不會動到你的自動載入與匯入快取, 視窗則會一直開著,直到你關掉為止。

/gohud:preview demo — 15 章導覽

把示範開在起始畫面。開始示範會以真實輸入播放整段導覽;探索控制項 讓你親手試玩單一控制項。範例那一節列出的按鍵在這裡同樣有效。

其他許多指令

指令作用
/gohud:preview medieval中世紀預設集下的角色面板、行囊與任務日誌
/gohud:preview demo --explore hud示範直接開在某一章 — hud buttons inputs selection lists data states surfaces prompt touch coach scrolling forms anchors theming
/gohud:preview gallery --preset scifi_dark以某個預設集開啟藝廊;加上 --phone 可得 390×844 的手機視窗,--size 1920x1080 則是任意尺寸
/gohud:preview res://ui/main_menu.tscn你自己專案裡的場景,並在該專案中執行
/gohud:preview list所有目標、預設集 id 與示範章節代號
/gohud:preview gallery --check不開視窗的無介面冒煙測試 — 有指令碼錯誤就失敗
/gohud:features所有功能,依群組列出,每項一行程式碼
/gohud:features hud深入單一領域 — surfaces hud style theming icons i18n accessibility config

預覽指令需要 PATH 中有 Godot 4.7 或更新版本。

直接開口問也行

或者直接問。這份技能把 gohud 的整套 API 都教給代理,所以用白話交代也行 — 「用 gohud 做一個暫停選單」。若是以普通技能的方式裝在 ~/.claude/skills/gohud, 指令中間要空一格:/gohud preview demo、/gohud features。預覽需要你的 PATH 上有 Godot 4.7 以上,或者傳入 --godot /path/to/godot。