validation-checklist
开发项目交付前验证技能(后端/前端:测试、代码检查、TypeScript编译、文档、质量保证)。
📖 中文导读:开发项目交付前验证技能(后端/前端:测试、代码检查、TypeScript编译、文档、质量保证)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: validation-checklist description: Skill de validação pré-entrega para projetos de desenvolvimento (backend/frontend: tests, lint, tsc, docs, QA).
Quando usar
Após implementação pela equipe/agent de desenvolvimento, antes de entregar a task.
Objetivo
Garantir qualidade mínima e documentação alinhada antes do handoff.
Passos Universais
Aplicáveis a qualquer stack (backend ou frontend):
- Testes: executar
npm run test(unit + integration) sem falhas; cobrir fluxo principal e um alternativo por caso de uso. - Qualidade:
npm run lint,npm run format(se existir),npm run tsc --noEmit. - Execução manual: subir aplicação (
npm run start,npm run dev, ou comando do projeto) e validar funcionamento. - Documentação: atualizar
tasks.mdcom status; criar<numero-task>_testes_para_QA.mdno diretório da task (cenários, passos, dados, esperado). - Logs/Security: logging adequado (Winston, console estruturado); sem dados sensíveis em logs/fixtures.
Validações Específicas por Stack
Para projetos Backend (NestJS/Node.js)
- Validar endpoints tocados via
api.http(auth, payload, status esperado) - Atualizar Swagger com exemplos completos; adicionar requests no
api.http - Verificar DTOs, validações (class-validator) e guards/middlewares se aplicável
Para projetos Frontend (Next.js/React)
- Validar build production (
npm run build) sem erros - Verificar bundle size e performance (lighthouse, bundle analyzer)
- Testar SSR/SSG se aplicável (páginas renderizadas corretamente)
- Validar rotas e páginas funcionais no navegador
- Verificar componentes visuais e responsividade
Procedimento de falha
Se qualquer item falhar, PAUSAR e corrigir antes de entregar; registrar causa.
Saída esperada
- Relatório curto: comandos executados e status (PASS/FAIL), endpoints validados, docs atualizadas, pendências/riscos.