promote skills

Author: sunnylqm

site/bun.lock

@@ -38,6 +38,9 @@ function Banner({ isMobile }: BannerProps) {
 
         <div className="max-w-3xl mx-auto mb-12 animate-fade-in-up animation-delay-200">
           <p className="text-lg sm:text-xl text-slate-400 leading-relaxed font-light">
+            <span className="block mb-4 text-base sm:text-lg font-medium text-blue-100">
+              官方 Skill 已支持 AI 自动完成接入、配置检查与常见问题排查。
+            </span>
             <span className="inline-block mx-4 relative font-medium text-slate-300">高速节点勤分发</span>
             <span className="inline-block mx-4 relative font-medium text-slate-300">山河浩广若比邻</span>
             <br className="hidden sm:block" />
@@ -47,9 +50,14 @@ function Banner({ isMobile }: BannerProps) {
         </div>
 
         <div className="flex flex-col sm:flex-row items-center justify-center gap-6 animate-fade-in-up animation-delay-300">
-          <a href="/docs/intro" className="w-full sm:w-auto">
+          <a href="/docs/skills" className="w-full sm:w-auto">
             <button className="w-full sm:w-auto px-8 py-4 bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-500 hover:to-indigo-500 text-white font-bold rounded-2xl text-lg transition-all duration-300 shadow-lg shadow-blue-600/25 hover:shadow-blue-500/40 hover:-translate-y-1">
-              立即免费体验
+              优先：安装 Skill
+            </button>
+          </a>
+          <a href="/docs/getting-started" className="w-full sm:w-auto">
+            <button className="w-full sm:w-auto px-8 py-4 border border-slate-400/40 bg-slate-900/20 hover:bg-slate-900/35 text-slate-100 font-bold rounded-2xl text-lg transition-all duration-300 hover:-translate-y-1">
+              查看手动接入
             </button>
           </a>
           <div className="scale-125 transform origin-center sm:origin-left hover:scale-150 transition-transform duration-300">

site/components/home/Banner.tsx

@@ -10,19 +10,19 @@
     "start": "rspress preview"
   },
   "dependencies": {
-    "@ant-design/icons": "^6.1.0",
+    "@ant-design/icons": "^6.1.1",
     "@rsbuild/plugin-sass": "^1.5.1",
-    "@rspress/core": "^2.0.6",
+    "@rspress/core": "^2.0.7",
     "@tailwindcss/postcss": "^4.2.2",
     "@types/react-dom": "^19.2.3",
-    "antd": "^6.3.3",
+    "antd": "^6.3.4",
     "autoprefixer": "10.4.27",
     "postcss": "^8.5.8",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "rspress-plugin-mermaid": "^1.0.1",
     "sass": "^1.98.0",
     "tailwindcss": "^4.2.2",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.2"
   }
 }

site/package.json

@@ -15,6 +15,10 @@ import { Steps, Tabs, Tab } from "@rspress/core/theme";
 
 我们假设你已经拥有了开发 React Native 应用的一切环境，包括`Node.js`、`Xcode`、`Android SDK`等等。
 
+:::tip 推荐优先使用 Skill 自动接入
+如果你正在使用支持 Skills 的 AI 编程工具，建议先完成 [安装与使用 Skill](/docs/skills)，再让 AI 根据当前工程自动执行依赖安装、原生配置检查与接入改造。本页保留手动步骤，适合定制工程、混编项目或作为 AI 产出校对清单。
+:::
+
 <Steps>
 ### 安装
 

site/pages/docs/getting-started.mdx

@@ -13,6 +13,10 @@ import { Steps, Tabs, Tab } from "@rspress/core/theme";
 
 安装配置完成后，确定应用编译顺利通过，下面我们来进行代码集成。
 
+:::tip 推荐做法
+优先使用 [安装与使用 Skill](/docs/skills) 让 AI 自动完成 `UpdateProvider` 包裹、客户端初始化与常见策略配置。本页保留为手动接入参考，也适合用来校对 AI 生成的改动。
+:::
+
 ### 获取 appKey
 
 检查更新时必须提供你的`appKey`，这个值保存在`update.json`中（使用`pushy createApp`或`pushy selectApp`命令后会自动生成），并且根据平台不同而不同。你可以用如下的代码获取`appKey`：

site/pages/docs/integration.mdx

