Skyline 渲染引擎技能
微信小程序 Skyline 渲染引擎的完整开发指南,涵盖组件、样式、动画、路由、滚动 API 和配置迁移。
When to Use This Skill
This skill should be triggered when:
- Developing WeChat Mini Programs with the Skyline rendering engine
- Working with Skyline-specific components (scroll-view enhanced mode, draggable-sheet, share-element, etc.)
- Implementing worklet animations (SharedValue, timing, spring, decay)
- Using custom routes and page transitions (routeBuilder, open-container)
- Checking WXSS/CSS property compatibility under Skyline
- Configuring Skyline renderer in app.json / page.json
- Migrating from WebView to Skyline
- Using Skyline scroll APIs (ScrollViewContext, DraggableSheetContext)
Module Reference Guide
This skill is organized into 7 modules. Use Read tool to access specific reference files when detailed information is needed.
1. Overview — 概览与迁移指南
Path: references/overview/SKILL.md
Skyline architecture, performance advantages, feature overview, migration guide and best practices.
references/overview/references/introduction/ — Architecture & features
references/overview/references/migration/ — Migration guide & compatibility
references/overview/references/performance/ — Performance comparison
references/overview/references/api/ — getSkylineInfo, preloadSkylineView
references/overview/references/changelog/ — Changelog
2. Config — JSON 配置规范
Path: references/config/SKILL.md
app.json, page.json, and project.config.json configuration for Skyline.
references/config/references/app-config.md — App-level configuration
references/config/references/page-config.md — Page-level configuration
references/config/references/project-config.md — Project configuration
references/config/references/patterns.md — Common patterns
3. Components — 组件开发指南
Path: references/components/SKILL.md
scroll-view enhanced modes, swiper, form components, media, draggable-sheet, share-element, snapshot.
references/components/references/scroll/ — scroll-view, nested-scroll, list-grid-view, sticky, draggable-sheet
references/components/references/layout/ — swiper
references/components/references/form/ — input
references/components/references/media/ — image, text
references/components/references/special/ — share-element, snapshot
4. WXSS — 样式支持
Path: references/wxss/SKILL.md
CSS property support and limitations under Skyline.
references/wxss/references/basics.md — Basic properties
references/wxss/references/layout.md — Layout (flex, grid)
references/wxss/references/flex.md — Flexbox details
references/wxss/references/text.md — Text properties
references/wxss/references/visual.md — Visual effects (filter, gradient, mask)
references/wxss/references/animation.md — CSS animations & transitions
5. Worklet — 动画系统
Path: references/worklet/SKILL.md
Worklet functions, SharedValue, timing/spring/decay animations, easing, and thread communication.
references/worklet/references/core/ — Worklet overview
references/worklet/references/base/ — SharedValue, derived values
references/worklet/references/animation/ — timing, spring, decay, easing, combine
references/worklet/references/tool/ — runOnUI, runOnJS thread communication
6. Route — 自定义路由与转场
Path: references/route/SKILL.md
Custom route animations, preset routes, pop gesture, open-container, and Router API.
references/route/references/custom-route/ — Custom route guide & patterns
references/route/references/preset-route/ — 7 preset route types
references/route/references/pop-gesture/ — Back gesture customization
references/route/references/open-container/ — Container transitions
references/route/references/api/ — navigateTo, route events, router API
7. Scroll API — 滚动控制 API
Path: references/scroll-api/SKILL.md
ScrollViewContext, DraggableSheetContext, worklet scroll context.
references/scroll-api/references/api/ — ScrollViewContext, DraggableSheetContext, worklet scroll
references/scroll-api/references/patterns.md — Common scroll patterns
Quick Start
Enable Skyline in app.json
{
"renderer": "skyline",
"rendererOptions": {
"skyline": {
"defaultDisplayBlock": true,
"defaultContentBox": true,
"disableABTest": true
}
},
"componentFramework": "glass-easel",
"lazyCodeLoading": "requiredComponents"
}
Basic Page Structure
<scroll-view type="list" scroll-y style="height: 100vh">
<view class="container">
<!-- Page content -->
</view>
</scroll-view>
Note: In Skyline, pages do not scroll by default. You must use <scroll-view> for scrollable content.
Resources
1---
2name: skyline
3description: "WeChat Mini Program Skyline rendering engine. Use when developing with Skyline renderer, including components (scroll-view, swiper, draggable-sheet), WXSS styles, worklet animations, custom routes/transitions, scroll APIs, and Skyline configuration/migration. Trigger keywords: Skyline, Skyline渲染引擎, skyline renderer, worklet, custom-route, routeBuilder, draggable-sheet, SharedValue, applyAnimatedStyle."
4description_zh: "微信小程序 Skyline 渲染引擎(组件、动画、路由、样式)"
5description_en: "WeChat Mini Program Skyline engine (components, animations, routes, styles)"
6version: 1.0.0
7homepage: https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/introduction/
8allowed-tools: Read,Write,Bash
9metadata:
10 source: https://skillmd.com/skills/ahang1598/skyline
11---
12
13# Skyline 渲染引擎技能
14
15微信小程序 Skyline 渲染引擎的完整开发指南,涵盖组件、样式、动画、路由、滚动 API 和配置迁移。
16
17## When to Use This Skill
18
19This skill should be triggered when:
20
21- Developing WeChat Mini Programs with the Skyline rendering engine
22- Working with Skyline-specific components (scroll-view enhanced mode, draggable-sheet, share-element, etc.)
23- Implementing worklet animations (SharedValue, timing, spring, decay)
24- Using custom routes and page transitions (routeBuilder, open-container)
25- Checking WXSS/CSS property compatibility under Skyline
26- Configuring Skyline renderer in app.json / page.json
27- Migrating from WebView to Skyline
28- Using Skyline scroll APIs (ScrollViewContext, DraggableSheetContext)
29
30## Module Reference Guide
31
32This skill is organized into 7 modules. Use `Read` tool to access specific reference files when detailed information is needed.
33
34### 1. Overview — 概览与迁移指南
35
36**Path**: `references/overview/SKILL.md`
37
38Skyline architecture, performance advantages, feature overview, migration guide and best practices.
39
40- `references/overview/references/introduction/` — Architecture & features
41- `references/overview/references/migration/` — Migration guide & compatibility
42- `references/overview/references/performance/` — Performance comparison
43- `references/overview/references/api/` — getSkylineInfo, preloadSkylineView
44- `references/overview/references/changelog/` — Changelog
45
46### 2. Config — JSON 配置规范
47
48**Path**: `references/config/SKILL.md`
49
50app.json, page.json, and project.config.json configuration for Skyline.
51
52- `references/config/references/app-config.md` — App-level configuration
53- `references/config/references/page-config.md` — Page-level configuration
54- `references/config/references/project-config.md` — Project configuration
55- `references/config/references/patterns.md` — Common patterns
56
57### 3. Components — 组件开发指南
58
59**Path**: `references/components/SKILL.md`
60
61scroll-view enhanced modes, swiper, form components, media, draggable-sheet, share-element, snapshot.
62
63- `references/components/references/scroll/` — scroll-view, nested-scroll, list-grid-view, sticky, draggable-sheet
64- `references/components/references/layout/` — swiper
65- `references/components/references/form/` — input
66- `references/components/references/media/` — image, text
67- `references/components/references/special/` — share-element, snapshot
68
69### 4. WXSS — 样式支持
70
71**Path**: `references/wxss/SKILL.md`
72
73CSS property support and limitations under Skyline.
74
75- `references/wxss/references/basics.md` — Basic properties
76- `references/wxss/references/layout.md` — Layout (flex, grid)
77- `references/wxss/references/flex.md` — Flexbox details
78- `references/wxss/references/text.md` — Text properties
79- `references/wxss/references/visual.md` — Visual effects (filter, gradient, mask)
80- `references/wxss/references/animation.md` — CSS animations & transitions
81
82### 5. Worklet — 动画系统
83
84**Path**: `references/worklet/SKILL.md`
85
86Worklet functions, SharedValue, timing/spring/decay animations, easing, and thread communication.
87
88- `references/worklet/references/core/` — Worklet overview
89- `references/worklet/references/base/` — SharedValue, derived values
90- `references/worklet/references/animation/` — timing, spring, decay, easing, combine
91- `references/worklet/references/tool/` — runOnUI, runOnJS thread communication
92
93### 6. Route — 自定义路由与转场
94
95**Path**: `references/route/SKILL.md`
96
97Custom route animations, preset routes, pop gesture, open-container, and Router API.
98
99- `references/route/references/custom-route/` — Custom route guide & patterns
100- `references/route/references/preset-route/` — 7 preset route types
101- `references/route/references/pop-gesture/` — Back gesture customization
102- `references/route/references/open-container/` — Container transitions
103- `references/route/references/api/` — navigateTo, route events, router API
104
105### 7. Scroll API — 滚动控制 API
106
107**Path**: `references/scroll-api/SKILL.md`
108
109ScrollViewContext, DraggableSheetContext, worklet scroll context.
110
111- `references/scroll-api/references/api/` — ScrollViewContext, DraggableSheetContext, worklet scroll
112- `references/scroll-api/references/patterns.md` — Common scroll patterns
113
114## Quick Start
115
116### Enable Skyline in app.json
117
118```json
119{
120 "renderer": "skyline",
121 "rendererOptions": {
122 "skyline": {
123 "defaultDisplayBlock": true,
124 "defaultContentBox": true,
125 "disableABTest": true
126 }
127 },
128 "componentFramework": "glass-easel",
129 "lazyCodeLoading": "requiredComponents"
130}
131```
132
133### Basic Page Structure
134
135```html
136<scroll-view type="list" scroll-y style="height: 100vh">
137 <view class="container">
138 <!-- Page content -->
139 </view>
140</scroll-view>
141```
142
143> **Note**: In Skyline, pages do not scroll by default. You must use `<scroll-view>` for scrollable content.
144
145## Resources
146
147- [Skyline Official Documentation](https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/introduction/)
148- [Component Demo Mini Program](https://developers.weixin.qq.com/s/8Yj2sjmb7MGL)
149- [Migration Guide](https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/migration/)