convez.ai
SkillDesenvolvimento WebAvançado
SirGuanZz

Claude Skills para Vue3 + TypeScript + Nuxt

SirGuanZz/claude-skills

Skills estruturadas para dev Vue3+TS+Nuxt em 4 estágios

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto 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-skills

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
2
Contribuidores
1

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 写目录导读表;禁止"定义变量""导入路由"类废话注释

详见 fe-project-init/

mp-project-init

从零搭 微信小程序 项目骨架(uni-app + Vue3 + Vite + TS)。

  • 触发:/mp-project-init、"新建小程序"、"起个微信小程序"、"搭小程序架子"
  • 产出:uni-app 骨架;tabBar + 登录页;envVersion 域名切换;rpx 适配;业务方向可选商城 / 新闻 / 视频
  • 流程:5 问收集需求(方向 / 样式 / 域名 / 会员等),答完自动执行到底
  • 附带:关键文件写文件头中文注释(职责 / 依赖方 / 修改注意点),项目 README.md 写目录导读表;pages.json 等 JSON 无法注释的内容统一写在 README;禁止"定义变量""导入路由"类废话注释

详见 mp-project-init/

codebase-parse

深度只读解析整个项目代码,输出结构化代码说明书。

  • 触发:/codebase-parse、"解析代码"、"解析整个项目"、"梳理页面逻辑"、"梳理接口"、"看看动效怎么实现的"
  • 产出:技术栈(声明 vs 实际使用)、项目逻辑、接口端点总表、全量页面索引、核心页深解(默认 ≤10 页)、动效清单
  • 范围:Vue / Nuxt / uni-app / React / Next.js / Electron / monorepo
  • 默认深度:索引 + 核心页深解;可选 scripts/scan-index.sh 加速扫描
  • 纪律:只读不改代码;结论须带文件证据;评单条需求改动走 req-analyze

详见 codebase-parse/

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-component-gen/

vue-fe-review

Vue 代码专项 review,只读不改、只做三件事。

  • 触发:/vue-fe-review、"review 一下"、"看看这段代码"、"检查内存泄漏"、"看看加载速度"
  • 关注:
    • 代码错误 — 响应式陷阱 / SSR 反模式 / 路由 404 / 危险非空断言等运行时 bug
    • 加载速度 — 首屏包体积 / 请求瀑布 / 图片与字体 / 懒加载
    • 内存泄漏 — 未清理的监听器 / 定时器 / observer / 大列表 / 深响应式大对象
  • 流程:默认扫当前 git diff;一轮 + 自省一次后收口;分级 🔴 必改 / 🟡 建议改
  • 不管:安全深扫、测试覆盖(走 pre-pr-review);类型完整性、设计纪律、命名风格、代码格式(都不管)

详见 vue-fe-review/

pre-pr-review

提 PR 前的安全 + 测试专项审查,只读不改。

  • 触发:/pre-pr-review、"提 PR 前审一下"、"安全审查"、"检查安全性"、"测试覆盖"
  • 关注:
    • 安全 — 注入 / XSS / 敏感信息泄漏 / 开放重定向 / 鉴权绕过 / SSR 私密配置泄漏 / 依赖风险
    • 测试 — 单测 / 组件测试 / e2e 缺口;手工验证清单;高风险改动的构建 / 类型 / lint 提示
  • 流程:默认审当前 git diff;分级 P0 阻断 / P1 必改 / P2 建议
  • 不管:Vue 代码错误、加载速度、内存泄漏(走 vue-fe-review)

详见 pre-pr-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-reviewgit 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.md frontmatter、目录名、斜杠命令是否一致
  • Markdown 代码围栏是否成对
  • SKILL.md 引用的 references/* 是否存在
  • 每个 skill 是否有 agents/openai.yaml,且 default_prompt 包含 $skill-name
  • README / CLAUDE 是否覆盖实际 skill,避免出现文档写了但目录不存在的条目

添加新 Skill

  1. 根目录建 <skill-name>/SKILL.md
  2. 新增 agents/openai.yaml,至少包含 display_name、short_description、default_prompt;default_prompt 必须写 $skill-name
  3. 跑一次 bash install.sh 或 .\install.ps1 补软链
  4. 在本 README「Skills 详解」下补一节,按类型选字段:
    • 起项目类:触发 / 产出 / 流程 / 附带
    • 分析类:触发 / 产出 / 纪律
    • 写代码类:触发 / 产出 / 约定读取(或流程)
    • 审查类:触发 / 关注 / 流程 / 不管(写明与另一 review skill 的边界)
  5. 如果属于新阶段(不属于现有四个),在「工作顺序」的 mermaid 图和表格里也加一栏
  6. 跑 python3 scripts/validate-skills.py,通过后再提交

License

MIT

Ver o original no GitHub

Bom para

Relacionados