mcpField
R
reuse-scripts

reuse-scripts

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

关于 reuse-scripts

在实现行为前优先复用 PlayCanvas Engine 附带代码的开发技能。它指导开发者查找脚本与导出项、改编官方示例，并检查渲染结果。

主要功能

  1. 01列出 Engine 附带脚本
  2. 02识别非脚本核心导出项
  3. 03检查属性与依赖项
  4. 04改编官方示例
  5. 05验证渲染帧和错误
  6. 06保留内置输入行为

适用场景

  1. 01编写控制器前查找现有实现
  2. 02按所需资源和设置集成 Engine 脚本
  3. 03检查功能是否出现控制台或着色器错误

安装

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

$npx skills add https://github.com/playcanvas/skills --skill reuse-scripts

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

包含的文件

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

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

详细介绍

复用随包提供的 Engine 代码

在编写行为逻辑之前，先检查已安装的 playcanvas 包已提供哪些功能。

脚本位于 scripts/esm/** 下；只能从这些目录导入。列出它们：

rg 'static scriptName =' node_modules/playcanvas/scripts/esm \
  | sed "s|.*/scripts/esm/||; s|:.*static scriptName = ['\"]|  ->  |; s|['\"].*||" \
  | sort

常见脚本包括 CameraControls、FirstPersonController、ThirdPersonController、 ShadowCatcher、ProceduralSky、Water 和 Grid，以及 XR 和 splat 脚本。scripts/esm/parsers 下的模块是资源处理器类，而不是脚本。

不属于脚本的核心导出项包括用于后期处理的 CameraFrame、Picker （getSelectionAsync）、TransformGizmo、OutlineRenderer、MiniStats、GltfExporter 和 UsdzExporter。

集成

  1. 阅读源代码，了解导出项、@attribute 属性、默认值和必需组件。
  2. 使用 find-examples 查找官方示例，并复制其依赖的资源、图层、场景设置和渲染配置。
  3. 调整配置和扩展点。如果没有适用的内容，只实现缺失部分，并说明缺少了什么。
  4. 在完成一帧渲染后，若出现控制台、着色器或资源缺失错误，则判定失败。

除非另有要求，否则保留随包提供脚本的输入映射和阻尼设置；并使用实际输入验证输入方向，不要凭记忆推断正负号。

分组属性的更新方式因平台而异；保留未修改属性的默认值。只阅读与代码对应的参考文档：直接使用 Engine、 React 或 Web Components。

评论

支持 Markdown