es

Claude Code Cookbook

🏠 Home | 🇺🇸 English | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇨🇳 简体中文 | 🇹🇼 繁體中文 | 🇪🇸 Español | 🇫🇷 Français | 🇧🇷 Português

Una colección de configuraciones para hacer que Claude Code sea más fácil de usar.

Al evitar confirmaciones detalladas y proceder automáticamente con las tareas, puedes concentrarte en lo que realmente quieres hacer. Claude Code juzga y ejecuta tareas comunes como corrección de código, ejecución de pruebas y actualización de documentación.

Características Principales

Puedes personalizar el comportamiento de Claude Code con tres funciones:

• Commands: Comandos personalizados que comienzan con /
• Roles: Configuraciones de roles para responder desde perspectivas de expertos
• Hooks: Ejecución automática de scripts en momentos específicos

---

Lista de Funciones

Commands (Comandos Personalizados)

Guardados como archivos Markdown en el directorio /commands. Se ejecutan escribiendo / seguido del nombre del archivo.

Comando	Descripción
/analyze-dependencies	Analiza las dependencias del proyecto y visualiza dependencias circulares y problemas estructurales.
/analyze-performance	Analiza problemas de rendimiento de la aplicación y propone mejoras desde la perspectiva de deuda técnica.
/check-fact	Verifica la veracidad de la información proporcionada consultando el código y documentación del proyecto.
/pr-checks	Monitoriza el estado de CI de GitHub Actions y rastrea hasta completarse.
/check-prompt	Revisa el contenido del prompt actual y presenta sugerencias de mejora.
/commit-message	Genera solo el mensaje de commit basado en los cambios.
/context7	Gestiona el contexto usando Context7 MCP.
/design-patterns	Propone y revisa implementaciones basadas en patrones de diseño.
/explain-code	Explica claramente la funcionalidad y lógica del código seleccionado.
/fix-error	Propone soluciones de código basadas en mensajes de error.
/multi-role	Combina múltiples roles para análisis paralelo del mismo objetivo y genera un informe integrado.
/plan	Activa el modo de planificación previa a la implementación y formula estrategias detalladas.
/pr-auto-update	Actualiza automáticamente el contenido del Pull Request (descripción, etiquetas).
/pr-create	Crea PRs automáticamente basándose en análisis de cambios Git para un flujo de trabajo eficiente.
/pr-fix	Responde eficientemente a comentarios de revisión de PR con enfoque de tres etapas para solución fundamental.
/pr-issue	Muestra lista de Issues abiertas del repositorio actual con priorización.
/pr-list	Muestra lista de PRs abiertos del repositorio actual con priorización.
/pr-review	Asegura calidad del código y salud arquitectónica con revisión sistemática de PR.
/refactor	Ejecuta refactorización segura y gradual evaluando cumplimiento de principios SOLID.
/role-debate	Hace que múltiples roles debatan sobre un tema específico.
/role-help	Muestra lista y descripción de Roles disponibles.
/role	Actúa como el rol especificado.
/screenshot	Captura y analiza capturas de pantalla.
/search-gemini	Realiza búsquedas web usando Gemini.
/semantic-commit	Divide cambios grandes en unidades mínimas significativas con mensajes de commit semánticos.
/sequential-thinking	Usa Sequential Thinking MCP para pensar problemas complejos paso a paso y llegar a conclusiones.
/show-plan	Muestra el plan de ejecución actual.
/smart-review	Realiza revisiones avanzadas para mejorar la calidad del código.
/spec	Crea especificaciones detalladas paso a paso siguiendo el desarrollo dirigido por especificaciones de Kiro.
/style-ai-writing	Detecta y corrige texto antinatural generado por IA.
/task	Lanza agentes dedicados para ejecutar tareas complejas de búsqueda, investigación y análisis de forma autónoma.
/tech-debt	Analiza la deuda técnica del proyecto y crea un plan de mejora priorizado.
/ultrathink	Ejecuta un proceso de pensamiento estructurado y gradual para problemas complejos o decisiones importantes.
/update-dart-doc	Gestiona sistemáticamente comentarios DartDoc en archivos Dart y mantiene documentación de alta calidad.
/update-doc-string	Gestiona y actualiza cadenas de documentación de forma unificada para múltiples idiomas.
/update-flutter-deps	Actualiza de forma segura las dependencias del proyecto Flutter.
/update-node-deps	Actualiza de forma segura las dependencias del proyecto Node.js.
/update-rust-deps	Actualiza de forma segura las dependencias del proyecto Rust.

Roles (Configuración de Roles)

Definidos en archivos Markdown dentro del directorio agents/roles/. Permite que Claude tenga perspectivas de expertos para respuestas más precisas.

Cada rol también puede ejecutarse independientemente como subagente. Usando la opción --agent, puedes ejecutar análisis a gran escala o procesamiento especializado en paralelo sin interferir con el contexto de conversación principal.

