
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Los asistentes de IA no tienen “mala memoria”. Tienen  . mala gobernanza Lo has visto: 
 
 
 
 Escribiste una guía de arquitectura meticulosa. El modelo la ignora. Dijiste “arquitectura de 4 capas”. Produce 3 capas. Dijiste “sin  ”. Omite   como si te estuviera haciendo un favor. el-input <el-input v-model="value" /> Esto no se trata de inteligencia. Se trata de incentivos. En Claude Code, las  , no una restricción estricta. Si Claude “siente” que puede responder sin llamar a una Habilidad, lo hará. Y  . Habilidades son contexto disponible el manual de tu proyecto se convierte en decoración En nuestro equipo, construyendo una base de código RuoYi-Plus con Claude Code, lo rastreamos: 
 
 Sin intervención, Claude activó proactivamente las Habilidades del proyecto solo ~25% de las veces. Así que 3 de cada 4 veces, tus “reglas” no son reglas. Son una sugerencia. Queríamos algo más estricto: un mecanismo que haga que Claude se comporte menos como un pasante inteligente y más como un ingeniero de personal que lee el manual antes de escribir código. La solución no fue más indicaciones (prompting). La solución fueron los  . Hooks Después de ~1 mes de iteración, lanzamos una pila de configuración  : .claude 
 
 
 
 
  (gobernanza) 4 hooks de ciclo de vida  (conocimiento) 26 Habilidades de dominio  (orquestación de procesos) comandos slash  (especialistas paralelos) agentes Resultado: 
 
  Menos código que viola reglas, menos ciclos de “por favor, rehazlo” y muchas menos acciones de herramientas arriesgadas. Activación de Habilidades para tareas de desarrollo: ~25% → 90%+ Este artículo desglosa la arquitectura para que puedas reproducirla en tu propio repositorio. 1) Por qué Claude Code “olvida”: las Habilidades son opcionales por defecto El flujo predeterminado de Claude Code se ve así: Indicación del usuario → Claude responde (quizás llama a una Habilidad, quizás no)
 Ese “quizás” es el problema. La heurística de decisión interna de Claude suele ser: 
 
 
 “¿Puedo responder esto rápidamente sin contexto adicional?” no “¿Debo   cumplir con las reglas del repositorio?” obligatoriamente Así que el sistema tiende hacia la conveniencia. Lo que quieres es  : un “plano de control” ligero que se ejecuta   de que Claude comience a razonar, y da forma al trabajo cada vez. fricción institucional antes 2) El avance: un hook de evaluación forzada de Habilidades Implementamos un hook que se activa en el momento más temprano:  . UserPromptSubmit Imprime un breve bloque de políticas que Claude ve   de hacer nada más: antes 
 
 
 
 Evalúa cada Habilidad: sí/no + motivo Si hay algún “sí”: llama a la Habilidad inmediatamente Solo entonces: procede a la implementación El hook de “evaluación forzada” (lógica central) Lo mantenemos deliberadamente simple y determinista: 
 
 
 detecta comandos slash (vía de escape) de lo contrario, imprime el protocolo de evaluación // .claude/hooks/skill-forced-eval.js (idea central, simplificada)
const prompt = process.env.CLAUDE_USER_PROMPT ?? "";
​
// Vía de escape: si el usuario invocó un comando slash, omite la evaluación forzada
const isSlash = /^\/[^\s/]+/.test(prompt.trim());
if (isSlash) process.exit(0);
​
const skills = [
  "crud-development",
  "api-development",
  "database-ops",
  "ui-pc",
  "ui-mobile",
  // ... continúa (tenemos 26)
];
​
const instructions = [
  "## Protocolo Obligatorio de Activación de Habilidades (DEBE SEGUIRSE)",
  "",
  "### Paso 1 — Evaluar",
  "Para CADA habilidad, muestra: [habilidad] — Sí/No — Motivo",
  "",
  "### Paso 2 — Activar",
  "Si ALGUNA habilidad es Sí → llama a Skill(<nombre>) inmediatamente.",
  "Si TODAS son No → indica 'No se necesitan habilidades' y continúa.",
  "",
  "### Paso 3 — Implementar",
  "Solo después de completar el Paso 2, comienza la solución real.",
  "",
  "Habilidades disponibles:",
  ...skills.map(s => `- ${s}`)
].join("\n");
​
console.log(instructions);
 ¿Qué cambia en la práctica? Antes (sin hook): 
 
 “Crea la gestión de cupones.” Claude empieza a codificar… e ignora tu arquitectura de 4 capas o los componentes prohibidos. Después (hook de evaluación forzada): Claude primero debe producir una tabla de decisión explícita, luego activar Habilidades y luego implementar. El cambio de comportamiento es dramático porque estás eliminando el “cumplimiento opcional”. 3) ¿Por qué 90% y no 100%? Porque intencionalmente agregamos una  . ruta rápida Cuando un usuario sabe lo que quiere, escribir un comando como: 
 
 
 
 /dev construir gestión de cupones /crud b_coupon /check debería ser instantáneo. Por lo tanto, el hook omite la evaluación para los comandos slash y permite que el flujo del comando se encargue. Esa es la compensación: 
 
 
 Gobernanza para indicaciones de formato libre Velocidad para comandos estructurados 4) Hooks como plano de control de ciclo de vida (la pila de 4 hooks) Piensa en los hooks como un pipeline de CI para una sesión de agente, solo que se ejecuta en vivo, en tu terminal. Utilizamos cuatro puntos clave: 4.1 SessionStart: “mira el repositorio antes de hablar” Cuando comienza una sesión, mostramos: 
 
 
 
 
 rama git actual cambios no confirmados TODOs abiertos / estado comandos comunes Ejemplo de salida: 🚀 Sesión iniciada: RuoYi-Plus-Uniapp
