mcpField
F
find-examples

find-examples

github.com/playcanvas开发31312 次安装1 周前更新
代码仓库

关于 find-examples

find-examples 是用于查找与版本匹配的 PlayCanvas 示例并将其改编到 Engine、React 或 Web Components 项目的开发技能。它指导从本地源码和版本化仓库搜索，并建议对照已安装的包检查 API。

主要功能

  1. 01查找与已安装版本匹配的示例
  2. 02优先搜索对应表面的示例目录
  3. 03获取示例代码及匹配资源
  4. 04保留设置并移除示例浏览器控件
  5. 05根据已安装声明核对 React 属性

适用场景

  1. 01查找兼容版本的渲染方案
  2. 02将 Engine 示例改编到项目中
  3. 03对照已安装的包检查 React 示例属性

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/playcanvas/skills --skill find-examples

安装后在 Claude Code 中输入/find-examples确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
direct-engine.md
react.md
web-components.md

详细介绍

官方示例

示例是与版本匹配、可供改造的配方，不是可导入的模块。如果 Engine 提供了实现该行为的脚本，请优先使用 reuse-scripts。

查找示例

如果存在 node_modules/playcanvas/examples/src/examples，说明它是链接目录或源码检出：请在本地阅读。npm 包不包含 examples/，因此在其他情况下，请从已安装的标签获取：

TAG="v$(node -p "JSON.parse(require('fs').readFileSync('node_modules/playcanvas/package.json')).version")" || exit 1
gh api "repos/playcanvas/engine/git/trees/$TAG?recursive=1" | grep -o '"examples/src/examples/[^"]*\.example\.mjs"'
gh api "repos/playcanvas/engine/contents/examples/src/examples/<category>/<name>.example.mjs?ref=$TAG" \
  --jq .content | base64 --decode

请读取解析出的包，而不是依赖项列表；playcanvas 通常是传递依赖。列表为空表示标签无效：请停止，不要猜测。仅当该版本没有标签时才使用 main。

界面仓库引用示例路径
直接使用 Engineplaycanvas/enginev<version>examples/src/examples/<category>/<name>.example.mjs
Web Componentsplaycanvas/web-componentsv<version>examples/<name>.html
Reactplaycanvas/developer-sitemaindocs/user-manual/react/examples/<name>.mdx

请先搜索该界面的示例目录，再搜索 Engine 的示例目录。React 页面对应最新的软件包；请根据已安装的声明验证每个 prop。从同一引用获取示例资源，包括 examples/assets/wasm 下的 Draco、Basis 和 Ammo 解码器。

改造示例

保留组件选项、场景设置、材质、着色器、资源和更新逻辑；移除示例浏览器的控件和导入项。当一个示例结合了多个系统（例如图层、深度、相机帧和天空）时，请先实现其基准渲染效果，再进行自定义。

只阅读与代码匹配的参考文档：直接使用 Engine、React或 Web Components。

评论

支持 Markdown