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 - 安装指南: 参见上方 ⚡ 快速启动 表。
相关
- 项目
- 项目
- 项目
- 项目
- 项目