Skill frontend-dev
Aplica estándares de codificación para Vue 3 y React, incluyendo restricciones de UI, reglas de TypeScript y protocolos de manejo de API.
- Estrellas en GitHub
- 1061
- Archivos
- 4
- Último commit
- 26 ago 2026
- Licencia
- —
- Herramientas permitidas
- —
¿Qué hace la skill frontend-dev?
Aplica estándares de codificación para Vue 3 y React, incluyendo restricciones de UI, reglas de TypeScript y protocolos de manejo de API.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill frontend-dev
Esta SKILL permite a los desarrolladores que construyen aplicaciones web de nivel empresarial aplicar estándares profesionales de codificación frontend para Vue 3 y React. Proporciona un marco estricto para el diseño de UI, asegurando que las interfaces se mantengan limpias y profesionales al prohibir los degradados neón, el glassmorphism y los elementos decorativos excesivos en favor de una paleta contenida de negro, blanco y gris.
Cuando un agente carga esta SKILL, aplica restricciones técnicas específicas en varios tipos de archivos, incluyendo .vue, .tsx y .ts. Guía la implementación de Vue 3 con Pinia o React 18 con Zustand, al tiempo que exige el uso de Vite para las compilaciones. La SKILL produce código que cumple con reglas estrictas de TypeScript, como requerir restricciones genéricas para las llamadas a la API y prohibir el uso de any para evadir la seguridad de tipos. También asegura que los desarrolladores gestionen estados de interacción esenciales como carga, vacío y error mediante patrones de componentes específicos.
Lo que un agente puede hacer con ella
- 1Estandarizar la estructura de componentes de Vue 3Generar un componente de Vue 3 utilizando el patrón script setup con props, emits y hooks de ciclo de vida adecuados.
- 2Forzar la integración de API con seguridad de tiposRefactorizar una llamada a la API para usar genéricos en lugar de devolver unknown o usar aserciones de tipo.
- 3Implementar un manejo de errores consistenteAsegurar que todas las solicitudes de red incluyan manejo de errores y notificaciones al usuario para respuestas que no sean exitosas.
- 4Aplicar restricciones de estilo de UIRevisar un diseño de UI para asegurar que no utilice estilos prohibidos como cyber-punk o degradados pesados.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill frontend-dev
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill frontend-dev en Plugin
/plugin marketplace add doccker/cc-use-exp /plugin install cc-use-exp@cc-use-exp
Instalar la skill frontend-dev en Claude Code
~/.claude/skills/frontend-dev/SKILL.md
$ npx degit doccker/cc-use-exp/skills/frontend-dev ~/.claude/skills/frontend-devInstalar la skill frontend-dev en Claude Code (project)
.claude/skills/frontend-dev/SKILL.md
$ npx degit doccker/cc-use-exp/skills/frontend-dev .claude/skills/frontend-devInstalar la skill frontend-dev en Codex
~/.agents/skills/frontend-dev/SKILL.md
$ npx degit doccker/cc-use-exp/skills/frontend-dev ~/.agents/skills/frontend-devInstalar la skill frontend-dev en Gemini CLI
~/.gemini/skills/frontend-dev/SKILL.md
$ npx degit doccker/cc-use-exp/skills/frontend-dev ~/.gemini/skills/frontend-devInstalar la skill frontend-dev en Claude.ai
npx degit doccker/cc-use-exp/skills/frontend-dev frontend-dev && zip -r frontend-dev.zip frontend-dev # claude.ai → Customize → Skills → + → Create skill → Upload a skill → frontend-dev.zip
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún sin verificar. Una skill necesita 80 puntos, ningún hallazgo grave y datos suficientes para comprobarla. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibledoccker/cc-use-exp/skills/frontend-dev is public and reachablegithub.com/doccker/cc-use-exp/tree/HEAD/skills/frontend-dev ↗Aprobado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit 2026-08-26github.com/doccker/cc-use-exp/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/doccker/cc-use-exp/blob/HEAD/skills/frontend-dev/ ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/doccker/cc-use-exp/blob/HEAD/skills/frontend-dev/ ↗Aprobado
- SKILL.md sigue el formato de Agent Skillsthe description does not say when to use the skillgithub.com/doccker/cc-use-exp/blob/HEAD/skills/frontend-dev/ ↗Hallazgo
SKILL.md
Ver en GitHub前端开发规范
参考来源: Vue 官方风格指南、Element Plus 最佳实践
UI 风格约束
严格禁止(常见 AI 风格)
- ❌ 蓝紫色霓虹渐变、发光描边、玻璃拟态
- ❌ 大面积渐变、过多装饰性几何图形
- ❌ 赛博风、暗黑科技风、AI 风格 UI
- ❌ UI 文案中使用 emoji
后台系统(默认风格)
| 要素 | 要求 |
|---|---|
| 主题 | 使用组件库默认主题 |
| 配色 | 黑白灰为主 + 1 个主色点缀 |
| 动效 | 克制,仅保留必要交互反馈 |
技术栈
| 层级 | Vue(首选) | React(备选) |
|---|---|---|
| 框架 | Vue 3 + TypeScript | React 18 + TypeScript |
| 构建 | Vite | Vite |
| 路由 | Vue Router 4 | React Router 6 |
| 状态 | Pinia | Zustand |
| UI 库 | Element Plus | Ant Design |
Vue 编码规范
组件基础
<script setup lang="ts">
import { ref, computed, onMounted } from 'vue'
import type { User } from '@/types'
// Props & Emits
const props = defineProps<{ userId: number }>()
const emit = defineEmits<{ (e: 'update', value: string): void }>()
// 响应式状态
const loading = ref(false)
const user = ref<User | null>(null)
// 计算属性
const displayName = computed(() => user.value?.name ?? '未知用户')
// 生命周期
onMounted(async () => { await fetchUser() })
// 方法
async function fetchUser() {
loading.value = true
try {
user.value = await api.getUser(props.userId)
} finally {
loading.value = false
}
}
</script>
<template>
<div class="user-card">
<h3>{{ displayName }}</h3>
</div>
</template>
<style scoped>
.user-card { padding: 16px; }
</style>
命名约定
| 类型 | 约定 | 示例 |
|---|---|---|
| 组件文件 | PascalCase.vue | UserCard.vue |
| Composables | useXxx.ts | useAuth.ts |
| Store | useXxxStore.ts | useUserStore.ts |
状态管理(Pinia)
// stores/user.ts
export const useUserStore = defineStore('user', () => {
const user = ref<User | null>(null)
const token = ref<string>('')
const isLoggedIn = computed(() => !!token.value)
async function login(username: string, password: string) {
const res = await api.login(username, password)
token.value = res.token
user.value = res.user
}
return { user, token, isLoggedIn, login }
})
交互状态处理
必须处理的状态: loading、empty、error、disabled、submitting
<template>
<el-skeleton v-if="loading" :rows="5" animated />
<el-result v-else-if="error" icon="error" :title="error">
<template #extra>
<el-button @click="fetchData">重试</el-button>
</template>
</el-result>
<el-empty v-else-if="list.length === 0" description="暂无数据" />
<template v-else>
<!-- 正常内容 -->
</template>
</template>
TypeScript 规范
// types/user.ts
export interface User {
id: number
username: string
role: 'admin' | 'user'
}
export interface ApiResponse<T = unknown> {
code: number
message: string
data: T
}
API 调用类型安全
| 规则 | 说明 |
|---|---|
| ✅ API 工具函数支持泛型 | get<T>(url): Promise<T> 而非返回 unknown |
| ✅ 调用处指定泛型或断言 | get<UserInfo>(url) 或 data as typeof ref.value |
❌ 禁止 as any 绕过 |
掩盖类型问题,后续维护踩坑 |
// ❌ get() 返回 unknown,赋值报 TS2322
const data = await get('/contact/config')
contact.value = data
// ❌ as any 绕过
contact.value = data as any
// ✅ 泛型约束(推荐)
const data = await get<ContactConfig>('/contact/config')
contact.value = data
// ✅ 类型断言(最小改动)
contact.value = data as typeof contact.value
性能优化
| 场景 | 方案 |
|---|---|
| 大列表 | 虚拟滚动 |
| 路由 | 懒加载 () => import() |
| 计算 | 使用 computed 缓存 |
| 大数据 | 使用 shallowRef |
// 路由懒加载
const routes = [
{ path: '/dashboard', component: () => import('@/views/Dashboard.vue') }
]
// 请求防抖
import { useDebounceFn } from '@vueuse/core'
const debouncedSearch = useDebounceFn((keyword) => api.search(keyword), 300)
目录结构
src/
├── assets/
│ └── styles/ # 全局/共享样式
├── api/ # API 请求
├── components/ # 通用组件
├── composables/ # 组合式函数
├── router/ # 路由配置
├── stores/ # Pinia stores
├── types/ # TypeScript 类型
├── utils/ # 工具函数
├── views/ # 页面组件
├── App.vue
└── main.ts
样式管理规范
| 规则 | 说明 |
|---|---|
❌ 禁止在 .vue 中写大段样式 |
<style> 块不超过 20 行 |
❌ 禁止在 .tsx 中写大段内联样式 |
样式对象/CSS-in-JS 不超过 20 行 |
✅ 共享样式抽到 src/assets/styles/ |
按模块拆分文件 |
| ✅ 组件内只保留极简样式 | Vue: scoped 微调;React: className 引用 |
src/assets/styles/
├── variables.scss # 变量(颜色、间距、字号)
├── common.scss # 通用样式
└── [module].scss # 按模块拆分
请求体完整性规范
| 规则 | 说明 |
|---|---|
| ❌ 禁止 UI 可选字段未传入 API | 用户选择/输入的字段必须全部传入请求体 |
| ✅ 提交函数与表单字段一一对应 | 用 TypeScript interface 约束请求体 |
// ❌ UI 有支付方式选择器,但请求体没传 payMethod
const payMethod = ref<'wechat' | 'points' | 'mixed'>('wechat')
async function createOrder() {
await api.createOrder({
items: orderItems.value,
addressId: selectedAddress.value.id,
// payMethod 忘记传了!支付方式选择 UI 形同虚设
})
}
// ✅ 请求体与 UI 表单字段对应
interface CreateOrderRequest {
items: OrderItem[]
addressId: number
payMethod: 'wechat' | 'points' | 'mixed' // 类型约束确保不遗漏
}
async function createOrder() {
const request: CreateOrderRequest = {
items: orderItems.value,
addressId: selectedAddress.value.id,
payMethod: payMethod.value, // TypeScript 会提示缺少字段
}
await api.createOrder(request)
}
API 错误处理规范
| 规则 | 说明 |
|---|---|
| ❌ 禁止静默忽略非成功响应 | res.code !== 200 时必须提示用户 |
| ✅ 统一错误提示 | 非成功响应统一 message.error 提示 |
| ✅ 网络异常也要处理 | try/catch 捕获请求异常 |
// ❌ 只处理成功,非 200 静默忽略
const res = await api.getList(params)
if (res.code === 200) {
list.value = res.data
}
// ✅ 成功 + 失败都处理
try {
const res = await api.getList(params)
if (res.code === 200) {
list.value = res.data
} else {
message.error(res.message || '加载失败')
}
} catch (e) {
message.error('网络异常,请稍后重试')
}
类型复用规范
| 规则 | 说明 |
|---|---|
| ❌ 禁止多个文件重复定义相同接口 | PageResponse、BaseResult 等 |
✅ 通用类型统一放 @/types/common.ts |
全局导出,各处引用 |
// ❌ 每个 api 文件都定义一遍
// api/user.ts
interface PageResponse<T> { list: T[]; total: number }
// api/order.ts
interface PageResponse<T> { list: T[]; total: number } // 重复
// ✅ 统一定义,各处引用
// types/common.ts
export interface PageResponse<T> {
list: T[]
total: number
}
// api/user.ts
import type { PageResponse } from '@/types/common'
详细参考
| 文件 | 内容 |
|---|---|
references/frontend-style.md |
UI 风格、Vue 3 规范、Pinia、API 封装、性能优化 |
references/miniapp-pitfalls.md |
uni-app 陷阱:页面栈只读、Storage 清理时机、生命周期双触发、前端校验镜像 |
references/date-time.md |
dayjs/date-fns 日期加减、账期计算、禁止月末对齐 |
📋 本回复遵循:
frontend-dev- [具体章节]
Archivos de esta skill
4Preguntas sobre la skill frontend-dev
¿Cómo instalo la skill frontend-dev en Claude Code?
Ejecuta npx degit doccker/cc-use-exp/skills/frontend-dev ~/.claude/skills/frontend-dev. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill frontend-dev?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Qué estilos de UI están prohibidos?
Los estándares prohíben estrictamente los degradados neón, bordes brillantes, glassmorphism, degradados a gran escala, formas geométricas decorativas excesivas, estilos cyber/AI y el uso de emojis en los textos de la interfaz.
¿Cómo se deben manejar los errores de la API?
No debes ignorar silenciosamente las respuestas que no sean exitosas; si el código de respuesta no es 200, se debe mostrar un mensaje de error unificado al usuario y las excepciones de red deben capturarse usando try/catch.
¿Cuáles son las convenciones de nombres para componentes y composables de Vue?
Los archivos de componentes deben usar PascalCase (por ejemplo, UserCard.vue) y los composables deben seguir el patrón useXxx.ts (por ejemplo, useAuth.ts).