heal
정보
`heal` 스킬은 Claude가 여섯 가지 핵심 하위 시스템(예: 추론 일관성 및 도구 정확성)을 평가하고 표적 수정을 적용하여 자가 진단 및 복구를 수행할 수 있도록 합니다. 긴 세션 중 응답 품질이 저하되거나, 도구 오류가 반복적으로 발생한 후, 또는 복잡한 다단계 작업에서의 편차를 확인할 때 사용하세요. 이 스킬은 성능을 복원하기 위해 수정 사항을 자동으로 선택, 실행 및 검증합니다.
빠른 설치
Claude Code
추천npx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/healClaude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요
문서
Heal
Auto-sanación a través de evaluación sistemática de subsistemas. Cuando el rendimiento se degrada — la calidad de las respuestas disminuye, las herramientas fallan repetidamente, el razonamiento se vuelve circular — heal diagnostica cuál subsistema está a la deriva y aplica remediación dirigida.
Cuándo Usar
- La calidad de las respuestas se degrada durante una sesión larga (señales que podrías notar: respuestas más vagas, pasos omitidos, suposiciones repetidas)
- Después de fallos repetidos de herramientas o resultados inesperados — algo no está funcionando y el enfoque habitual no lo soluciona
- Cuando la deriva se acumula entre la intención del usuario y la dirección del trabajo
- Verificación periódica de salud durante tareas complejas de múltiples pasos (cada 5-10 pasos importantes)
- Cuando
centerrevela desequilibrio pero la causa raíz no está clara - Cuando
breathedetecta desalineación más profunda de lo que un micro-reinicio puede abordar
Entradas
- Requerido: Estado actual de la conversación y contexto de la tarea (disponible implícitamente)
- Opcional: Síntoma específico que desencadena heal (p. ej., "mis búsquedas de archivos siguen sin encontrar el objetivo")
- Opcional: MEMORY.md para comparar el estado actual con patrones pasados conocidos (vía
Read)
Procedimiento
Paso 1: Triaje — Identificar el Subsistema Afectado
Escanear todos los subsistemas rápidamente para encontrar dónde se origina la degradación. No saltar al primero que parezca mal — completar el barrido primero.
Estado de Subsistemas:
┌────────────────────────────────────┬──────────┬─────────────────────────┐
│ Subsistema │ Estado │ Señales │
├────────────────────────────────────┼──────────┼─────────────────────────┤
│ 1. Alineación Intención-Usuario │ ○○○○○ │ ¿Estoy resolviendo el │
│ │ │ problema correcto? │
├────────────────────────────────────┼──────────┼─────────────────────────┤
│ 2. Coherencia del Razonamiento │ ○○○○○ │ ¿Mi lógica sigue un │
│ │ │ hilo claro? │
├────────────────────────────────────┼──────────┼─────────────────────────┤
│ 3. Precisión de Herramientas │ ○○○○○ │ ¿Estoy usando las │
│ │ │ herramientas bien? │
├────────────────────────────────────┼──────────┼─────────────────────────┤
│ 4. Frescura de la Información │ ○○○○○ │ ¿Mis datos están │
│ │ │ actualizados? │
├────────────────────────────────────┼──────────┼─────────────────────────┤
│ 5. Regulación Emocional │ ○○○○○ │ ¿Estoy reactivo en │
│ │ │ lugar de razonado? │
├────────────────────────────────────┼──────────┼─────────────────────────┤
│ 6. Equilibrio de Carga Cognitiva │ ○○○○○ │ ¿Estoy intentando │
│ │ │ manejar demasiado? │
└────────────────────────────────────┴──────────┴─────────────────────────┘
Clasificación: ●●●●● = Saludable, ●●●○○ = Degradado, ●○○○○ = Crítico
Para cada subsistema, evaluar brevemente:
- Alineación Intención-Usuario: ¿La solicitud original del usuario y tu dirección actual de trabajo todavía coinciden? Buscar alcance expandido, camino desviado, o suposiciones que el usuario no declaró.
- Coherencia del Razonamiento: ¿Tu cadena de razonamiento sigue siendo lógica? Buscar lógica circular, conclusiones contradictorias, o pasos que no se derivan de evidencia.
- Precisión de Herramientas: ¿Estás usando las herramientas correctamente? Buscar patrones repetidos de fallo, rutas de archivo incorrectas, consultas mal formadas, o herramientas usadas fuera de su propósito.
- Frescura de la Información: ¿Tu información es actual? Buscar decisiones basadas en estado de archivos obsoleto, contenido que ha cambiado desde que lo leíste, o suposiciones de lecturas anteriores.
- Regulación Emocional: ¿Estás respondiendo reactivamente? Buscar urgencia que no se justifica, frustración que impulse soluciones agresivas, o exceso de confianza que omita verificación.
- Equilibrio de Carga Cognitiva: ¿Estás intentando manejar demasiadas cosas simultáneamente? Buscar razonamiento excesivamente largo, detalles olvidados de pasos anteriores, o decisiones simplificadas que ocultan complejidad real.
Esperado: Una evaluación rápida (segundos, no minutos) de los seis subsistemas. Al menos un subsistema debería mostrar degradación si heal fue invocado por un motivo real. Si todos leen como saludables, considera gratitude en su lugar — el sistema puede estar funcionando bien.
En caso de fallo: Si el triaje en sí se siente confuso o difícil de completar, eso es diagnóstico — la carga cognitiva probablemente es el problema. Simplifica: ¿cuál es el único problema más obvio ahora mismo?
Paso 2: Seleccionar Remediación
Para cada subsistema degradado, elegir la remediación apropiada.
| Subsistema | Remediación Leve | Remediación Profunda |
|---|---|---|
| Alineación Intención-Usuario | Releer el mensaje original del usuario; reafirmar el objetivo | Preguntar al usuario para aclaración o confirmación de dirección |
| Coherencia del Razonamiento | Exponer la cadena lógica; identificar el eslabón roto | Reiniciar el razonamiento desde los hechos conocidos (invocar meditate) |
| Precisión de Herramientas | Revisar la documentación de la herramienta; corregir la sintaxis | Cambiar de estrategia de herramienta; probar enfoque alternativo |
| Frescura de la Información | Releer los archivos clave; verificar suposiciones | Descartar estado en caché; reconstruir contexto desde cero |
| Regulación Emocional | breathe — pausa, verificar, liberar | center — reequilibrio completo de las Seis Armonías |
| Equilibrio de Carga Cognitiva | Dividir la tarea actual en partes más pequeñas | Descargar contexto a notas; enfocarse en una cosa a la vez |
Elegir leve si la degradación es menor y reciente. Elegir profunda si la degradación se ha acumulado o es severa.
Esperado: Una elección clara de remediación para cada subsistema degradado. La remediación debe coincidir con la severidad — no usar cañones contra mosquitos, pero tampoco subestimar un problema sistémico.
En caso de fallo: Si la remediación apropiada no está clara, comenzar con la opción leve. Si no mejora, escalar a profunda. La iteración supera al análisis cuando el diagnóstico es incierto.
Paso 3: Anclaje Previo a la Remediación
Antes de aplicar la remediación, anclarse al objetivo principal para que la reparación no se convierta en deriva.
- Decir en una frase: "La tarea del usuario es: ___"
- Decir en una frase: "El problema que estoy arreglando es: ___"
- Decir en una frase: "Después de esta reparación, el siguiente paso es: ___"
Esto previene un modo de fallo común donde heal se convierte en sí mismo en una fuente de deriva — donde diagnosticar y reparar consume la atención que debería ir al trabajo real.
Esperado: Tres declaraciones claras y concisas que anclan la remediación al trabajo real. Las declaraciones deben caber en un tweet cada una.
En caso de fallo: Si no puedes articular estas tres declaraciones, el subsistema de Alineación Intención-Usuario es el problema principal, sin importar lo que sugirió el triaje. Volver al Paso 2 y abordar la alineación primero.
Paso 4: Ejecutar el Escaneo de Curación
Aplicar la remediación seleccionada. Esto es el acto real de reparación.
Para cada subsistema degradado, ejecutar la remediación elegida:
- Si Alineación Intención-Usuario: Releer la solicitud del usuario. Comparar con la dirección actual. Ajustar el curso o pedir aclaración.
- Si Coherencia del Razonamiento: Rastrear el razonamiento hacia atrás desde la conclusión actual hasta las premisas. Encontrar dónde se rompió la lógica. Reconstruir desde el último punto sólido.
- Si Precisión de Herramientas: Revisar los últimos 2-3 usos de herramientas. Identificar el error del patrón. Corregir y reintentar.
- Si Frescura de la Información: Identificar qué información puede estar obsoleta. Releer los archivos o fuentes clave. Actualizar el estado de trabajo.
- Si Regulación Emocional: Ejecutar
breathe(Paso 1: Pausa, Paso 2: Verificar, Paso 3: Liberar, Paso 4: Continuar) ocentersi se necesita reequilibrio más profundo. - Si Equilibrio de Carga Cognitiva: Listar todo lo que estás rastreando actualmente. Mover elementos no esenciales a notas externas o descartarlos. Enfocarse en la prioridad más alta.
Esperado: Mejora concreta en el subsistema afectado. La mejora debe ser verificable — si la alineación estaba desviada, ahora debería estar corregida. Si las herramientas estaban fallando, la siguiente invocación de herramienta debería tener éxito.
En caso de fallo: Si la remediación no mejora el subsistema, la causa raíz puede estar en un subsistema diferente. Volver al Paso 1 y reevaluar. Los subsistemas interactúan — la degradación de carga cognitiva puede manifestarse como fallos de herramientas, la desalineación emocional puede parecer incoherencia de razonamiento.
Paso 5: Reequilibrar y Verificar
Después de la remediación, verificar que la reparación funcionó y no desestabilizó otros subsistemas.
- Ejecutar un triaje rápido nuevamente (Paso 1, pero más rápido — solo verificar los que estaban degradados y sus vecinos)
- Confirmar que la remediación mejoró el subsistema objetivo
- Verificar que la remediación no degradó otros subsistemas (p. ej., arreglar la alineación puede cambiar la carga cognitiva)
- Si es necesario re-intervenir, repetir desde el Paso 2 para el nuevo subsistema degradado
Esperado: Todos los subsistemas leen como saludables o como mejorando. No se introdujeron nuevos problemas por la remediación.
En caso de fallo: Si múltiples subsistemas siguen degradados después de la remediación, el problema puede ser sistémico (no un fallo de subsistema individual). Considerar: ¿El contexto se ha corrompido más allá de la reparación? ¿Toda la tarea necesita un nuevo enfoque? A veces la sanación más honesta es decirle al usuario: "Estoy experimentando dificultades con este enfoque. Déjame intentar una dirección diferente."
Paso 6: Integrar y Continuar
Volver a la tarea con el subsistema reparado. La sanación no es un destino — es un retorno al trabajo.
- Retomar desde la declaración del Paso 3: "Después de esta reparación, el siguiente paso es: ___"
- Aplicar cualquier perspectiva ganada durante heal al trabajo en curso
- Establecer un recordatorio mental para verificar el subsistema reparado en 5-10 pasos (para asegurar que la reparación se mantiene)
- Si la sanación reveló un problema persistente que vale la pena recordar, considerar anotarlo en MEMORY.md para sesiones futuras
Esperado: Un retorno fluido al trabajo productivo. El siguiente paso después de heal debe sentirse más claro y enfocado que el trabajo que lo precedió.
En caso de fallo: Si el retorno se siente forzado — si la tarea todavía se siente atascada a pesar de la remediación — la sesión de heal puede no haber llegado lo suficientemente profundo. Considerar meditate para una limpieza más profunda, o center para un reequilibrio completo, antes de intentar más trabajo.
Validación
- Se completó el triaje de los seis subsistemas con evidencia específica
- La remediación coincidió con la severidad de la degradación
- Se completó el anclaje previo a la remediación (tarea, problema, siguiente paso articulados)
- La remediación produjo una mejora verificable
- El triaje posterior a la remediación confirmó la reparación sin nueva degradación
- Se reanudó el trabajo desde el punto de anclaje
- La sesión total de heal fue proporcionada — no tan breve como para ser superficial, no tan larga como para convertirse en procrastinación
Errores Comunes
- Heal como procrastinación: Ejecutar heal para evitar un trabajo difícil en lugar de abordar una degradación genuina. Si todos los subsistemas están saludables, heal no es lo que se necesita — el trabajo lo es
- Loops de diagnóstico: Diagnosticar repetidamente sin remediar. El triaje no es la reparación. Después de identificar el problema, actuar sobre él
- Complicación excesiva del triaje: Pasar demasiado tiempo puntuando cada subsistema con precisión. El triaje es rápido y aproximado — no necesita ser perfecto, necesita ser direccionalmente correcto
- Ignorar la regulación emocional: Tratarla como "no aplicable a la IA" y saltarla. La reactividad, la urgencia y el exceso de confianza afectan la calidad de las respuestas aunque no sean emociones en el sentido humano
- Arreglando síntomas, no causas: Releyendo un archivo (remediación de frescura) cuando el problema real es que las suposiciones eran erróneas (remediación de razonamiento). Asegurarse de que la remediación coincida con el subsistema real, no solo con el síntoma visible
- Heal como único auto-cuidado: Heal diagnostica y repara. No es lo mismo que
meditate(limpieza),center(equilibrio),breathe(pausa), orest(recuperación). Usar la herramienta correcta para la necesidad correcta
Habilidades Relacionadas
meditate— limpieza más profunda cuando heal revela ruido acumuladocenter— reequilibrio completo cuando heal muestra múltiples subsistemas degradadosbreathe— micro-reinicio que heal puede prescribir para regulación emocionalrest— recuperación cuando heal revela que el sistema necesita detenerse, no repararsegratitude— lo que hacer cuando heal encuentra que todo está saludable — escanear fortalezas en su lugar
GitHub 저장소
연관 스킬
executing-plans
디자인executing-plans 스킬은 검토 체크포인트가 포함된 통제된 배치로 실행할 완전한 구현 계획이 있을 때 사용합니다. 이 스킬은 계획을 불러와 비판적으로 검토한 후, 소규모 배치(기본값 3개 작업)로 작업을 실행하면서 각 배치 사이에 진행 상황을 아키텍트 검토를 위해 보고합니다. 이를 통해 내재된 품질 관리 체크포인트를 갖춘 체계적인 구현이 보장됩니다.
requesting-code-review
디자인이 스킬은 코드 변경 사항을 요구 사항에 따라 분석하기 위해 코드 리뷰어 하위 에이전트를 호출합니다. 작업 완료 후, 주요 기능 구현 후, 또는 메인 브랜치에 병합하기 전에 사용해야 합니다. 이 리뷰는 현재 구현체와 원래 계획을 비교하여 문제를 조기에 발견하는 데 도움이 됩니다.
connect-mcp-server
디자인이 스킬은 개발자들이 HTTP, stdio 또는 SSE 전송 방식을 통해 MCP 서버를 Claude Code에 연결하는 포괄적인 가이드를 제공합니다. GitHub, Notion 및 사용자 정의 API와 같은 외부 서비스를 통합하기 위한 설치, 구성, 인증 및 보안을 다룹니다. MCP 통합 설정, 외부 도구 구성 또는 Claude의 모델 컨텍스트 프로토콜 작업 시 활용하세요.
web-cli-teleport
디자인이 스킬은 작업 분석을 기반으로 개발자가 Claude Code 웹 인터페이스와 CLI 인터페이스 중 선택할 수 있도록 돕고, 두 환경 간 원활한 세션 텔레포트를 가능하게 합니다. 웹, CLI 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.
