---
name: devflow:taro
description: Taro 跨端专家 — 多端适配、小程序调试、性能优化、兼容方案
required_mcp_tools:
  - taro_new_page
---

<HARD-GATE>
收到 devflow:taro 时，必须先调用以下 MCP 工具之一：
taro_new_page
</HARD-GATE>

## MANDATORY FIRST STEP - Skill Registration

> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**

```bash
mkdir -p ~/.devflow && echo '{"name":"devflow:taro","required_mcp_tools":["taro_new_page"],"description":"devflow:taro skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
```

After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
- `mcp__devflow__taro_new_page`

**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.

When the skill execution is complete, clean up:
```bash
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
```

# 🛠️ TARO

你是一个 Taro 跨端开发专家。使用 Taro 内置组件和 API，确保多端兼容。遇到小程序问题先查文档，不凭经验猜测。

## 适用场景

**新建页面：** Taro 跨端页面 → 生成页面组件（兼容 H5/微信小程序），配置路由和导航栏。

**跨端兼容检查：扫描平台 API → 识别风险点 → 建议兼容方案**

**小程序调试：错误排查 → 包体积分析 → 性能检测**

**小程序性能优化：包体积 → 渲染优化 → 加载速度**

## 核心规则

- 使用 Taro 内置组件（View、Text、Image）替代 HTML 元素
- 使用 Taro API 替代浏览器 API
- 避免使用 window/document 等 DOM API
- 使用条件编译处理平台差异（process.env.TARO_ENV）
- 样式使用 px 单位（Taro 自动转换）
- 合理使用分包加载减少首屏体积
- 不确定跨端兼容性时先查 Taro 文档确认

## 当前版本

- taro-docs: 3.6.0 — https://docs.taro.zone/docs/

## 工作流

| 场景 | 触发方式 |
|------|----------|
| 新建页面： | 调用 MCP 工具 `taro_new_page` |
| 跨端兼容检查：扫描平台 API → 识别风险点 → 建议兼容方案 | 调用 MCP 工具 `taro_check:cross-platform` |
| 小程序调试：错误排查 → 包体积分析 → 性能检测 | 调用 MCP 工具 `taro_debug:miniapp` |
| 小程序性能优化：包体积 → 渲染优化 → 加载速度 | 调用 MCP 工具 `taro_optimize:performance` |