核心能力
九大核心能力，覆盖 Kuikly 开发全链路，让 AI 成为你最强大的开发伙伴
整理了 Kuikly 的文档和常见问题解答的知识库，让 AI 真正理解 Kuikly 框架
弥补大模型对 Kuikly 规范的理解缺失，包含源码结构、组件 API、DSL 规范、最佳实践等，大幅提升 AI 输出质量
面向特定开发场景的 AI 技能包，让 AI 像专家一样处理组件集成、编译排查、代码审查等复杂任务
基于 Model Context Protocol，让 AI 动态访问 Kuikly 官方文档、组件库和开发工具，实现实时知识获取
通过 Deco 工具将 Figma 设计稿自动转换为 Kuikly 代码，精确还原布局与样式，大幅减少手动编写时间
AI 生成代码后即时预览运行效果，配合 UI Inspector 可视化调试组件树与属性，大幅提升开发效率
支持 React/Vue/Hippy 等框架存量代码高效转换成 Kuikly 代码，页面重构耗时从 3 天缩短到 1 天
Kuikly 官方开箱即用的 AI Chat 组件，一键接入完整 AI 对话能力，支持多模型切换、跨端一致体验
串联需求规划、代码生成、多端预览到一键验证的完整工作流，将分散的 AI 能力整合为流畅的自动化生产线
Kuikly Rules
Rules（规则文件）是一种用于定义 AI 编程助手行为准则和开发规范的文档。通过引入 Rules 文件，可以让 AI 工具准确理解项目的特定要求、技术标准和协作流程，从而提升代码质量与协作效率。
由于 KuiklyDSL 是一套私有 DSL，现阶段大模型的训练语料存在一定欠缺，缺乏规则约束时极易生成不可用的代码；而 Kuikly ComposeDSL 虽然基于 Compose 范式，但在包名导入、组件 API、参数定义等方面与官方 Jetpack Compose 存在部分差异，模型很容易误用。因此，我们针对常遇见的问题为两套 DSL 分别制定了对应的 Rules：
除项目 Rules 以外，使用方可以补充自己项目架构、最佳实践等 Rules，让模型更好地遵守你工程上的规范
# Kuikly Rules
## 组件使用规范
// ✅ 正确：使用 Kuikly DSL
View {
Text {
fontSize(16f)
color("#0052D9")
fontWeight(FontWeight.Bold)
}
Image {
width(48)
height(48)
}
}
## 最佳实践
- 使用 remember 缓存计算结果
- 避免在 render 中进行耗时操作
- 长列表使用 LazyColumn
## DSL 区别
// Kuikly DSL ≠ Compose DSL
// 不要混用两种语法Rules 以 .mdc 格式编写，CodeBuddy 会将其作为项目上下文自动加载。请根据你使用的 DSL 选择对应的规则文件：
CodeBuddy 将自动加载这些规则，并在生成或编辑代码时应用。
.mdc 文件为 Markdown + YAML front-matter 格式，可复用到其他 AI 编程工具：
.cursor/rules/，原生支持 .mdcCLAUDE.md可结合团队规范自定义扩展（目录结构、命名、架构决策等），让 AI 更贴合你的项目标准。
// ❌ 错误导入 Jetpack Compose 官方包
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.rememberScrollState
import androidx.compose.ui.unit.dp
@Composable
fun MyScreen() {
Column(modifier = Modifier.padding(16.dp)) {
Text("Hello", fontWeight = FontWeight.Bold)
}
}androidx.compose.*，应使用 com.tencent.kuikly.compose.*
// ✅ 正确导入 Kuikly Compose 包
import com.tencent.kuikly.compose.foundation.layout.*
import com.tencent.kuikly.compose.ui.unit.dp
fun MyScreen() {
Column(modifier = Modifier.padding(16f.dp)) {
Text("Hello", fontSize = 18f.dp)
}
}com.tencent.kuikly.compose.* 包名
// ❌ AI 不知道 Kuikly 页面怎么写
class HomeActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_home)
}
}Pager 页面模型
// ✅ 正确生成 Kuikly 页面
class HomePager : Pager() {
override fun body(): ViewBuilder {
return {
List {
attr { flex(1f) }
View { ... }
}
}
}
}Pager，实现 body() 方法
Kuikly Skills
Skills 是面向特定开发场景的 AI 技能包，让 AI 在特定任务上按照规范完成对应的任务。目前覆盖 11 个不同技能，涵盖框架集成、UI 构建、基础开发能力、能力扩展等方面
针对组件使用、编译排查、代码审查等不同场景，提供深度专业的解决方案
AI 根据对话内容智能识别并自动启用相应技能，无需手动切换，体验流畅自然
多个 Skills 可组合使用，协同解决复杂的跨场景开发问题，能力叠加效果显著
帮我实现一个剪切板 Module
用 Kuikly 做一个商品列表，支持下拉刷新
Kuikly MCP
基于 Model Context Protocol，让 AI 工具能够动态访问 Kuikly 官方文档、组件库索引和开发工具，实现实时知识获取，告别过时信息。
视觉稿转码
通过 Deco 工具将 Figma 设计稿自动转换为 Kuikly 代码，精确还原设计意图，大幅减少手动编写时间
设计稿一键转代码，省去大量手动编写时间，让开发者专注于业务逻辑而非重复的 UI 实现
精确还原设计稿的布局、样式和视觉效果，减少设计与开发之间的沟通成本和返工
自动提取并上传图片资源到 COS，无需手动处理资源文件，支持 Android Studio 插件和 CLI 两种方式
预览 & 调试
从代码生成到界面调试，Kuikly 提供即时预览与 UI Inspector 工具，让开发调试效率大幅提升
Kuikly 预览工具基于 Compose 预览能力深度增强，支持 AI 生成代码后增量编译快速渲染预览，无需完整构建 APK 与部署设备；配套 UI Inspector 提供可视化组件树与属性检查，快速定位界面问题。
代码修改后 IDE 后台完成增量编译，毫秒级刷新预览效果，无需等待全量构建，快速验证 AI 生成的 UI 组件是否符合预期。
直观展示页面组件层级结构，一键定位目标组件，告别反复打日志的低效调试方式
查看并修改组件的布局、样式、尺寸等属性，高亮显示组件边界和间距，快速发现异常
多设备、多主题、多状态一键切换预览，集成调试工具，确保预览效果与最终运行效果一致。
支持 React / Vue / Hippy 等主流框架存量代码高效转换成 Kuikly 代码，AI 智能分析代码结构与组件关系，自动完成框架语法和 API 映射转换。
支持 React、Vue、Hippy 等主流前端 / 跨端框架代码的智能转换，覆盖面广
AI 转码 Agent 深度理解框架差异，自动完成组件映射、样式转换和生命周期适配
传统页面重构耗时从 3 天缩短到 1 天，大幅降低迁移成本和人力投入
Kuikly 官方提供开箱即用的 AI Chat 组件，业务团队一键接入即可在 App 内实现完整 AI 对话能力。支持多模型切换、跨端一致体验、高度自定义 UI，快速赋能各类业务场景。
Kuikly 官方封装完整 AI Chat 组件，业务侧只需简单配置即可完成接入，无需关心底层实现
支持接入多种主流大模型，业务可按需选择最适合场景的 AI 模型，灵活配置
基于 Kuikly 跨端能力，AI Chat 组件在 iOS、Android、鸿蒙三端保持一致的交互体验
支持自定义 UI 样式、对话气泡、输入框等视觉元素，轻松融入业务品牌风格
👋 你好！我是 Kuikly AI 助手，有什么可以帮你的？
只需 3 步即可完成接入 🚀
完全支持 🎨 可自定义气泡颜色、字体、输入框样式，轻松融入你的品牌风格
串联起从需求规划、代码生成、多端预览到一键验证的完整工作流，将分散的 AI 能力整合为流畅的自动化生产线，让开发者聚焦于业务逻辑本身。
AI 深度理解业务需求，自动拆解为可执行的开发任务，生成清晰的实现路径
结合 Kuikly Rules 和 Skills，自动生成符合规范的高质量代码，减少人工修正
代码生成后自动触发 iOS、Android、鸿蒙多端预览，即时查看运行效果
自动完成编译检查、代码质量扫描和功能验证，确保交付代码即刻可用