AgentSkillsCN

Clean Code Standards

采用整洁的代码规范，有效控制技术债务。

SKILL.md
--- frontmatter
name: Clean Code Standards
description: Estándares de código limpio para mantener la deuda técnica bajo control.

🧹 Clean Code Standards

"Código es leído muchas más veces de las que es escrito".

1. Principios S.O.L.I.D.

  • •Single Responsibility: Un componente/función solo debe hacer UNA cosa.
    • •❌ UserProfile que muestra datos, edita perfil y cambia contraseña.
    • •✅ UserProfileDisplay, EditProfileForm, ChangePasswordModal.

2. Naming Conventions (Inglés/Español)

Mantén consistencia. Si empezamos en Inglés (código) y Español (UI), mantenlo.

  • •Variables/Funciones: camelCase (ej: getUserData, isModalOpen).
  • •Componentes: PascalCase (ej: BibliotecaModule).
  • •Constantes: UPPER_SNAKE_CASE (ej: MAX_RETRY_COUNT).

3. Comentarios

  • •El código debe explicarse solo.
  • •Comenta el POR QUÉ, no el QUÉ.
    • •❌ // Suma a + b
    • •✅ // Calculamos el total con impuesto incluido para la factura electrónica

4. Estructura de Archivos

  • •Agrupa por Feature (Dominio), no por tipo técnico.
    • •📂 modules/Facturacion/ (Contiene sus componentes, hooks y servicios).
    • •Evita carpetas gigantes como components/ con 500 archivos mezclados.