skills

我的收藏

概述

lynx-miniapp-skills 是面向 Lynx 渲染抖音小程序的 Agent 能力包。它会结合项目源码、生成产物和内置差异规则，帮助开发者生成页面、检查兼容性、评估迁移风险、定位源码位置并给出可选处理方案。

可以做什么

你想做什么	可以怎么用	典型产出
从零生成 Lynx 小程序页面	提供项目路径、页面需求、UI 目标、目标路径和交互要求；支持原生小程序及 uni-app、Taro 等框架项目	项目真实源码、编译产物验证、关键约束说明、视觉和交互结果
指定页面迁移到 Lynx 渲染	提供项目路径、目标页面、原页面 UI 基线和必须保持的交互	页面级 checklist、源码适配、视觉对比、交互结果和剩余风险
评估迁移风险	提供项目路径和目标页面，要求只评估、不修改代码；特殊构建方式可按需补充	页面级 checklist、风险等级、源码位置和建议动作
修复已有 Lynx 页面	提供项目路径、页面路径、问题表现和预期结果	问题原因、源码修复、构建结果及视觉和交互验证
Review 已有适配	提供项目路径、目标页面或现有改动	兼容性问题、遗漏项、验证结论和剩余风险

使用方式

安装

执行以下命令即可将 Skyline Skills 添加到你的项目中：


npx skills add bytedance/lynx-miniapp-skills

更新

如需将 Skyline Skills 更新至最新版本，请运行：


npx skills update bytedance/lynx-miniapp-skills

以下 Prompt 均为示例，用于说明可以向 AI 提供哪些信息。页面路径、视觉目标、业务功能、迁移要求和验收点请根据实际项目替换。生成或迁移实施通常需要提供设计图、目标截图或可运行页面作为视觉基线；仅进行迁移风险评估时可以不提供 UI，但不会输出视觉还原结论。

使用示例

生成新页面

以下是一个订单列表页面生成示例，页面路径、功能和验收点请按实际项目替换。

请使用 lynx-miniapp-skills，在当前抖音小程序项目中生成一个 Lynx 页面。

目标路径：pages/order/index
目标 UI：以本 Prompt 附带的设计图或截图为准；如果无法读取附件，请先向我确认，不要自行猜测 UI。
目标状态：订单列表已有数据时的首屏状态。

页面需求：
- 展示订单状态筛选和订单列表；
- 支持下拉刷新；
- 点击订单卡片进入订单详情。

请修改项目真实源码，并完成构建、视觉和上述交互验证；未验证的场景需要明确列出。

迁移已有页面

以下是一个点餐页面迁移示例，页面路径、业务功能、迁移要求和验收点请按实际项目替换。

请使用 lynx-miniapp-skills，将 feat/webview-origin 分支中 pages/category/index 页面从 WebView 渲染迁移为 Lynx 渲染。

视觉目标：
- 以原 WebView 页面为视觉和行为基线；
- 如果本 Prompt 另附设计图，则最终视觉以设计图为准；
- 修改前后使用相同的页面状态进行对比。

示例迁移要求：
1. 首屏布局保持与视觉目标一致；
2. 点击商品可以加入购物车；
3. 多规格商品点击“选规格”后展示规格弹窗；
4. 规格弹窗中的商品图片、选项和滚动效果保持正常；
5. 检查页面依赖的组件库，必要时完成 Lynx 适配或 patch。

请修改项目真实源码，并给出视觉对比、交互验证结果和剩余问题。

适配效果对比

将普通小程序页面适配到 Lynx，效果对比如下

迁移评估示例

注意：高风险不代表完全不能迁移，高风险表示有一定适配复杂度，不一定保证一次迁移成功，迁移后需要验证列出来的风险能力。

开发者也可以根据列出来的风险项，前置评估是否阻塞主要链路。以下是一个迁移风险评估示例，输出项请按实际评估目标调整。

请使用 lynx-miniapp-skills，评估当前项目中 pages/category/index 页面从 WebView 迁移到 Lynx 的风险。

先不要修改代码，只输出：
- 页面级迁移 checklist；
- 风险对应的源码位置；
- 影响范围；
- 建议动作；
- 是否可以自动修复；
- 是否建议继续迁移。

请先根据最新源码和工程配置推断构建方式，只有无法确定时再向我询问。
本次不要求视觉还原验证；如果缺少可运行页面或 UI 基线，请将视觉风险标记为未评估。

评估结果输出

Q & A

这个 skills 包含 Lynx 能力支持全集么

不是，该 skills 是以官方文档站中的 webview 小程序全集能力为基准（原线上标准实现），列出来 Lynx 适配中的差异点，以便在生成、迁移阶段针对性适配。