Hogar
Sesión de depuración estructurada: reproducir, aislar, diagnosticar y corregir problemas. Puede activarse mediante un mensaje de error o un rastro de llamadas; por ejemplo, cuando se observa que algo funciona en entorno de pruebas pero no en producción, o cuando el comportamiento del sistema difiere de lo esperado y la causa no es evidente.
...Expandir todoSobre el depurado
La habilidad de depurado está diseñada para guiar a los usuarios a través de un proceso estructurado de resolución de problemas cuando el comportamiento del software es incorrecto, incomprensible o ha regresado. Está destinada a situaciones en las que un mensaje de error, un rastro de llamadas o un comportamiento inesperado indiquen un problema que no se puede diagnosticar de inmediato. Al organizar el proceso de depurado en fases claras, ayuda a los usuarios a pasar de la observación de síntomas a la identificación de la causa raíz de manera sistemática, en lugar de confiar en conjeturas.
La habilidad sigue un método de cuatro pasos: reproducción, aislamiento, diagnóstico y solución. En la fase de reproducción, se centra en aclarar el comportamiento esperado en comparación con el real y establecer pasos fiables para reproducir el problema. La fase de aislamiento reduce los componentes afectados al revisar cambios recientes como implementaciones, actualizaciones de configuración o cambios en dependencias, mientras también se analizan los registros y los mensajes de error. Durante el diagnóstico, el proceso enfatiza la formulación y prueba de hipótesis, el seguimiento de las rutas de ejecución y la identificación de la causa raíz subyacente, en lugar de solo los síntomas superficiales. Finalmente, la fase de solución se centra en proponer cambios correctivos, teniendo en cuenta los efectos secundarios y recomendando pruebas preventivas para evitar regresiones.
Esta habilidad está dirigida principalmente a desarrolladores, ingenieros DevOps, testers de calidad y ingenieros de confiabilidad del sitio que resuelven problemas de producción y desarrollo con regularidad. Es especialmente útil en escenarios como regresiones tras implementaciones, errores específicos del entorno (por ejemplo, diferencias entre entornos de prueba y producción) o fallos inexplicables después de cambios recientes. Al imponer una estructura disciplinada de depurado, se reduce el tiempo necesario para intentos y errores y se mejora la consistencia en los procesos de resolución de incidentes.
Preguntas frecuentes
¿Qué tipo de información debo proporcionar para utilizar esta habilidad de depurado?
Debería proporcionar un mensaje de error, un rastro de llamadas, una descripción del comportamiento inesperado, pasos para reproducir el problema o contexto como cambios recientes o registros. Cuanto más precisa sea la información, más efectivo será el proceso de depurado.
¿Requiere esta habilidad acceso a herramientas externas o conectores?
Opcionalmente, puede utilizar conectores disponibles como sistemas de monitoreo, control de código fuente o herramientas de seguimiento de proyectos si están conectados. Sin embargo, también puede funcionar utilizando solo la descripción proporcionada, los registros y el contexto.
¿Para qué tipo de problemas no es adecuada esta habilidad?
No está destinada a preguntas puramente teóricas ni a explicaciones generales. Se centra específicamente en diagnosticar y resolver problemas concretos de software que presentan un comportamiento incorrecto observable.
/debug
If you see unfamiliar placeholders or need to check which tools are connected, see CONNECTORS.md.
Run a structured debugging session to find and fix issues systematically.
Usage
/debug $ARGUMENTSHow It Works
┌─────────────────────────────────────────────────────────────────┐│ DEBUG │├─────────────────────────────────────────────────────────────────┤│ Step 1: REPRODUCE ││ ✓ Understand the expected vs. actual behavior ││ ✓ Identify exact reproduction steps ││ ✓ Determine scope (when did it start? who is affected?) ││ ││ Step 2: ISOLATE ││ ✓ Narrow down the component, service, or code path ││ ✓ Check recent changes (deploys, config changes, dependencies) ││ ✓ Review logs and error messages ││ ││ Step 3: DIAGNOSE ││ ✓ Form hypotheses and test them ││ ✓ Trace the code path ││ ✓ Identify root cause (not just symptoms) ││ ││ Step 4: FIX ││ ✓ Propose a fix with explanation ││ ✓ Consider side effects and edge cases ││ ✓ Suggest tests to prevent regression │└─────────────────────────────────────────────────────────────────┘What I Need From You
Tell me about the problem. Any of these help:
- Error message or stack trace
- Steps to reproduce
- What changed recently
- Logs or screenshots
- Expected vs. actual behavior
Output
## Debug Report: [Issue Summary]### Reproduction- **Expected**: [What should happen]- **Actual**: [What happens instead]- **Steps**: [How to reproduce]### Root Cause[Explanation of why the bug occurs]### Fix[Code changes or configuration fixes needed]### Prevention- [Test to add]- [Guard to put in place]
If Connectors Available
If ~~monitoring is connected:
- Pull logs, error rates, and metrics around the time of the issue
- Show recent deploys and config changes that may correlate
If ~~source control is connected:
- Identify recent commits and PRs that touched affected code paths
- Check if the issue correlates with a specific change
If ~~project tracker is connected:
- Search for related bug reports or known issues
- Create a ticket for the fix once identified
Tips
- Share error messages exactly — Don't paraphrase. The exact text matters.
- Mention what changed — Recent deploys, dependency updates, and config changes are top suspects.
- Include context — "This works in staging but not prod" or "Only affects large payloads" narrows things fast.
Instalar debug
Descargue y descomprima los archivos de habilidades en la carpeta .claude/skills/.
Descargar ZIPClona el repositorio y copia los archivos de la habilidad a tu proyecto.
git clone https://github.com/anthropics/knowledge-work-plugins/blob/main/engineering/skills/debug/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Copiar
