thedivergentai/GD-Agentic-Skills
The official "Long-Term Memory" for Godot 4.7+ AI Agents. A high-density library of 99 expert skills and 27 genre blueprints, providing audited, strictly typed GDScript patterns, automated persona orchestration (Analyst, Auditor, Builder), and production-grade game engineering.
GD Agentic Skills – Godot 4.7+ 開發精通生態系統
是什麼
- 一個精心整理的 99 個「領域技能」（舊稱微技能）集合，編碼了最佳實踐的 Godot 4.7+ 代碼、架構模式與可投入生產的 GDScript 片段。
- 此庫被設計為 AI 編碼代理（如 Claude Code、Cursor、Gemini‑CLI 等）的外部長期記憶。
- 一個特殊技能
godot‑master作為協調器，引用所有其他技能，並添加決策矩陣、反模式與性能預算。
為何重要
- 現代 AI 代理經常「幻覺」或產生偏離官方 Godot 文件的程式碼。
- 透過向代理提供確定性、高 token 效率的知識庫，此項目旨在保持模型上下文的專注，並使輸出與引擎當前 API 保持一致。
- 倉儲還附帶一個 視覺技能（
godot‑agent‑vision），使代理能捕獲編輯器 GUI/資源截圖，轉換為 WebP，並根據生產標準評分——讓代理能「看見」專案，而不僅僅是讀取檔案路徑。
核心概念
| 概念 | 作用 |
|---|---|
| 領域技能 | 小型、自包含的 Markdown 檔案（SKILL.md），描述單一 Godot 功能（如 godot‑characterbody‑2d、godot‑game‑loop‑waves）。每個檔案包含官方文件連結、範例腳本與遷移說明。 |
| Godot‑master | 作為「首席架構師」技能，聚合所有 99 個領域技能，添加決策矩陣、反模式清單、性能預算與分層信號架構圖。它是新專案或需要完整專案指導的代理的首選入口。 |
| 代理優先設計（DIA 循環） | 發現-吸入-應用 循環告訴代理如何定位 skills_index.json，讀取適當的 SKILL.md 檔案，並應用知識而不過度載入模型上下文。 |
| 安裝規範 | 各代理的安裝旗標（-a cursor、-a claude-code 等）與預期目錄結構（.agents/skills/、~/.cursor/skills/ 等）的表格。 |
| 上下文風暴防護 | 明確警告不要使用 --all 安裝；一次性安裝所有技能會消耗約 15 k token，導致「元資料洪流」，減慢推理速度。 |
快速啟動路徑
| 路徑 | 使用情境 | 命令（透過 skills CLI） |
|---|---|---|
| A – 架構師 | 開始全新專案 或 需要對現有專案進行全面審計。 | npx skills add thedivergentai/gd-agentic-skills/skills/godot-master -g -a <agent> -y |
| B – 專家 | 僅需單一功能（如 2D 移動、物品欄）。 | npx skills add thedivergentai/gd-agentic-skills/skills/godot-characterbody-2d -g -a <agent> -y |
安裝後，執行 npx skills list -g -a <agent> 驗證並重新啟動宿主代理，使其載入新技能檔案。
重要更新（最新 v0.0.11）
godot‑agent‑vision– 捕獲編輯器 GUI/資源檢視區，以 WebP 格式儲存，並根據細粒度評分標準（字型加權、防傾斜、識別一致性）對視覺輸出進行評分。- 跨平台主機 CLI – 一個輕量級包裝器（支援 Win/macOS/Linux），連接倉儲與代理；位於
.gdskills/下，不是 遊戲內 Autoload。 - 遷移站 – 專用技能（
godot‑version‑migration），指導代理從任意舊版 Godot 逐步升級至 4.7，附帶各技能的遷移說明。 - 參考網格 – 每個領域技能末尾均包含官方 Godot 文件與相關技能的精選清單，使代理能在不離開技能圖的情況下「深入研究」。
目標受眾
- 生成或重構 Godot 專案的 AI 編碼代理（Claude Code、Cursor、Gemini‑CLI 等）。
- 希望獲得高效、經驗證的參考庫以餵給自身代理或手動瀏覽的人類開發者。
- 尋找可程式化查詢的結構化、最新 Godot 最佳實踐範例的教育者/導師。
限制與注意事項
- 此庫是外部的，不作為 Godot 插件或 Autoload 安裝。代理必須自行讀取 Markdown 檔案並注入提供的程式碼片段。
- 依賴
skillsCLI（Vercel‑Labs 工具）進行安裝。未使用該 CLI 的使用者需遵循「克隆 / DIA 路徑」工作流程：讀取skills_index.json並用代理的檔案工具開啟相關SKILL.md檔案。 - 不建議一次性安裝全部 99 個技能，因其會消耗大量 token 預算並引發「上下文風暴」。推薦模式是使用單一
godot‑master協調器或少量目標領域技能。 - 視覺技能目前輸出預算內 WebP 圖像與評分；不執行超出所提供評分標準的完整影像分析。
總結
GD Agentic Skills 是一個專為 AI 編碼代理設計的、高效利用 token 的知識庫，使代理能以規範、最佳實踐優先的方式與 Godot 4.7+ 互動。透過安裝涵蓋全部功能的 godot‑master 或選擇性領域技能，代理可存取經過篩選的文件連結、生產級 GDScript 片段、遷移指南，甚至視覺驗證——而不會過度負荷模型上下文。
快速參考連結
- 完整技能索引:
skills_index.json - Godot‑master 技能:
skills/godot-master/SKILL.md - 視覺技能:
skills/godot-agent-vision/SKILL.md - 安裝指南: 參見上方 ⚡ 快速啟動 表。
相關
- 專案
- 專案
- 專案
- 專案
- 專案