Uniapp Crossplatform Audit Skill logo

Uniapp Crossplatform Audit Skill

Community
jiushiwon
uniapp-crossplatform-audit-skill

当用户要求检查 uniapp 项目在多端(微信小程序 / H5 / App / 抖音小程序等)的兼容性、排查平台差异问题、审查条件编译使用或确认三端表现一致性时触发。本 skill 输出跨平台兼容性审计报告,**不修改、不修复项目代码**。

Overview

Publisherjiushiwon
Repositorywg-skills
Skill nameuniapp-crossplatform-audit-skill
Stars
123
Forks
38
Bundled files
1
LicenseApache-2.0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 1 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by jiushiwon on GitHub. Read the source before you install it.

Installation

Install the Uniapp Crossplatform Audit Skill AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/jiushiwon/wg-skills/tree/main/vibeCoding/frontend/uniapp/uniapp-crossplatform-audit-skill
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/jiushiwon/wg-skills.git /tmp/wg-skills
mkdir -p .claude/skills
cp -r /tmp/wg-skills/vibeCoding/frontend/uniapp/uniapp-crossplatform-audit-skill .claude/skills/uniapp-crossplatform-audit-skill
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Uniapp Crossplatform Audit Skill in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Uniapp Crossplatform Audit Skill on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Uniapp Crossplatform Audit Skill is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

UniApp Cross-Platform Audit Skill

定位

本 skill 专门审计 uniapp 项目在三端(小程序 / H5 / App)运行时的兼容性问题,识别 H5 标签、浏览器 API、样式兼容性、条件编译缺失、平台配置缺陷等导致"一端正常、另一端崩溃"的隐患,仅输出 uniapp-crossplatform-audit-report.md 报告,不修改、不修复、不重构项目代码。

与 uniapp-code-audit-skill 的区别:本 skill 是专项深度审计,覆盖跨平台维度所有端间差异细节;uniapp-code-audit-skill 是全维度体检(10 维度),跨平台只是其中一维。

When to Use

触发此 skill 时使用:

  • "跨平台审计"
  • "小程序 App 兼容"
  • "多端兼容检查"
  • "uniapp 三端表现差异"
  • "H5 标签能不能跑小程序"
  • "条件编译写得对不对"
  • "App 端和小程序端有哪些坑"

Workflow

Phase 1: 审计范围确认
   目标平台:微信小程序 / H5 / App / 其他小程序
   端数:2 端 / 3 端 / N 端
   重点维度:模板标签 / 样式兼容 / API 兼容 / 条件编译 / 平台配置

Phase 2: 多维度扫描
   按下列 6 个维度逐项扫描
   记录问题位置、风险等级、判定依据

Phase 3: 问题汇总
   按 P0/P1/P2/P3 风险等级归类
   列出"端间表现差异"专项问题

Phase 4: 输出报告
   生成 uniapp-crossplatform-audit-report.md

审计维度

维度主要内容
模板标签<div> <span> <p> <h1~h6> <img> <ul> 等 H5 标签在小程序端失效
样式兼容background-image、CSS 变量跨端差异、px/rpx 混用、vw/vh 适配问题
API 调用fetch/window/document/localStorage/alert 在小程序端不可用
条件编译#ifdef MP-WEIXIN #ifdef APP-PLUS #ifdef H5 使用是否完整
平台配置manifest.json 中 mp-weixin/h5/app-plus 各端差异化字段
端间表现差异同一逻辑在三端的表现不一致(如键盘、滚动、安全区、支付回调)

风险等级

等级说明
P0 / Critical某端完全无法运行或审核被拒
P1 / High某端功能失效或行为异常
P2 / Medium某端表现降级或样式不一致
P3 / Low微小差异,建议优化

风险等级仅用于报告分类,不代表修复指令。

输出格式