@@ -15,6 +15,10 @@ import { AppleOutlined, AndroidOutlined, HarmonyOSOutlined } from '@ant-design/i
 
 Pushy (npm 包名: [`react-native-update`](https://www.npmjs.com/package/react-native-update) <a href="https://www.npmjs.com/package/react-native-update"><img src="https://badge.fury.io/js/react-native-update.svg" alt="npm version" style={{display: 'inline', verticalAlign: 'middle', margin: '0 4px'}} /></a>) 是面向 React Native 应用提供的**专业热更新服务**，由 [React Native 中文网](https://reactnative.cn)独家研发并持续维护。我们致力于为全球 React Native 开发者提供最快速、最稳定、最经济的热更新体验。
 
+:::tip 推荐接入方式
+如果你正在使用支持 Skills 的 AI 编程工具，推荐优先阅读 [安装与使用 Skill](/docs/skills)，先安装 `react-native-update` Skill，再让 AI 根据你的项目结构自动完成大部分接入改动。手动文档更适合混编项目、monorepo 或需要逐项校对的场景。
+:::
+
 ## 🚀 为什么选择 Pushy？
 
 ### 极致的更新体验
@@ -78,11 +82,12 @@ const pushyClient = new Pushy({ appKey });
 
 ## 🚦 开始使用
 
-只需三步，即可为你的 React Native 应用添加热更新能力：
+推荐按下面的顺序完成接入：
 
-1. **[安装配置](/docs/getting-started)** - 5 分钟完成基础配置
-2. **[代码集成](/docs/integration)** - 几行代码即可接入
-3. **[发布更新](/docs/publish)** - 一条命令推送新版本
+1. **[安装与使用 Skill](/docs/skills)** - 推荐先让 AI 自动完成接入改造
+2. **[安装配置](/docs/getting-started)** - 补齐依赖与原生侧配置
+3. **[代码集成](/docs/integration)** - 校对或手动定制 `UpdateProvider` 接入
+4. **[发布更新](/docs/publish)** - 一条命令推送新版本
 
 :::info
 不确定是否适合你的项目？查看[常见问题](/docs/faq)或者可以去[issues 区](https://github.com/reactnativecn/react-native-update/issues)或 QQ 群 729013783 提问，或给我们发[邮件](mailto:hi@charmlot.com)。
@@ -91,4 +96,3 @@ const pushyClient = new Pushy({ appKey });
 
 立即开始使用 Pushy，让你的 React Native 应用拥有极致的热更新体验！
 
-

site/pages/docs/intro.mdx

@@ -1,17 +1,24 @@
 ---
-order: 9
-title: 安装与使用 Skill
-type: 进阶指南
+order: 1
+title: 推荐：先安装 Skill，再让 AI 自动集成
+type: 快速开始
 ---
 
-本文介绍如何安装并使用 `react-native-update` 的 Skill，帮助你在 AI 编程工具中更高效地完成接入、配置与排查。
+首次接入 Pushy 时，推荐先安装 `react-native-update` Skill，再让支持 Skills 的 AI 编程工具根据你的项目结构自动完成大部分集成改动。只有当工程结构特殊、需要精细控制，或者想逐项校对生成代码时，再回到后续手动文档。
 
 ## Skill 信息
 
 - Skill 名称：`react-native-update`
 - 源仓库：`reactnativecn/react-native-update-skill`
 
-## 安装（推荐）
+## 推荐工作流
+
+1. 安装 `react-native-update` Skill。
+2. 在 AI 工具中打开你的 React Native / Expo 项目根目录。
+3. 直接提出接入需求，让 AI 根据现有工程自动改造。
+4. 用 [安装配置](/docs/getting-started) 和 [代码集成](/docs/integration) 作为校对基线。
+
+## 安装（推荐优先）
 
 安装到当前环境支持的所有 Agent：
 
@@ -32,16 +39,17 @@ npx skills check
 npx skills update
 ```
 
-## 使用方式
+## 可以直接这样对 AI 说
 
 安装后，可以直接向 AI 助手提出接入需求，例如：
 
 - 在 Expo 项目中接入 `react-native-update`
 - 在 class 组件根节点中完成接入改造
+- 保留当前导航和状态管理结构，自动包裹 `UpdateProvider`
 - 配置白名单灰度发布策略
 - 排查“热更新未生效”问题
 
-## Skill 覆盖内容
+## Skill 可自动协助的内容
 
 - RN CLI / Expo 接入流程
 - `update.json` 与 `appKey` 配置检查
@@ -50,6 +58,12 @@ npx skills update
 - 常见冲突排查（如 `expo-updates`）
 - class 组件与白名单示例
 
+## 何时改用手动文档
+
+- 工程是混编原生项目、monorepo 或目录结构高度定制
+- 自动 link 或原生构建本身已经异常，需要逐项定位
+- 团队希望将 AI 生成结果与手动基线逐行比对
+
 ## 相关链接
 
 - 仓库：

site/pages/docs/skills.mdx

@@ -37,6 +37,7 @@ export default defineConfig({
           text: '快速入门',
           items: [
             { text: '产品简介', link: '/docs/intro' },
+            { text: '推荐：Skills 自动集成', link: '/docs/skills' },
             { text: '安装配置', link: '/docs/getting-started' },
             { text: '代码集成', link: '/docs/integration' },
             { text: '发布流程', link: '/docs/publish' },
@@ -50,7 +51,6 @@ export default defineConfig({
             { text: '命令行工具（内置）', link: '/docs/cli' },
             { text: '命令行工具（自定义模块）', link: '/docs/cli_module' },
             { text: '场景实践', link: '/docs/bestpractice' },
-            { text: 'Skills 安装与使用', link: '/docs/skills' },
           ],
         },
         {