# uni-app Skill

**Repository Path**: hyyyp/uni-app-skill

## Basic Information

- **Project Name**: uni-app Skill
- **Description**: 看名字你就应该知道这是什么
uni-app 官方没有针对AI做有  skill  所以只能自己做一个咯
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uni-app-skill

面向 AI 编程助手的 **uni-app 开发技能(Agent Skill)**,遵循 [Agent Skills](https://code.claude.com/docs/en/skills) 开放标准(SKILL.md + 按需加载的参考文件),可用于 Claude Code、ZCode、Codex、Cursor、Gemini CLI 等支持该规范的工具。

不同于"从文档自动抓取生成"的技能仓库,本项目按**开发工作流**手工组织:核心规则常驻、细节按需加载、排障按症状索引,目标是让 AI 生成的 uni-app 代码始终停留在跨端安全子集内,少踩"在 H5 正常、到小程序就炸"的坑。

## 技能结构

```
uni-app-skill/
├── SKILL.md                    # 铁律 + 工作流 + 交付自查清单(触发时加载)
└── references/                 # 按需加载
    ├── project-setup.md        # CLI 建项目、命令矩阵、pages.json/manifest.json 配置
    ├── components.md           # 内置组件目录:属性、平台差异、easycom 规范
    ├── api-catalog.md          # uni.* API 全模块目录(基础/网络/缓存/界面/媒体/设备/支付...)
    ├── api-quick-reference.md  # 高频 API 签名与封装范式(request wrapper 等)
    ├── platform-differences.md # 条件编译、平台差异、各端登录/支付/分享对照
    ├── lifecycle.md            # 应用/页面/组件生命周期全表与执行顺序
    ├── css-styling.md          # rpx 换算、选择器限制、CSS 变量、背景图/字体图标规则
    ├── vue3.md                 # Vue 3 组合式 API 在 uni-app 的写法与限制
    └── pitfalls.md             # 15 个高频症状 → 修复对照表
```

## 安装

**方式一:skills CLI**(推荐)

```bash
npx skills add hyyyp/uni-app-skill
```

**方式二:手动安装**

把本仓库的 `SKILL.md` 与 `references/` 放进技能目录(保持一个文件夹):

```bash
# 用户级(所有项目可用)
git clone https://gitee.com/hyyyp/uni-app-skill.git ~/.zcode/skills/uni-app
# 或 ~/.agents/skills/uni-app(Claude Code 等工具的通用位置)

# 项目级(仅当前项目)
git clone https://gitee.com/hyyyp/uni-app-skill.git your-project/.zcode/skills/uni-app
```

安装后无需配置,当对话涉及 uni-app、小程序多端开发、`uni.*` API、rpx、条件编译等话题时会自动触发;也可显式调用:`/skill uni-app`。

## 内容来源与边界

内容基于 [uni-app 官方文档](https://uniapp.dcloud.net.cn/)人工浓缩整理,覆盖:

- CLI(Vue 3 + Vite)项目创建、运行与发布
- pages.json / manifest.json 配置
- 内置组件、`uni.*` API、生命周期
- 条件编译与多端差异(小程序 / H5 / App)
- CSS 与布局、Vue 3 用法、高频陷阱

**明确不包含**(避免混淆):uni-app x(`.uvue`/`.uts` 原生运行时)、uniCloud、HBuilderX 工具链文档。

## License

[MIT](./LICENSE)