生成 uniapp-crossplatform-audit-report.md,按风险等级分组列出问题,每条问题注明:

  • 维度
  • 风险等级
  • 位置(文件 + 行号)
  • 风险描述
  • 判定依据
  • 参考标准(uniapp-app-generate-skill/references/cross-platform-compatibility.md 等)

参考标准

  • uniapp-app-generate-skill/references/cross-platform-compatibility.md — 跨平台规范
  • uniapp-standard-skill — 红线规则
  • uni-app 官方文档 — 各端 API 兼容表
  • 微信小程序官方限制 — 包体积、合法域名、隐私接口

可配合技能

配合 Skill场景
uniapp-code-audit-skill跨平台仅是 10 维度之一,需要全维度审计时调用
uniapp-app-generate-skill按报告进行项目骨架调整
uniapp-diagnostic-skill按报告进行项目规范化

扫描方式

优先使用 Grep 等只读工具扫描。允许使用的命令示例:

bash
# # H5 标签扫描
grep -rnE '<div|<span|<p|<h[1-6]|<img|<section|<article|<main' src/

# 小程序端不可用 API
grep -rnE 'fetch\(|window\.|document\.|localStorage|sessionStorage' src/

# 条件编译使用
grep -rnE '#ifdef MP-WEIXIN|#ifdef APP-PLUS|#ifdef H5' src/

端间表现差异专项(键盘 / 胶囊 / 安全区)

这三项是「一端正常、另一端被遮」的高发区,必须逐项扫,判据见 uniapp/AGENTS.md §9:

bash
# 胶囊避让:自定义导航是否读了胶囊位置
grep -rn 'getMenuButtonBoundingClientRect' src/

# 键盘顶起:输入框是否声明 adjust-position
grep -rnE '<input|<textarea' src/ | grep -v 'adjust-position'

# 键盘顶起:固定底栏是否处理键盘高度
grep -rn 'onKeyboardHeightChange' src/

# 安全区:四边是否都处理(只出现 bottom 视为 P2)
grep -rn 'env(safe-area-inset' src/

上述规则的自动判定已脚本化,直接跑:

bash
node ../uniapp-code-audit-skill/scripts/check-miniprogram.js <项目根目录>
维度判定要点
胶囊避让自定义导航页必须读胶囊位置;标题不得与胶囊同排;右侧内容需预留胶囊宽度
键盘顶起输入框统一 adjust-position + cursor-spacing;固定底栏按键盘高度上移
安全区顶边用 statusBarHeight 实测值;底边用 env(safe-area-inset-bottom);fixed 元素有等高占位
登录四态loading / error / disabled / 重试 四态齐全(AGENTS.md §9.4)

禁止在扫描过程中使用任何会修改项目的命令(如 rm、mv、sed -i、自动格式化等)。

自我审计

本 skill 升级后,应核对:

  • SKILL.md 与 README.md 触发词一致
  • 审计维度齐全(6 个)
  • 不输出修复代码
  • 参考标准无死链

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Uniapp Crossplatform Audit Skill AI skill do?

当用户要求检查 uniapp 项目在多端(微信小程序 / H5 / App / 抖音小程序等)的兼容性、排查平台差异问题、审查条件编译使用或确认三端表现一致性时触发。本 skill 输出跨平台兼容性审计报告,**不修改、不修复项目代码**。

Why use Uniapp Crossplatform Audit Skill on TypingMind?

Because you install it once and use it with any model. Uniapp Crossplatform Audit Skill is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Uniapp Crossplatform Audit Skill in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/jiushiwon/wg-skills/tree/main/vibeCoding/frontend/uniapp/uniapp-crossplatform-audit-skill. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Uniapp Crossplatform Audit Skill?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Uniapp Crossplatform Audit Skill?

As many as you like. As long as a model supports skills, you can use Uniapp Crossplatform Audit Skill with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Uniapp Crossplatform Audit Skill AI skill free?

Yes. It is published on GitHub by jiushiwon under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