heal
关于
The `heal` skill enables Claude to perform self-diagnosis and repair by evaluating six key subsystems (like reasoning coherence and tool accuracy) and applying targeted remediation. Use it when response quality degrades during long sessions, after repeated tool failures, or to check for drift in complex multi-step tasks. It automatically selects, executes, and verifies fixes to restore performance.
快速安装
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/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
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
设计该Skill用于当开发者提供完整实施计划时,以受控批次方式执行代码实现。它会先审阅计划并提出疑问,然后分批次执行任务(默认每批3个任务),并在批次间暂停等待审查。关键特性包括分批次执行、内置检查点和架构师审查机制,确保复杂系统实现的可控性。
requesting-code-review
设计该Skill可在完成任务、实现主要功能或合并代码前自动调度代码审查子代理,确保实现符合需求和计划。它支持通过指定git SHA范围进行精准的代码变更审查,帮助开发者在关键节点及时发现潜在问题。核心原则是"早审查、勤审查",适用于开发流程的各个关键阶段。
connect-mcp-server
设计这个Skill指导开发者如何将MCP服务器连接到Claude Code,支持HTTP、stdio和SSE三种传输协议。它涵盖了从安装配置到认证安全的完整流程,适用于集成GitHub、Notion、数据库等外部服务。当开发者需要添加集成、配置外部工具或提及MCP相关功能时,这个Skill能提供实用的操作指南。
web-cli-teleport
设计该Skill帮助开发者根据任务特性选择Claude Code的Web或CLI界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。