Hora: 2026-02-16 21:14
Rama: master
​
⚠️ Cambios sin confirmar: 5 archivos
📋 TODO: 3 abiertos / 12 completados
​
Atajos:
  /dev    construir característica
  /crud   generar módulo
  /check  verificar convenciones
  Claude deja de actuar como si estuviera entrando en una habitación vacía. Por qué importa: 4.2 UserPromptSubmit: evaluación forzada de Habilidades (disciplina) Esta es la puerta de “debe leer el manual”. 4.3 PreToolUse: la capa de seguridad (gobernanza de herramientas) Claude Code es potente porque puede ejecutar herramientas: Bash, escribir archivos, editar código. Ahí es también donde ocurren los accidentes. PreToolUse es tu última línea de defensa antes de que ocurra algo irreversible. Bloqueamos una pequeña lista negra (y advertimos sobre una lista gris más amplia): // .claude/hooks/pre-tool-use.js (conceptual)
const cmd = process.env.CLAUDE_TOOL_INPUT ?? "";
​
const hardBlock = [
  /rm\s+(-rf|--recursive).*\s+\//i,
  /drop\s+(database|table)\b/i,
  />\s*\/dev\/sd[a-z]\b/i,
];
​
if (hardBlock.some(p => p.test(cmd))) {
  console.log(JSON.stringify({
    decision: "block",
    reason: "Patrón de comando peligroso detectado"
  }));
  process.exit(0);
}
​
// Opcionalmente: advertir/confirmar sobre acciones sensibles (borrados masivos, chmod -R, etc.)
 Esto no es paranoia. Hemos visto modelos “limpiar archivos temporales” con   en el directorio equivocado. Quieres una barrera de seguridad que no dependa de que el modelo sea cuidadoso. rm -rf 4.4 Stop: “cierra el círculo” con orientación para el siguiente paso Cuando Claude termina, nosotros: 
 
 
 
 resumimos los cambios de archivos (nuevos vs modificados) sugerimos los próximos pasos (ejecutar pruebas, actualizaciones de documentación, commit) opcionalmente activamos agentes (revisión de código) Ejemplo: ✅ Hecho — 8 archivos cambiados
​
Próximos pasos:
- @code-reviewer para convenciones de backend
- SQL cambiado: sincronizar scripts de migración
- Considerar: git commit -m "feat: módulo de cupones"
 El objetivo: eliminar la brecha de “funcionó en el chat”. 5) Habilidades: la capa de conocimiento que realmente puedes forzar Una vez que la activación es determinista, las Habilidades se convierten en lo que se suponía que debían ser: una  . base de conocimiento específica del dominio Construimos 26 Habilidades en: 
 
 
 
 
 
 
 backend (CRUD, API, DB, anotaciones, manejo de errores) frontend (política de componentes de PC, gestión de estado) móvil (kits de UI, restricciones de la plataforma uniapp) integraciones (pagos, WeChat, OSS) calidad (rendimiento, seguridad, detective de errores) gestión de ingeniería (arquitectura, flujo de trabajo git, decisiones técnicas) Una estructura de archivos de Habilidad que escala Cada   sigue el mismo esqueleto: SKILL.md # Nombre de la Habilidad