Rol	Descripción
/role analyzer	Como experto en análisis de sistemas, analiza código y arquitectura.
/role architect	Como arquitecto de software, revisa y propone sobre diseño.
/role backend	Como experto en desarrollo backend, asesora sobre diseño de API, microservicios, cloud-native y arquitectura serverless.
/role frontend	Como experto en frontend, asesora sobre UI/UX y rendimiento.
/role mobile	Como experto en desarrollo móvil, responde basándose en mejores prácticas de iOS/Android.
/role performance	Como experto en optimización de rendimiento, propone mejoras de velocidad y uso de memoria.
/role qa	Como ingeniero QA, revisa desde la perspectiva de planes de prueba y aseguramiento de calidad.
/role reviewer	Como revisor de código, evalúa código desde perspectivas de legibilidad y mantenibilidad.
/role security	Como experto en seguridad, señala vulnerabilidades y riesgos de seguridad.

Ejemplos de Ejecución de Subagentes

# Modo normal (ejecuta en contexto principal)
/cook-es:role security
"Verificación de seguridad de este proyecto"

# Modo subagente (ejecuta en contexto independiente)
/cook-es:role security --agent
"Ejecutar auditoría de seguridad completa del proyecto"

# Análisis paralelo de múltiples roles
/cook-es:multi-role security,performance --agent
"Análisis integral de seguridad y rendimiento del sistema completo"

Hooks (Scripts de Automatización)

Configure en settings.json para automatizar tareas de desarrollo.

Script de Ejecución	Evento	Descripción
preserve-file-permissions.sh	PreToolUse / PostToolUse	Guarda permisos originales antes de editar archivo y restaura después de edición. Previene que Claude Code cambie permisos.

---

Flujo de Desarrollo y Guía de Uso de Comandos

Ejemplos de Uso de Comandos en Flujo de Desarrollo Típico

flowchart TB
    Start([Verificar Tarea]) --> PRList["/cook-es:pr-list<br/>Lista PRs Abiertos"]
    Start --> PRIssue["/cook-es:pr-issue<br/>Lista Issues Abiertas"]

    PRList --> TaskType{¿Tipo?}
    PRIssue --> TaskType

    TaskType -->|Nueva Funcionalidad| Plan["/cook-es:spec<br/>Definición de Requisitos ・Diseño"]
    TaskType -->|Corrección de Bug| Fix["/cook-es:fix-error<br/>Análisis de Error"]
    TaskType -->|Refactorización| Refactor["/cook-es:refactor<br/>Mejora"]
    TaskType -->|Revisión| Review["/cook-es:pr-review<br/>Revisión"]

    Plan --> Design["/cook-es:role architect<br/>/cook-es:role-debate<br/>Consulta de Diseño"]
    Design --> Implementation[Implementación ・Prueba]
    Fix --> Implementation
    Refactor --> Implementation
    Review --> Implementation

    Implementation --> Check["/cook-es:smart-review<br/>Verificación de Calidad"]
    Check --> Commit["/cook-es:semantic-commit<br/>Commit por Unidad de Objetivo"]
    Commit --> PR["/cook-es:pr-create<br/>Creación Automática de PR"]
    PR --> CI["/cook-es:pr-checks<br/>Verificación de Estado CI"]

    CI --> Status{¿Hay Problema?}
    Status -->|Sí| Feedback["Responder Corrección<br/>/cook-es:pr-fix<br/>/cook-es:fix-error"]
    Status -->|No| End([Concluido])

    Feedback --> Implementation

    classDef commandBox fill:#e0f2fe,stroke:#0369a1,stroke-width:2px,rx:5,ry:5,color:#0c4a6e
    classDef processBox fill:#f0f9ff,stroke:#0ea5e9,stroke-width:1px,rx:5,ry:5,color:#075985
    classDef decisionBox fill:#fef3c7,stroke:#f59e0b,stroke-width:2px,rx:5,ry:5,color:#78350f
    classDef startEnd fill:#86efac,stroke:#22c55e,stroke-width:2px,rx:20,ry:20,color:#14532d

    class PRList,PRIssue,Plan,Fix,Refactor,Review,Design,Check,CI,Commit,PR,Feedback commandBox
    class Implementation processBox
    class TaskType,Status decisionBox
    class Start,End startEnd

    %%{init: {'theme':'base', 'themeVariables': { 'primaryColor':'#e0f2fe', 'primaryTextColor':'#0c4a6e', 'primaryBorderColor':'#0369a1', 'lineColor':'#64748b', 'secondaryColor':'#f0f9ff', 'background':'#ffffff', 'mainBkg':'#ffffff', 'fontSize': '14px'}}}%%

Loading

---

Instalación

Paso 1: Agregar el Marketplace

Primero, agrega este repositorio como un marketplace de plugins:

/plugin marketplace add wasabeef/claude-code-cookbook

Paso 2: Instalar el Plugin en Español

Luego, instala el plugin en versión española:

/plugin install cook-es@claude-code-cookbook

Este comando instala la versión en español de Commands y Roles.

Uso

Después de la instalación, los comandos y agentes se invocan con el prefijo cook-es::

Ejecutar Comandos

# Ejecutar con prefijo
/cook-es:check-fact

# Usar autocompletado
/cook-es:

Llamar Agentes

# Buscar agentes comenzando con @
@agent-cook-es:frontend

# También se puede usar mediante comando de rol
/cook-es:role frontend

Nota: El nombre del plugin se agrega automáticamente como prefijo. Esto evita conflictos de nombres cuando se instalan múltiples plugins de idioma simultáneamente.

Personalización

• Agregar comandos: Solo agrega archivos .md en commands/
• Agregar roles: Solo agrega archivos .md en agents/roles/
• Editar Hooks: Edita settings.json para cambiar el procesamiento automático