紫天学习星球教学：SketchUp AI Skill/Rules REPO AI辅助开发规则库

发布于 作者:

文章作者：紫天
文章来源：原创

教学下载地址：https://t.zsxq.com/SqFYp

现在AI那么好用，你是不是也跃跃欲试想开发一款自己的SketchUp插件了？但是试来试去总发现AI写的程序总是无法在SketchUp上跑起来？这是因为SketchUp插件的编程需要遵循一定的规范，这个SKILL就可以帮你让AI遵循 SketchUp 的开发规范，提高程序的运行成功率。

 

该 SKILL（即 SketchUp Ruby API AI Agent Skill）开发的初衷是为了给 SketchUp Ruby API 扩展开发者提供一套全面、专业的指南和规则，并针对 AI 助手（如 ChatGPT、Claude、Cursor 等）和人类开发者进行了专门优化。

 

其具体开发目的包括：

 

减少 AI 生成代码的“幻觉”与错误：

AI 在编写 SketchUp 插件时经常会出现令人沮丧的错误，例如遗漏撤销包装（undo wrappers）、在观察器（observer）内部直接修改模型或忽略几何公差。该 SKILL 通过提供详细的“正面和反面”代码示例，强制 AI 遵循正确规则，显著降低了错误率。

 

确保符合官方发布标准：

该 SKILL 旨在确保 AI 生成的代码符合 SketchUp Extension Warehouse（插件商店）的官方标准，避免产出不专业或脆弱的代码。

 

整合官方与社区的最佳实践：

SKILL 中的规则是根据官方 SketchUp 仓库、Ruby API 文档以及社区（如论坛）讨论的最佳实践精心汇编和提取而成的。它涵盖了从基础的命名空间规范到复杂的性能优化和已知 API Bug 的解决方法。

提供标准化的开发手册： 它相当于一份 AI 的“说明书”，开发者可以将其集成到开发环境（如 Cursor 的 .cursorrules）或 AI 的自定义指令中，让 AI 在编写、审查或调试代码前先“背诵”这些关键规则。

提升代码的安全性与专业性： 通过强调撤销堆栈管理、几何逻辑校验、安全的观察器事件以及防止全局污染等原则，提升插件的健壮性，防止其在用户机器上崩溃。

简而言之，这个 SKILL 的目标是让 AI 代码生成在 SketchUp 开发领域变得更安全、更高效且更符合工业标准。

 

如何使用：

将这个 SKILL（即 sketchup_api_skill.md 文件）集成到 AI 开发工具中非常简单，主要有以下几种方式：

1. 集成到 Cursor 中

Cursor 提供了多种方式来识别这些规则：

使用 .cursorrules 文件： 这是最推荐的方式。你只需将 sketchup_api_skill.md 文件中的全部内容直接复制并粘贴到你项目根目录下的 .cursorrules 文件中。这样，Cursor 在该项目中生成或审查代码时会自动遵循这些规则。

直接引用文件： 你也可以将 sketchup_api_skill.md 保存在项目文件夹内，在与 Cursor 聊天时通过输入 @sketchup_api_skill.md 来显式调用这些规则，让 AI 针对特定任务参考该文档。

2. 集成到 ChatGPT 或 Claude 中

由于这些工具通常没有本地文件系统，你可以通过以下方式“喂”给它们规则：

自定义指令 (Custom Instructions)： 将 sketchup_api_skill.md 的内容粘贴到 ChatGPT 的“自定义指令”设置中。这样在所有对话中，AI 都会默认具备这些 SketchUp 开发知识。

项目知识库 (Project Knowledge)： 如果你使用的是 ChatGPT 的 GPTs 或 Claude 的 Projects 功能，可以将该 MD 文件作为知识库文档直接上传。

对话中粘贴： 在开始编写插件任务前，先将文件内容粘贴到 Prompt（提示词） 中，告知 AI：“请在接下来的任务中严格遵守以下 SketchUp Ruby API 开发规范：[粘贴内容]”。

3. 集成到 GitHub Copilot 中

你可以将内容添加至项目中的 .github/copilot-instructions.md 文件里，Copilot 会在提供建议时参考这些说明。

核心操作建议

集成的核心在于让 AI “背诵”并严格执行 规则。正如来源所述，这些规则强制 AI 检查对象是否被删除（entity.deleted?）、正确包装撤销操作（start_operation）以及避免使用过时的 WebDialog 而改用 HtmlDialog。

提示： 无论使用哪种工具，集成的目标都是让 AI 在编写、审查或调试 SketchUp 扩展时，将其视为一份必须严格执行的说明书。

获取完整教学请加入紫天学习星球。

紫天学习星球教学视频下载方法

使用微信扫码付费即可成为紫天学习星球居民，立即开启紫天学习星球之旅。当前加入费用￥198元，每年及时续费可享五折优惠。正式加入后可下载从创建日起至2026年5月17日紫天发布的所有高清中文教学视频内容，总共超过1200部，均为mp4高清格式，通过网盘直接分享，无需再另外支付其它费用。

加入知识星球后请访问 https://www.zsxq.com 下载APP或通过网页版登录。

紫天学习星球简介

紫天学习星球是一个以通过收费订阅方式学习 SketchUp 相关知识的园地，作为加入会员您可以学习到我们推送的最新的原创及中文翻译讲解的教学视频，所有视频均为百度网盘原尺寸下载，没有广告，让学习效果不打折。

需要声明的是：我们以订阅模式进行服务，每年固定时间收取费用；只要正式加入即可获取全部视频教学内容，包括往期内容，您可通过紫天官网（www.sublog.net）浏览搜索已发布教学视频或通过微信公众号了解历史更新内容。

紫天学习星球的会员期限均以固定年限为单位，每年在固定时间续费下一期内容。当您的会员到期且没有及时续费，您将无法接收到更新推送，但仍可访问往期已经接收到的内容。这种固定年限的订阅模式，先加入星球的会员可能感觉能够下载的资源很少，而到后期进入的会员可能感觉服务周期不足一年。但事实上不管加入时间早晚，所有会员最终得到的都是该订阅年度提供的全部教学，所获得的服务是同等的。

​为什么要加入紫天学习星球？

1. 时间最宝贵的财富。当前使用任何免费视频平台都会受到大量广告的干扰，这些广告累计起来无形中消耗掉了你的很多宝贵时间。而学习星球的教学视频都是直接通过百度网盘获取的，我们不会加入任何无关广告内容。

2. 每个人的精力有限，与其花时间四处寻找，赚积分做任务才能看到一点点知识内容，不如在学习星球做一点知识付费投入，把更多精力放在学习上。

3. 视频质量会影响学习效果，紫天学习星球完全舍弃那些网络视频平台，您可以通过百度网盘直接下载原始视频内容到本地电脑里观看，质量效果是最好的；

4. 星球还具有论坛形式，您在学习中遇到的任何难点，均可提问并得到我们的回复。您也可以对我们的制作内容进行引导，可在星球里发帖甚至悬赏来激励内容创作者们制作你所感兴趣的教学内容；

5. 当前可下载的视频教学已经累计超过900段，并且仍然每天更新，紫天学习星球是一个 SketchUp 知识宝库，是提升 SketchUp 技能的最佳途径。