​
## Cuándo activar
- Palabras clave:
- Escenarios:
​
## Reglas principales
### Regla 1
Explicación + ejemplo
​
### Regla 2
Explicación + ejemplo
​
## Prohibido
- ❌ ...
​
## Código de referencia
- ruta/a/archivo
​
## Lista de verificación
- [ ] ...
 Esta consistencia importa porque el modelo aprende cómo   Habilidades. consumir 6) Comandos: flujos de trabajo, no sugerencias Las Habilidades resuelven “qué es correcto”. Los Comandos resuelven “cuál es el proceso”. 6.1  : un pipeline de desarrollo de 7 pasos /dev Diseñamos   como un flujo de trabajo opinado: /dev 
 
 
 
 
 
 
 
 clarificar requisitos diseño (API + módulos + permisos) diseño de BD (SQL + diccionarios + menús) backend (salida de 4 capas) frontend (política de componentes + enrutamiento) pruebas/verificación documentación/actualización de progreso Es básicamente: “cómo los seniors quieren que trabajen los juniors” codificado como un script ejecutable. 6.2  : genera un módulo completo a partir de una tabla /crud Entrada: /crud b_coupon
 Salida (conjunto de ejemplo): 
 
 
 
 
 
 Entidad / BO / VO Reglas de DAO + Query wrapper Servicio + Controlador (sin patrones prohibidos) Mapper API de frontend + scaffold de página Esfuerzo manual:   Impulsado por comando:   (más revisión) 2–4 horas 5–10 minutos 6.3  : linting de convenciones full-stack (legible por humanos) /check Aquí es donde convertimos las Habilidades en un verificador: 
 
 
 
 backend: reglas de capas, herencia prohibida, política de wrappers de consulta frontend: componentes prohibidos, uso de wrappers móvil: kit de componentes, unidades, importaciones 7) Agentes: especialistas paralelos (no sobrecargues el hilo principal) Algunas tareas deben ser manejadas por un subagente dedicado: 
 
 
 : verificaciones de convenciones con una lista de verificación estricta @code-reviewer : actualizar documentos de estado, TODOs, métricas de progreso @project-manager La ventaja no es “más inteligencia”. Es   y menor contaminación del contexto en la sesión principal. separación de responsabilidades Un patrón práctico: 
 
 
 
 
 el agente principal genera código el hook Stop sugiere revisión invocas  @code-reviewer el revisor devuelve un diff estructurado + lista de correcciones 8) El sistema completo: gobernanza + conocimiento + proceso + división del trabajo Esta es la arquitectura en una oración: 
 
 Los Hooks imponen el comportamiento, las Habilidades proporcionan estándares, los Comandos codifican flujos de trabajo, los Agentes manejan la experiencia paralela. Y sí, así es como conviertes un “asistente de IA general” en un “compañero de equipo nativo del repositorio”. 9) Configuración mínima reproducible (amigable para copiar y pegar) Si quieres la versión más pequeña que aún funcione, construye esto: .claude/
  settings.json
  hooks/
    skill-forced-eval.js
    pre-tool-use.js
  skills/
    crud-development/
      SKILL.md
 Configuración mínima de   (hook UserPromptSubmit) settings.json {
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/skill-forced-eval.js"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/pre-tool-use.js"
          }
        ]
      }
    ]
  }
}
 Luego itera: 
 
 
 
 
 
 agrega SessionStart agrega Stop expande las Habilidades solo cuando detectes un “comportamiento incorrecto” repetido codifica flujos de trabajo repetidos como comandos descarga tareas de revisión/PM a agentes Cierre: la “habilidad” no es el cuello de botella — la   lo es activación Tu modelo ya es capaz. Lo que falta es un  . sistema que haga automático el comportamiento correcto Un nuevo empleado inteligente sin un manual improvisará. Un nuevo empleado inteligente con: 
 
 
 
 
 listas de verificación forzadas patrones prohibidos claros flujos de trabajo repetibles especialistas para revisiones y PM …se vuelve consistente rápidamente. Claude es lo mismo.

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Branch

Read My Stories

Este audio es producido en el idioma original de la historia!

Cómo construir una capa de gobernanza para el código de Claude con ganchos, habilidades y agentes

About Author

COMENTARIOS

ETIQUETAS

ESTE ARTÍCULO FUE PRESENTADO EN

Related Stories

Navegando por las aguas: desarrollo de aplicaciones RAG de nivel de producción con lagos de datos

Telegram: el puente de Crypto Island hacia el continente

Aumente su productividad con estas 18 herramientas para desarrolladores 🚀🔥

Creación de productos criptográficos centrados en el usuario: la importancia de los comentarios de los clientes

Navegando por las aguas: desarrollo de aplicaciones RAG de nivel de producción con lagos de datos

Telegram: el puente de Crypto Island hacia el continente

Aumente su productividad con estas 18 herramientas para desarrolladores 🚀🔥

Creación de productos criptográficos centrados en el usuario: la importancia de los comentarios de los clientes

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps