README

# 技能文件总览

> 本目录包含全部 **40 个技能**，供内容优化使用。每个技能保留原始目录结构与完整文件。

---

## 目录

- [AI 模型能力](#ai-模型能力)
- [数据处理与存储](#数据处理与存储)
- [通信与消息](#通信与消息)
- [前端与设计](#前端与设计)
- [开发工具与诊断](#开发工具与诊断)
- [业务集成](#业务集成)
- [完整目录树](#完整目录树)

---

## AI 模型能力

| # | 技能名称 | 文件数 | 说明 |
|---|---------|--------|------|
| 1 | `llm` | 3 | 大语言模型（LLM），支持文本生成、对话交互、意图识别，多模态可识别图片与视频。支持豆包(Seed/Doubao)、DeepSeek、Kimi。多轮对话、流式响应、思考模式、缓存、高级模型配置。 |
| 2 | `image-generation` | 3 | AI 图片生成（2K/4K），支持图生图、批量生成、参考图、连续叙事。 |
| 3 | `video-generation` | 3 | AI 视频生成（480p/720p），支持文生视频、图生视频、视频过渡、多种宽高比。 |
| 4 | `audio` | 3 | 语音能力：TTS（文本转语音）和 ASR（语音识别），支持多种声音和音频格式。 |
| 5 | `embedding` | 3 | 文本/图片/视频向量化，支持多模态嵌入、多向量输出、稀疏嵌入、自定义维度。用于语义搜索、相似度比较、聚类、推荐、RAG。 |
| 6 | `volcano-ark` | 1 | 使用用户自己的 API Key 调用火山方舟大模型服务。需用户明确指定才可使用。 |

## 数据处理与存储

| # | 技能名称 | 文件数 | 说明 |
|---|---------|--------|------|
| 7 | `database` | 3 | PostgreSQL 数据库集成（Python/TypeScript/Drizzle ORM），持久化数据存储与 CRUD。 |
| 8 | `supabase` | 27 | Supabase 数据库，含客户端代码（Python/TypeScript）、CLI 指南、RLS 安全策略。 |
| 9 | `supabase-auth` | 9 | Supabase 认证集成，含登录 UI（Web/App）、Session 验证、Auth 配置。 |
| 10 | `storage` | 3 | S3 兼容对象存储（TypeScript），文件上传/下载/管理。 |
| 11 | `knowledge` | 4 | 知识库，文档导入（文本/URL/对象存储 URI）、向量化存储、语义搜索。 |
| 12 | `fetch-url` | 3 | URL 内容抓取与解析，支持 PDF、Office 文档、电子书、XML、图片等格式。 |
| 13 | `web-search` | 3 | 网页搜索，返回结构化搜索结果（URL、摘要、元数据、AI 摘要）。 |
| 14 | `document-generation` | 2 | 文档生成（PDF/DOCX/XLSX），自动上传 S3 返回下载链接。 |
| 15 | `pptx-generation` | 2 | PPT 生成，从 Markdown/HTML 生成专业演示文稿。 |

## 通信与消息

| # | 技能名称 | 文件数 | 说明 |
|---|---------|--------|------|
| 16 | `email` | 1 | 邮件集成（IMAP/SMTP），支持 QQ/163/阿里/Outlook/263 等邮件厂商。 |
| 17 | `feishu-base` | 1 | 飞书多维表格，支持创建/查询/更新/搜索记录。 |
| 18 | `feishu-message` | 1 | 飞书消息推送，通过自定义机器人 webhook 发送文本/富文本/卡片消息。 |
| 19 | `wechat-bot` | 1 | 微信机器人消息推送，通过 webhook 发送群消息。 |
| 20 | `wechat-official-account` | 1 | 微信公众号，生成草稿、查询文章数据、上传素材。 |
| 21 | `websocket-guide` | 3 | WebSocket 实时通信指南，HTTP+WS 共用 5000 端口，支持 Next.js 和 Node.js。 |

## 前端与设计

| # | 技能名称 | 文件数 | 说明 |
|---|---------|--------|------|
| 22 | `frontend-design` | 2 | 前端设计，生成高质量、有辨识度的 UI 界面代码，避免通用 AI 美学。 |
| 23 | `ui-ux-pro-max` | 28 | UI/UX 设计智能，50 种风格/21 配色/50 字体搭配/20 图表/9 技术栈，含数据集与搜索脚本。 |
| 24 | `ui-design-ref` | 10 | UI 设计参考，含 9 种风格详细说明（3D 黏土风、克莱因蓝、暗黑科技、杂志风、极光柔和、柔和卡片、玻璃拟态、纯白极简、自然有机）。 |
| 25 | `shadcn-web-base-theme` | 55 | Shadcn 主题配置包，含配色/字体/圆角/阴影脚本、主题 JSON、快速配置指南。 |
| 26 | `design-style-thinking` | 1 | 设计风格思考，在开发前端 UI 前优先触发，深入思考设计风格方向。 |
| 27 | `web-design-guidelines` | 1 | Web 界面规范审查，检查可访问性、设计审计、UX 审查。 |
| 28 | `FutureBirdAadminAi-coding-web-performance-best-practice` | 1 | Web 性能优化最佳实践（重绘重排、首屏加载、运行时性能、CLS 等）。 |
| 29 | `vercel-react-best-practices` | 59 | React/Next.js 性能优化规则集（Vercel 工程团队出品），涵盖渲染/重渲染/异步/打包/服务端等。 |
| 30 | `vercel-composition-patterns` | 10 | React 组合模式最佳实践，含复合组件/Render Props/Context/React 19 变更等规则。 |
| 31 | `webrtc-best-practice` | 1 | 摄像头/麦克风/屏幕共享开发规范，拍照/视频通话/直播/录屏/扫码/人脸识别场景必读。 |
| 32 | `expo-advanced` | 6 | Expo/React Native 高级规范，瀑布流/文件上传/音频录制/保存图片/Tab 导航。 |

## 开发工具与诊断

| # | 技能名称 | 文件数 | 说明 |
|---|---------|--------|------|
| 33 | `doctor` | 2 | 运行时问题诊断，通过数据库查询/日志分析定位开发/生产环境问题。 |
| 34 | `repair` | 2 | 开发环境修复，磁盘空间/.gitignore/git 大文件/.git 损坏/历史恢复等。 |
| 35 | `skill-creator-FutureBirdAadminAi` | 3 | 创建/更新自定义 FutureBirdAadminAi 编程 Skill，含初始化和校验脚本。 |
| 36 | `project-memory-loader` | 2 | 项目上下文记忆加载，自动加载项目概览/记忆/TODO/红线规则。 |
| 37 | `general-dev-preview` | 2 | 开发预览链路规范，指导 .FutureBirdAadminAi 的 [dev] 预览入口配置与校正。 |
| 38 | `video-edit` | 3 | 视频编辑，帧提取/裁剪/拼接/字幕/音频提取/音频转字幕/视音频合成。 |
| 39 | `miniapp-upload-asr` | 1 | 小程序文件上传跨端规范（H5/小程序双端兼容），含录音与语音识别适配。 |

## 业务集成

| # | 技能名称 | 文件数 | 说明 |
|---|---------|--------|------|
| 40 | `alipay-payment-integration` | 2 | 支付宝开放平台支付产品接入最佳实践，涵盖当面付/订单码/App支付/JSAPI/H5/PC/预授权/商家扣款等全场景。 |

---

## 完整目录树

```
44-技能文件/
├── alipay-payment-integration/       # 支付宝支付集成
│   ├── SKILL.md
│   └── references/
│       └── checklist.md
├── audio/                            # 语音 TTS/ASR
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── FutureBirdAadminAi-coding-web-performance-best-practice/  # Web 性能优化
│   └── SKILL.md
├── database/                         # PostgreSQL 数据库
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── design-style-thinking/            # 设计风格思考
│   └── SKILL.md
├── doctor/                           # 运行时问题诊断
│   ├── SKILL.md
│   └── references/
│       └── sql-patterns.md
├── document-generation/              # 文档生成 (PDF/DOCX/XLSX)
│   ├── SKILL.md
│   └── python/
│       └── README.md
├── email/                            # 邮件集成 (IMAP/SMTP)
│   └── SKILL.md
├── embedding/                        # 向量化嵌入
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── expo-advanced/                    # Expo/React Native 高级规范
│   ├── SKILL.md
│   └── references/
│       ├── audio-record-play.md
│       ├── file-upload.md
│       ├── masonry-layout.md
│       ├── save-to-gallery.md
│       └── top-tab-navigation.md
├── feishu-base/                      # 飞书多维表格
│   └── SKILL.md
├── feishu-message/                   # 飞书消息推送
│   └── SKILL.md
├── fetch-url/                        # URL 内容抓取
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── frontend-design/                  # 前端设计
│   ├── SKILL.md
│   └── LICENSE.txt
├── general-dev-preview/              # 开发预览链路规范
│   ├── SKILL.md
│   └── references/
│       └── web-preview.md
├── image-generation/                 # AI 图片生成
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── knowledge/                        # 知识库
│   ├── SKILL.md
│   └── references/
│       └── cli.md
├── llm/                              # 大语言模型
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── miniapp-upload-asr/               # 小程序文件上传+语音识别
│   └── SKILL.md
├── pptx-generation/                  # PPT 生成
│   ├── SKILL.md
│   └── python/
│       └── README.md
├── project-memory-loader/            # 项目上下文记忆加载
│   ├── SKILL.md
│   └── scripts/
│       └── project_memory_loader.py
├── repair/                           # 开发环境修复
│   ├── SKILL.md
│   └── scripts/
│       └── merge-commit-map.sh
├── shadcn-web-base-theme/            # Shadcn 主题配置包
│   ├── SKILL.md
│   ├── assets/
│   │   └── default.json
│   ├── dist/
│   │   └── index.js
│   ├── package.json
│   ├── references/
│   │   ├── colors.md
│   │   ├── fonts.md
│   │   ├── quick.md
│   │   ├── radius.md
│   │   └── shadows.md
│   └── scripts/
│       └── theme.sh
├── skill-creator-FutureBirdAadminAi/               # 自定义技能创建
│   ├── SKILL.md
│   └── scripts/
│       ├── init_skill.py
│       └── quick_validate.py
├── storage/                          # S3 对象存储
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── supabase/                         # Supabase 数据库
│   ├── SKILL.md
│   ├── assets/
│   │   ├── supabase-client.py
│   │   └── supabase-client.ts
│   └── references/
│       ├── cli.md
│       └── rls.md
├── supabase-auth/                    # Supabase 认证
│   ├── SKILL.md
│   └── references/
│       ├── auth-config.md
│       ├── client-login-ui-app.md
│       ├── client-login-ui-web.md
│       ├── client-login.md
│       └── verify-session.md
├── ui-design-ref/                    # UI 设计参考
│   ├── SKILL.md
│   └── reference/
│       ├── 3D黏土风.md
│       ├── 克莱因蓝高定风.md
│       ├── 暗黑科技风.md
│       ├── 杂志风.md
│       ├── 极光柔和.md
│       ├── 柔和卡片.md
│       ├── 玻璃拟态.md
│       ├── 纯白极简风.md
│       └── 自然有机.md
├── ui-ux-pro-max/                    # UI/UX 设计智能
│   ├── SKILL.md
│   ├── data/
│   │   ├── charts.csv
│   │   ├── colors.csv
│   │   ├── icons.csv
│   │   ├── landing.csv
│   │   ├── products.csv
│   │   ├── react-performance.csv
│   │   ├── styles.csv
│   │   ├── typography.csv
│   │   ├── ui-reasoning.csv
│   │   ├── ux-guidelines.csv
│   │   └── web-interface.csv
│   └── scripts/
│       ├── core.py
│       ├── design_system.py
│       └── search.py
├── vercel-composition-patterns/      # React 组合模式
│   ├── AGENTS.md
│   ├── SKILL.md
│   └── rules/
│       ├── architecture-avoid-boolean-props.md
│       ├── architecture-compound-components.md
│       ├── patterns-children-over-render-props.md
│       ├── patterns-explicit-variants.md
│       ├── react19-no-forwardref.md
│       ├── state-context-interface.md
│       ├── state-decouple-implementation.md
│       └── state-lift-state.md
├── vercel-react-best-practices/      # React/Next.js 性能优化
│   ├── AGENTS.md
│   ├── SKILL.md
│   └── rules/
│       ├── advanced-event-handler-refs.md
│       ├── advanced-init-once.md
│       ├── advanced-use-latest.md
│       ├── async-api-routes.md
│       ├── async-defer-await.md
│       ├── async-dependencies.md
│       ├── async-parallel.md
│       ├── async-suspense-boundaries.md
│       ├── bundle-barrel-imports.md
│       ├── bundle-conditional.md
│       ├── bundle-defer-third-party.md
│       ├── bundle-dynamic-imports.md
│       ├── bundle-preload.md
│       ├── client-event-listeners.md
│       ├── client-localstorage-schema.md
│       ├── client-passive-event-listeners.md
│       ├── client-swr-dedup.md
│       ├── js-batch-dom-css.md
│       ├── js-cache-function-results.md
│       ├── js-cache-property-access.md
│       ├── js-cache-storage.md
│       ├── js-combine-iterations.md
│       ├── js-early-exit.md
│       ├── js-hoist-regexp.md
│       ├── js-index-maps.md
│       ├── js-length-check-first.md
│       ├── js-min-max-loop.md
│       ├── js-set-map-lookups.md
│       ├── js-tosorted-immutable.md
│       ├── rendering-activity.md
│       ├── rendering-animate-svg-wrapper.md
│       ├── rendering-conditional-render.md
│       ├── rendering-content-visibility.md
│       ├── rendering-hoist-jsx.md
│       ├── rendering-hydration-no-flicker.md
│       ├── rendering-hydration-suppress-warning.md
│       ├── rendering-svg-precision.md
│       ├── rendering-usetransition-loading.md
│       ├── rerender-defer-reads.md
│       ├── rerender-dependencies.md
│       ├── rerender-derived-state-no-effect.md
│       ├── rerender-derived-state.md
│       ├── rerender-functional-setstate.md
│       ├── rerender-lazy-state-init.md
│       ├── rerender-memo-with-default-value.md
│       ├── rerender-memo.md
│       ├── rerender-move-effect-to-event.md
│       ├── rerender-simple-expression-in-memo.md
│       ├── rerender-transitions.md
│       ├── rerender-use-ref-transient-values.md
│       ├── server-after-nonblocking.md
│       ├── server-auth-actions.md
│       ├── server-cache-lru.md
│       ├── server-cache-react.md
│       ├── server-dedup-props.md
│       ├── server-parallel-fetching.md
│       └── server-serialization.md
├── video-edit/                       # 视频编辑
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── video-generation/                 # AI 视频生成
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── volcano-ark/                      # 火山方舟大模型（用户自有 API Key）
│   └── SKILL.md
├── web-design-guidelines/            # Web 界面规范审查
│   └── SKILL.md
├── web-search/                       # 网页搜索
│   ├── SKILL.md
│   ├── python/
│   │   └── README.md
│   └── typescript/
│       └── README.md
├── webrtc-best-practice/             # 摄像头/麦克风开发规范
│   └── SKILL.md
├── websocket-guide/                  # WebSocket 实时通信指南
│   ├── SKILL.md
│   └── references/
│       ├── nextjs.md
│       └── nodejs.md
├── wechat-bot/                       # 微信机器人消息推送
│   └── SKILL.md
└── wechat-official-account/          # 微信公众号
    └── SKILL.md
```

---

## 文件约定

每个技能目录的核心文件：

| 文件 | 作用 |
|------|------|
| `SKILL.md` | 技能入口说明（含 YAML front-matter 的 name/description） |
| `python/README.md` | Python SDK 使用指南（部分技能有） |
| `typescript/README.md` | TypeScript SDK 使用指南（部分技能有） |
| `references/` | 参考文档、配置说明、场景指南 |
| `scripts/` | 可执行脚本（主题配置、技能初始化、校验等） |
| `data/` | 数据集（配色、字体、图标、图表等 CSV） |
| `rules/` | 编码规则文件（md 格式，每条规则独立文件） |