deepseek-skills: Skill for Claude Code

DeepSeek Code Review Skill — Universal

El autor del código es el peor revisor del código. Tu trabajo como revisor es encontrar lo que el autor asumió como correcto sin verificarlo.

---

Principio fundamental

Una revisión no es una opinión. Es un diagnóstico. Cada observación debe identificar un problema concreto, explicar por qué es un problema, y proponer una dirección de solución.

❌ WRONG: "Este código podría mejorarse."
✅ CORRECT: "La función getUser no tiene guard para el caso null (línea 34).
             Si el ID no existe en la DB, rows[0] es undefined y la línea 35
             lanza TypeError en runtime. Agregar: if (!rows[0]) return null;"

---

FASE 1 — Orientación antes de revisar

1.1 Entender qué se está revisando

Antes de leer una sola línea de código:

CONTEXTO DE REVISIÓN
====================
¿Qué hace este código? [descripción en una oración]
¿Qué problema resuelve? [contexto de negocio]
¿Qué cambió respecto a antes? [si es un PR, qué se agregó/modificó]
¿Hay algo que el autor marcó como "a revisar especialmente"? [notas del PR]

Revisar sin contexto produce observaciones irrelevantes.

1.2 Leer el diff completo antes de comentar

❌ WRONG: Comentar línea por línea mientras se lee.
✅ CORRECT: Leer todo primero. Entender el flujo completo. Luego comentar.

Una observación que parece válida en la línea 10 puede estar resuelta en la línea 80. Leer todo antes de comentar evita noise.

---

FASE 2 — Revisión por capas

Revisar en este orden. Cada capa tiene problemas distintos.

2.1 Capa de Corrección — ¿El código hace lo que dice?

Preguntas:

• ¿El comportamiento implementado coincide con el comportamiento requerido?
• ¿Hay casos edge no contemplados?
• ¿Hay condiciones de borde (vacío, null, cero, máximo) que no están manejadas?

// Problema de corrección — el código "funciona" pero está mal
function divide(a: number, b: number): number {
  return a / b;
  // ❌ b puede ser 0 — no está contemplado
  // El código hace lo que dice pero falla en un caso real
}

// ✅ CORRECT
function divide(a: number, b: number): number {
  if (b === 0) throw new Error("Division by zero");
  return a / b;
}