RayCommonDevelopSkill

概述 {#description}

本技能是 Ray 小程序开发的「地图」：主文件只负责分区、导航与强约束，细节一律下沉到 references/。工作流为先选区、再读 references/ray/INDEX.md（Section | Key | Title）与对应 references/router/task-*.md，每次仅打开 1 个入口索引与 1～2 个目标文档，不足再增量追加；禁止跳过索引猜测 API、生命周期或组件属性。输出须区分 文档确认（来自当前已读文档）与 经验推断（文档未覆盖时的保守假设）。同步脚本 scripts/index.js 不再生成 _meta.json，导航以 INDEX.md 与目录内文件为准。

适用场景 {#scene}

• A 区（页面 / UI）：新建页面、弹窗、表单、列表、设置页、布局或界面改造。先读 references/router/task-ui.md；常查 references/ray/framework/page.md、references/ray/component/**、smart-ui skill。
• B 区（组件封装 / 改造）：抽组件、改组件、复用与规范结构。先读 references/router/task-component.md；常查 references/ray/framework/component.md、smart-ui skill、references/ray/component/**。
• C 区（Ray API / 设备能力）：调用 Ray API、连接通信、上传下载、监听事件。先读 references/router/task-api.md；经 references/ray/INDEX.md 定位到 references/ray/api/<key>/ 下对应 *.md / *.mdx。
• D 区（生命周期 / 路由 / Framework）：页面生命周期、路由、事件、样式、混合开发、插件、渲染机制。先读 references/router/task-framework.md；常查 references/ray/framework/*.md。
• E 区（图片转代码）：截图、草图、设计稿还原为 Ray 页面或组件。先读 references/router/task-image-to-code.md；常查 smart-ui skill、references/ray/component/**、references/rules/tag-mapping.md。
• F 区（i18n / 样式 / 版本）：多语言、CSS Modules、Less、smart-ui 版本对齐。先读 references/router/task-style-i18n.md；常查 references/rules/i18n.md、references/ray/framework/css.md。
• G 区（排障 / 升级 / 兼容）：报错、版本兼容、升级迁移、文档冲突。先读 references/router/task-debug.md；常查 references/ray/guide/**、references/rules/anti-hallucination.md。

选区：多区并存时只选一个主区（按最终产物判断，不按关键词数量）；其余为次区，主区完成后再按需补读。示例：设置页带开关与输入框 → A；表单抽成组件 → B；P2P 下载 → C；onLoad / 路由参数 → D；按图还原 → E；全文案 i18n → F；升级后不兼容 → G。