ray-common-develop-skill
SKILL.md
RayCommonDevelopSkill
Overview
本 Skill 帮助在 Ray 小程序(涂鸦面板/跨端小程序)场景下生成与修改页面与组件代码。Ray 与微信小程序、Taro、React Native 形态相似但 API 与标签体系不同,必须严格依据本 Skill 内的标签对应表、references 下的框架与 smart-ui 文档产出代码,避免上下文超载与 API 幻觉。
- 按需加载:本 Skill 下的
references/目录体量很大,【绝对禁止】在未明确需求前一次性读取该目录下所有内容。你必须先查阅_meta.json或使用 Read/Glob/Grep 等工具分步、按需读取具体文件。 - 索引优先:需要 UI 组件时,先读
references/smart-ui/_meta.json定位组件与功能分类,再按需读取对应references/smart-ui/<组件>.md。若_meta.json中无法定位,允许在references/smart-ui/下用关键词(如 dialog、upload、progress)做检索后再读取候选文档,禁止在查不到时臆造组件或 Props。 - 基石标签表:以下标签对应表已内嵌,Skill 触发即生效。凡涉及 UI 结构、页面/组件代码生成或图片转代码时,必须优先按此表选用 Ray 标签,并在输出代码前做一次“语义–标签”校验。
- 版本对齐: 你必须注意 package.json 中的 @ray-js/smart-ui 版本, 是否与文档中要求的版本是否匹配,如果无法匹配,请提示用户进行升级 @ray-js/smart-ui 到最新版本。