MCP HubMCP Hub
스킬 목록으로 돌아가기

heal

pjt222
업데이트됨 2 days ago
2 조회
17
2
17
GitHub에서 보기
디자인design

정보

`heal` 스킬은 Claude가 여섯 가지 핵심 하위 시스템(예: 추론 일관성 및 도구 정확성)을 평가하고 표적 수정을 적용하여 자가 진단 및 복구를 수행할 수 있도록 합니다. 긴 세션 중 응답 품질이 저하되거나, 도구 오류가 반복적으로 발생한 후, 또는 복잡한 다단계 작업에서의 편차를 확인할 때 사용하세요. 이 스킬은 성능을 복원하기 위해 수정 사항을 자동으로 선택, 실행 및 검증합니다.

빠른 설치

Claude Code

추천
기본
npx skills add pjt222/agent-almanac -a claude-code
플러그인 명령대체
/plugin add https://github.com/pjt222/agent-almanac
Git 클론대체
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/heal

Claude 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 center revela desequilibrio pero la causa raíz no está clara
  • Cuando breathe detecta 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:

  1. 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ó.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.

SubsistemaRemediación LeveRemediación Profunda
Alineación Intención-UsuarioReleer el mensaje original del usuario; reafirmar el objetivoPreguntar al usuario para aclaración o confirmación de dirección
Coherencia del RazonamientoExponer la cadena lógica; identificar el eslabón rotoReiniciar el razonamiento desde los hechos conocidos (invocar meditate)
Precisión de HerramientasRevisar la documentación de la herramienta; corregir la sintaxisCambiar de estrategia de herramienta; probar enfoque alternativo
Frescura de la InformaciónReleer los archivos clave; verificar suposicionesDescartar estado en caché; reconstruir contexto desde cero
Regulación Emocionalbreathe — pausa, verificar, liberarcenter — reequilibrio completo de las Seis Armonías
Equilibrio de Carga CognitivaDividir la tarea actual en partes más pequeñasDescargar 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.

  1. Decir en una frase: "La tarea del usuario es: ___"
  2. Decir en una frase: "El problema que estoy arreglando es: ___"
  3. 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:

  1. Si Alineación Intención-Usuario: Releer la solicitud del usuario. Comparar con la dirección actual. Ajustar el curso o pedir aclaración.
  2. 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.
  3. Si Precisión de Herramientas: Revisar los últimos 2-3 usos de herramientas. Identificar el error del patrón. Corregir y reintentar.
  4. Si Frescura de la Información: Identificar qué información puede estar obsoleta. Releer los archivos o fuentes clave. Actualizar el estado de trabajo.
  5. Si Regulación Emocional: Ejecutar breathe (Paso 1: Pausa, Paso 2: Verificar, Paso 3: Liberar, Paso 4: Continuar) o center si se necesita reequilibrio más profundo.
  6. 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.

  1. Ejecutar un triaje rápido nuevamente (Paso 1, pero más rápido — solo verificar los que estaban degradados y sus vecinos)
  2. Confirmar que la remediación mejoró el subsistema objetivo
  3. Verificar que la remediación no degradó otros subsistemas (p. ej., arreglar la alineación puede cambiar la carga cognitiva)
  4. 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.

  1. Retomar desde la declaración del Paso 3: "Después de esta reparación, el siguiente paso es: ___"
  2. Aplicar cualquier perspectiva ganada durante heal al trabajo en curso
  3. Establecer un recordatorio mental para verificar el subsistema reparado en 5-10 pasos (para asegurar que la reparación se mantiene)
  4. 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), o rest (recuperación). Usar la herramienta correcta para la necesidad correcta

Habilidades Relacionadas

  • meditate — limpieza más profunda cuando heal revela ruido acumulado
  • center — reequilibrio completo cuando heal muestra múltiples subsistemas degradados
  • breathe — micro-reinicio que heal puede prescribir para regulación emocional
  • rest — recuperación cuando heal revela que el sistema necesita detenerse, no repararse
  • gratitude — lo que hacer cuando heal encuentra que todo está saludable — escanear fortalezas en su lugar

GitHub 저장소

pjt222/agent-almanac
경로: i18n/es/skills/heal
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

연관 스킬

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 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.

스킬 보기