Skills: ai-lamp-common-skill

概述 {#description}

本技能服务于涂鸦照明品类 Ray 小程序面板的 AI 辅助开发，覆盖白光灯、彩光灯、情景灯等主流灯型的全流程能力。核心知识包括 DP 点映射与类型定义、Complex DP 编解码（colour_data / control_data / scene_data / music_data）、work_mode 分支控制、功能页跳转（定时/断电记忆/灯光渐变/停电勿扰）及 lamp-* 组件选型。技能通过 reference/ 子目录对组件、API、功能页提供完整签名，SKILL.md 速查表仅用于选型，详细用法以 reference 为准。

适用场景 {#scene}

• 新建照明面板：从零搭建白光或彩光灯面板，需要目录结构、DP 类型定义、基础控制页面。
• 实现控制功能：亮度/色温滑条、RGB/HSV 色盘、场景选择器、工作模式切换、音乐律动。
• Complex DP 开发：colour_data 12-bit hex 编解码、control_data 实时预览、scene_data / music_data 下发。
• 功能页接入：定时、断电记忆、灯光渐变、停电勿扰，含 presetFunctionalData 签名与 appid 注册。
• 调试 DP 通信：DP 值格式错误、数值越界、下发无响应的排查与修复。
• 不适用：非涂鸦平台设备、照明之外品类（插座、门锁等）的面板开发。

搭配使用 {#usage}

• RayCommonDevelopSkill：Ray 小程序开发框架通用技能。覆盖页面/UI、组件、Ray API/设备、生命周期/路由、i18n/样式、排障升级等框架层能力。当照明面板开发涉及路由配置、生命周期管理、构建排错、非照明专属的 Ray API 用法时，结合本技能使用。
• SmartUISkill：Ray 小程序 smart-ui 组件库专项技能。覆盖页面搭建、表单与反馈交互、导航展示等 UI 层能力，采用 meta-first 工作流精准筛选组件。照明面板的通用 UI 结构（弹窗、列表、设置项、Toast 等）优先通过本技能落地，避免手写重复样板代码。