Claude Skills para Vue3 + TypeScript + Nuxt
SirGuanZz/claude-skills
Skills estruturadas para dev Vue3+TS+Nuxt em 4 estágios
Ver no GitHubConjunto de skills especializadas para desenvolvimento frontend com Vue3, TypeScript e Nuxt, organizadas em quatro estágios: inicialização de projeto, análise de requisitos, geração de código e revisão. Inclui ferramentas para projetos web, mini-apps e análise estruturada de codebase.
Instalação
npx convez-ai SirGuanZz/claude-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Inicializar projetos Vue3/Nuxt/H5 com stack definido
- Analisar impacto de requisitos antes de codificar
- Gerar componentes e páginas com convenções do projeto
- Review especializado em performance e vazamento de memória
- Análise estruturada de codebase existente
Veredito

Skill madura e bem-organizada para times Vue3+Nuxt, com fluxo claro em quatro estágios e foco em análise antes da codificação. Requer contexto de projeto bem definido para máxima efetividade, mas oferece automações valiosas em scaffold e revisão especializada.
README
A tradução para o português deste README ainda está na fila.
claude-skills
个人 Agent Skills 仓库,面向 Vue3 + TypeScript + Nuxt 与 uni-app 微信小程序 的日常开发。同时支持 Claude Code 与 Cursor。
按 起项目 → 分析需求 → 写代码 → 审查代码 四阶段组织,详见 工作顺序。
目录:
Skills 详解
fe-project-init
从零搭 PC / 移动 H5 项目骨架。
- 触发:
/fe-project-init、"新建 H5 项目"、"从零搭项目"、"起一个前端项目" - 产出:Vue3 + Vite / Nuxt3 / React / Next 骨架;多域名拦截器;Tailwind 设计纪律(双字族 + brand 十档色阶 + 渐变背景 + 4.5:1 对比度);可选会员管理
- 流程:10 问收集需求(技术栈 / 纯静态或有接口 / PC 是否自适应移动 / 会员等),答完自动执行到底,不再二次确认
- 附带:关键文件写文件头中文注释(职责 / 依赖方 / 修改注意点),项目
README.md写目录导读表;禁止"定义变量""导入路由"类废话注释
mp-project-init
从零搭 微信小程序 项目骨架(uni-app + Vue3 + Vite + TS)。
- 触发:
/mp-project-init、"新建小程序"、"起个微信小程序"、"搭小程序架子" - 产出:uni-app 骨架;tabBar + 登录页;
envVersion域名切换;rpx 适配;业务方向可选商城 / 新闻 / 视频 - 流程:5 问收集需求(方向 / 样式 / 域名 / 会员等),答完自动执行到底
- 附带:关键文件写文件头中文注释(职责 / 依赖方 / 修改注意点),项目
README.md写目录导读表;pages.json等 JSON 无法注释的内容统一写在 README;禁止"定义变量""导入路由"类废话注释
codebase-parse
深度只读解析整个项目代码,输出结构化代码说明书。
- 触发:
/codebase-parse、"解析代码"、"解析整个项目"、"梳理页面逻辑"、"梳理接口"、"看看动效怎么实现的" - 产出:技术栈(声明 vs 实际使用)、项目逻辑、接口端点总表、全量页面索引、核心页深解(默认 ≤10 页)、动效清单
- 范围:Vue / Nuxt / uni-app / React / Next.js / Electron / monorepo
- 默认深度:索引 + 核心页深解;可选
scripts/scan-index.sh加速扫描 - 纪律:只读不改代码;结论须带文件证据;评单条需求改动走
req-analyze
req-analyze
拿到需求后先做落点分析,只读不改代码。
- 触发:
/req-analyze、"分析这个需求"、"这个需求要改哪里"、"影响范围"、"改页面还是加功能" - 产出:判断"改页面 / 加功能 / 加组件"的类型;建议改动文件清单;关联组件影响;关联功能风险;实施顺序
- 纪律:结论必须基于需求文本 + 当前项目代码证据,不脑补
详见 req-analyze/
vue-component-gen
生成 Vue3 + TS + Nuxt 组件 / 页面骨架。
- 触发:
/vue-component-gen、"生成组件"、"建一个 xxx 页面"、"写个 xxx 组件"、"搭个骨架" - 产出:组件 / 页面骨架;自动套用项目的 UI 库 / 状态库 / 请求封装
- 约定读取:自动读
config/design.ts(端 / 单位)和config/env.ts(域名);移动端按 750 稿 rpx / rem 适配
vue-fe-review
Vue 代码专项 review,只读不改、只做三件事。
- 触发:
/vue-fe-review、"review 一下"、"看看这段代码"、"检查内存泄漏"、"看看加载速度" - 关注:
- 代码错误 — 响应式陷阱 / SSR 反模式 / 路由 404 / 危险非空断言等运行时 bug
- 加载速度 — 首屏包体积 / 请求瀑布 / 图片与字体 / 懒加载
- 内存泄漏 — 未清理的监听器 / 定时器 / observer / 大列表 / 深响应式大对象
- 流程:默认扫当前
git diff;一轮 + 自省一次后收口;分级 🔴 必改 / 🟡 建议改 - 不管:安全深扫、测试覆盖(走
pre-pr-review);类型完整性、设计纪律、命名风格、代码格式(都不管)
pre-pr-review
提 PR 前的安全 + 测试专项审查,只读不改。
- 触发:
/pre-pr-review、"提 PR 前审一下"、"安全审查"、"检查安全性"、"测试覆盖" - 关注:
- 安全 — 注入 / XSS / 敏感信息泄漏 / 开放重定向 / 鉴权绕过 / SSR 私密配置泄漏 / 依赖风险
- 测试 — 单测 / 组件测试 / e2e 缺口;手工验证清单;高风险改动的构建 / 类型 / lint 提示
- 流程:默认审当前
git diff;分级 P0 阻断 / P1 必改 / P2 建议 - 不管:Vue 代码错误、加载速度、内存泄漏(走
vue-fe-review)
url-decode
解码任意 URL,拆协议 / 域名 / 路径 / hash / query,逐项解码参数并识别嵌套 URL、JSON、Base64 等语义。
- 触发:
/url-decode、"解码 URL"、"解析这个链接"、"看看链接里参数" - 产出:结构化 URL 拆解 + 参数语义表
- 纪律:用 Python / Node 真实解析,不肉眼估算;默认只读不改代码
详见 url-decode/
工作顺序
按 起项目 → 分析需求 → 写代码 → 审查代码 四阶段组织:
flowchart LR
A["<b>1. 起项目</b><br/>fe-project-init<br/>mp-project-init"] -->
P["<b>2a. 读项目</b><br/>codebase-parse"] -->
B["<b>2b. 评需求</b><br/>req-analyze"] -->
C["<b>3. 写代码</b><br/>vue-component-gen"] -->
D["<b>4. 审查代码</b><br/>vue-fe-review<br/>pre-pr-review"]
| 阶段 | Skill | 输入 | 输出 |
|---|---|---|---|
| 1. 起项目 | fe-project-init / mp-project-init | 空目录 + 问答 | 可跑的项目骨架 |
| 2a. 读项目 | codebase-parse | 整个仓库 / 指定目录 | 代码说明书(索引 + 核心页深解) |
| 2b. 评需求 | req-analyze | 需求文本 + 现有代码 | 改动清单(不动代码) |
| 3. 写代码 | vue-component-gen | 阶段 2 的清单 | 组件 / 页面骨架 |
| 4. 审查代码 | vue-fe-review + pre-pr-review | git diff | 分级审查报告(不动代码) |
阶段 4 的两个 skill 职责不重叠、都跑一遍才能覆盖完整:vue-fe-review 抓运行时错误和性能,pre-pr-review 抓安全和测试。两个 skill 在末尾都会提醒对方范围内的疑点。类型完整性、设计纪律、命名风格、代码格式、a11y 等不在任一 review skill 范围,靠项目 lint / typecheck 兜底。确认 review 结论后再让 agent「按 review 改」。
安装
macOS / Linux
git clone https://github.com/<your-username>/claude-skills.git ~/claude-skills
cd ~/claude-skills
bash install.sh
Windows (PowerShell)
git clone https://github.com/<your-username>/claude-skills.git $HOME\claude-skills
cd $HOME\claude-skills
.\install.ps1
安装脚本把每个 skill 软链接到下表两个目录(同时支持两个工具):
| 工具 | 路径 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
已存在的同名目录会自动备份为 xxx.backup-<时间戳>。
仅装其中一个工具:
INSTALL_TARGETS="$HOME/.cursor/skills" bash install.sh # 只装 Cursor
INSTALL_TARGETS="$HOME/.claude/skills" bash install.sh # 只装 Claude Code
使用 / 更新 / 卸载
使用
- 斜杠命令:
/fe-project-init/mp-project-init/codebase-parse/req-analyze/vue-component-gen/vue-fe-review/pre-pr-review/url-decode - 常用口令:「新建 H5 项目」「新建小程序」「解析整个项目」「分析这个需求」「写个 xxx 组件」「review 一下」「提 PR 前审一下」
- 自然语言:见每个 skill 详解里的"触发"
安装或更新后新开 Agent 会话再使用。
更新
cd ~/claude-skills
git pull # 软链接自动指向新版本
bash install.sh # 有新 skill 时补链
卸载
rm ~/.claude/skills/fe-project-init ~/.claude/skills/mp-project-init \
~/.claude/skills/codebase-parse ~/.claude/skills/req-analyze \
~/.claude/skills/vue-component-gen ~/.claude/skills/vue-fe-review \
~/.claude/skills/pre-pr-review
rm ~/.cursor/skills/fe-project-init ~/.cursor/skills/mp-project-init \
~/.cursor/skills/codebase-parse ~/.cursor/skills/req-analyze \
~/.cursor/skills/vue-component-gen ~/.cursor/skills/vue-fe-review \
~/.cursor/skills/pre-pr-review
只删软链接,源文件仍在 ~/claude-skills/。
维护校验
修改任一 skill、README 或安装脚本后,先跑仓库自检:
python3 scripts/validate-skills.py
bash -n install.sh
自检会检查:
- 顶层 skill 目录是否都有
SKILL.md SKILL.mdfrontmatter、目录名、斜杠命令是否一致- Markdown 代码围栏是否成对
SKILL.md引用的references/*是否存在- 每个 skill 是否有
agents/openai.yaml,且default_prompt包含$skill-name - README / CLAUDE 是否覆盖实际 skill,避免出现文档写了但目录不存在的条目
添加新 Skill
- 根目录建
<skill-name>/SKILL.md - 新增
agents/openai.yaml,至少包含display_name、short_description、default_prompt;default_prompt必须写$skill-name - 跑一次
bash install.sh或.\install.ps1补软链 - 在本 README「Skills 详解」下补一节,按类型选字段:
- 起项目类:触发 / 产出 / 流程 / 附带
- 分析类:触发 / 产出 / 纪律
- 写代码类:触发 / 产出 / 约定读取(或流程)
- 审查类:触发 / 关注 / 流程 / 不管(写明与另一 review skill 的边界)
- 如果属于新阶段(不属于现有四个),在「工作顺序」的 mermaid 图和表格里也加一栏
- 跑
python3 scripts/validate-skills.py,通过后再提交
License
MIT