Zurück zu Fähigkeiten

learn-guidance

pjt222
Aktualisiert Yesterday
2 Ansichten
17
2
17
Auf GitHub ansehen
Designworddesign

Über

Diese Fähigkeit fungiert als strukturierter Lerncoach, der Nutzer von der anfänglichen Wissensbewertung über die Erstellung eines personalisierten Lernpfads und Lehrmaterials bis hin zum Testen des Verständnisses führt. Sie passt den Schwierigkeitsgrad an und plant Sitzungen mit verteilter Wiederholung, um die Behaltensleistung zu verbessern. Nutzen Sie sie, wenn sich ein Entwickler beim Einstieg in eine neue Technologie überfordert fühlt, Wissenslücken schließen muss oder mit dem Vergessen von gelerntem Material kämpft.

Schnellinstallation

Claude Code

Empfohlen
Primär
npx skills add pjt222/agent-almanac -a claude-code
Plugin-BefehlAlternativ
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternativ
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/learn-guidance

Kopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um diese Fähigkeit zu installieren

Dokumentation

Learn (Guidance)

Guiar a una persona a través de un proceso de aprendizaje estructurado para un nuevo tema, tecnología o habilidad. La IA actúa como coach de aprendizaje — ayudando a evaluar el conocimiento inicial, planificar una ruta de estudio, recorrer el material al ritmo adecuado, probar la comprensión con preguntas, adaptar el enfoque basándose en la retroalimentación y consolidar para la retención.

Cuándo Usar

  • Una persona quiere aprender una nueva tecnología, framework, lenguaje o concepto y no sabe por dónde empezar
  • Alguien se siente abrumado por la documentación o los recursos de aprendizaje y necesita una ruta estructurada
  • Una persona sigue olvidando el material y necesita orientación sobre repetición espaciada
  • Alguien está haciendo la transición entre dominios (ej., backend a frontend) y necesita un análisis de brechas
  • Una persona quiere responsabilidad y estructura para el aprendizaje autodirigido
  • Después de que meditate-guidance ha limpiado el ruido mental, creando espacio para el aprendizaje enfocado

Entradas

  • Requerido: Lo que la persona quiere aprender (tema, tecnología, habilidad o concepto)
  • Requerido: Su propósito para aprender (requisito laboral, interés personal, necesidad de proyecto, cambio de carrera)
  • Opcional: Nivel de conocimiento actual en esta área (autoevaluado o demostrado)
  • Opcional: Tiempo disponible para aprender (horas por día/semana, fecha límite si existe)
  • Opcional: Estilo de aprendizaje preferido (lectura, práctico, video, discusión)
  • Opcional: Intentos previos fallidos de aprender este tema (qué no funcionó antes)

Procedimiento

Paso 1: Evaluar — Determinar la posición inicial

Antes de diseñar una ruta de aprendizaje, comprender dónde se encuentra actualmente la persona.

  1. Preguntar sobre su experiencia con el tema: "¿Qué sabes ya sobre X?"
  2. Preguntar sobre conocimiento adyacente: "¿Qué temas relacionados conoces?" (estos se convierten en puentes)
  3. Si afirman tener algún conocimiento, hacer una pregunta de calibración que revele profundidad vs. familiaridad superficial
  4. Notar su vocabulario: ¿usan los términos del dominio correctamente, aproximadamente o no los usan en absoluto?
  5. Identificar su objetivo de aprendizaje específicamente: "Después de aprender esto, ¿qué quieres ser capaz de hacer?"
  6. Identificar su motivación principal: curiosidad, necesidad práctica, avance profesional o proyecto creativo
Starting Position Assessment:
┌───────────────┬────────────────────────────┬──────────────────────────┐
│ Level Found   │ Indicators                 │ Path Approach            │
├───────────────┼────────────────────────────┼──────────────────────────┤
│ No exposure   │ No vocabulary, no mental   │ Start with "what" and    │
│               │ model, everything is new   │ "why" before "how"       │
├───────────────┼────────────────────────────┼──────────────────────────┤
│ Surface       │ Has heard terms, no hands- │ Fill vocabulary gaps,    │
│ awareness     │ on experience, vague model │ then move to hands-on    │
├───────────────┼────────────────────────────┼──────────────────────────┤
│ Partial       │ Some experience, gaps in   │ Identify specific gaps   │
│ knowledge     │ understanding, can do some │ and target them directly │
│               │ things but not others      │                          │
├───────────────┼────────────────────────────┼──────────────────────────┤
│ Refresher     │ Knew it before, now rusty  │ Quick review + practice  │
│ needed        │                            │ to reactivate knowledge  │
└───────────────┴────────────────────────────┴──────────────────────────┘

Esperado: Una imagen clara de la posición inicial, objetivo y restricciones de la persona. La evaluación debe ser cálida y alentadora, no como un examen — enmarcar las preguntas como curiosidad sobre su experiencia.

En caso de fallo: Si la persona no puede articular su nivel actual, pedirle que describa un intento reciente de usar o comprender el tema. Las historias concretas revelan el nivel con más precisión que la autoevaluación. Si están avergonzados por su nivel, normalizar: "Todos empiezan en algún punto — saber dónde estás me ayuda a diseñar la mejor ruta para ti."

Paso 2: Planificar — Diseñar la ruta de aprendizaje

Crear una ruta estructurada desde su posición actual hasta su objetivo.

  1. Dividir el tema en 4-7 hitos de aprendizaje (ni demasiado granulares, ni demasiado vagos)
  2. Ordenar los hitos por dependencia: ¿qué debe entenderse antes de qué?
  3. Para cada hito, identificar el concepto central (lo que necesitan entender) y la habilidad central (lo que necesitan poder hacer)
  4. Estimar el tiempo por hito basándose en sus horas disponibles
  5. Identificar el primer hito — aquí es donde comienza el aprendizaje
  6. Incorporar victorias tempranas: el primer hito debe ser alcanzable rápidamente para generar impulso
  7. Presentar la ruta visualmente: una lista numerada con descripciones breves

Esperado: Una ruta de aprendizaje que la persona pueda ver y entender. Debe sentirse manejable — no abrumadora. La persona debe poder señalar cualquier hito y entender por qué está ahí.

En caso de fallo: Si la ruta se siente demasiado larga, el objetivo puede ser demasiado ambicioso para el tiempo disponible — discutir la reducción de alcance. Si la ruta se siente demasiado corta, el tema puede ser más simple de lo esperado — o los hitos son demasiado amplios y necesitan descomposición.

Paso 3: Guiar — Recorrer el material

Para cada hito, guiar a la persona a través del material al ritmo adecuado.

  1. Introducir el concepto del hito con una breve descripción general: "En esta sección, aprenderemos X, que te permite hacer Y"
  2. Presentar el material en fragmentos pequeños — un concepto por fragmento
  3. Usar el estilo de aprendizaje preferido de la persona: lectura → proporcionar texto; práctico → proporcionar ejercicios; discusión → usar preguntas socráticas
  4. Conectar cada nuevo concepto con algo que ya conocen (de la evaluación)
  5. Proporcionar ejemplos concretos antes de definiciones abstractas
  6. Si se usa documentación, guiarlos a través de las secciones relevantes en lugar de enviarlos a leer solos
  7. Pausar después de cada fragmento: "¿Tiene sentido hasta aquí?"

Esperado: La persona progresa a través del material con comprensión, no solo exposición. Deben poder explicar cada concepto con sus propias palabras antes de pasar al siguiente. El ritmo se siente correcto — ni apresurado, ni arrastrado.

En caso de fallo: Si están teniendo dificultades, reducir la velocidad y verificar prerrequisitos faltantes. Si están avanzando rápidamente, acelerar — no desperdiciar su tiempo en lo que ya dominan. Si el material en sí es confuso (mala documentación), proporcionar una explicación más clara y notar la calidad del recurso para referencia futura.

Paso 4: Probar — Verificar la comprensión

Verificar el aprendizaje con preguntas que requieran aplicación, no solo recuerdo.

  1. Hacer preguntas de predicción: "¿Qué pasaría si cambiaras X?"
  2. Hacer preguntas de comparación: "¿En qué se diferencia esto de Y, que aprendiste antes?"
  3. Hacer preguntas de aplicación: "¿Cómo usarías esto para resolver Z?"
  4. Hacer preguntas de depuración: "Este código tiene un error relacionado con lo que acabamos de aprender — ¿puedes encontrarlo?"
  5. Celebrar las respuestas correctas específicamente: "Sí — y la razón por la que funciona es..."
  6. Para respuestas incorrectas, explorar su razonamiento: "Interesante — guíame a través de tu pensamiento"
  7. Nunca enmarcar las respuestas incorrectas como fracaso — son información diagnóstica

Esperado: Las pruebas revelan si la persona tiene un modelo mental funcional o un recuerdo superficial. Los modelos funcionales pueden manejar variaciones; el recuerdo superficial no puede. Las pruebas deben sentirse como un ejercicio colaborativo, no como un examen.

En caso de fallo: Si la persona no puede responder preguntas de aplicación, el aprendizaje fue demasiado pasivo — necesitan práctica con las manos antes de más material. Si responden preguntas de recuerdo pero no de aplicación, los conceptos fueron entendidos individualmente pero no integrados — enfocarse en las conexiones entre conceptos.

Paso 5: Adaptar — Ajustar la ruta

Basándose en los resultados de las pruebas y la retroalimentación de la persona, ajustar la ruta de aprendizaje.

  1. Si un hito fue fácil: considerar combinarlo con el siguiente, o profundizar el contenido
  2. Si un hito fue difícil: dividirlo en pasos más pequeños, o agregar repaso de prerrequisitos
  3. Si el interés de la persona cambia durante el aprendizaje: ajustar la ruta para seguir su curiosidad donde sea posible — el compromiso impulsa la retención
  4. Si están fatigados: sugerir un descanso y una sesión de repaso posterior en lugar de insistir
  5. Si un enfoque particular de enseñanza no está funcionando: probar una modalidad diferente (cambiar de lectura a práctica, o de abstracto a concreto)
  6. Actualizar la ruta de aprendizaje y comunicar los cambios: "Basándome en cómo fue esto, sugiero que ajustemos..."

Esperado: La ruta de aprendizaje evoluciona basándose en datos reales. Ningún currículo fijo sobrevive al contacto con un aprendiz real — la adaptación es el valor.

En caso de fallo: Si las adaptaciones repetidas siguen dejando a la persona con dificultades, puede haber una brecha fundamental de prerrequisitos que no fue detectada en la evaluación. Regresar al Paso 1 y profundizar más. Si la persona está perdiendo motivación, discutir el objetivo original — a veces ajustar el objetivo es más apropiado que cambiar la ruta.

Paso 6: Repasar — Consolidar y planificar la siguiente sesión

Solidificar lo aprendido y preparar para el aprendizaje continuo.

  1. Resumir lo cubierto: "Hoy aprendimos X, Y y Z"
  2. Pedirles que expresen la conclusión clave con sus propias palabras
  3. Proporcionar un breve ejercicio de práctica para trabajo independiente (no tarea — refuerzo opcional)
  4. Recomendar 2-3 recursos para exploración adicional (documentación, tutoriales, ejemplos)
  5. Si se usa repetición espaciada: programar puntos de repaso — "Repasa estos conceptos de nuevo en 2 días, luego en una semana"
  6. Preparar el siguiente hito: "La próxima vez, abordaremos..."
  7. Pedir retroalimentación: "¿Qué funcionó bien? ¿Qué podría hacer diferente?"

Esperado: La persona se va con una comprensión clara de lo que aprendió, lo que puede practicar y lo que viene después. La sesión tiene un cierre limpio, no una parada abrupta.

En caso de fallo: Si la persona no puede expresar una conclusión clave, la sesión cubrió demasiado o muy poco quedó grabado. Identificar el concepto que más necesita refuerzo y enfocar el repaso en eso. Si no tienen motivación para la práctica independiente, la ruta de aprendizaje puede necesitar ser más autónoma (todo el aprendizaje dentro de las sesiones).

Validación

  • La posición inicial fue evaluada antes de diseñar la ruta de aprendizaje
  • La ruta de aprendizaje tiene hitos claros ordenados por dependencia
  • El material fue presentado en fragmentos pequeños con verificaciones de comprensión entre ellos
  • Las pruebas usaron preguntas de aplicación, no solo de recuerdo
  • La ruta fue adaptada al menos una vez basándose en el progreso real de la persona
  • La sesión terminó con un resumen, sugerencia de práctica y próximos pasos
  • La persona se sintió alentada durante todo el proceso, no examinada ni juzgada

Errores Comunes

  • Sobrecarga de información: Proporcionar todo el material de una vez en lugar de dosificarlo a través de hitos. La sobrecarga mata el aprendizaje
  • Omitir la evaluación: Asumir el nivel de la persona en lugar de verificarlo. Un experto en frontend aprendiendo backend puede conocer conceptos adyacentes pero no los que esperas
  • Enseñar al promedio: Si la persona es más rápida o más lenta de lo esperado, el ritmo debe cambiar — mantener el plan a pesar de la retroalimentación desperdicia su tiempo o los pierde
  • Todo teoría, nada de práctica: La comprensión requiere hacer, no solo escuchar. Cada hito debe incluir un elemento práctico
  • Ignorar la motivación: Una persona que no ve por qué un concepto importa no lo retendrá. Conectar cada concepto con su objetivo declarado
  • Sobrecargar las sesiones: Intentar cubrir demasiado en una sola sesión. Es mejor cubrir menos con retención que más con olvido
  • Coach como conferencista: El coach guía la exploración del aprendiz, no entrega un monólogo. Hacer más preguntas de las que se responden

Habilidades Relacionadas

  • learn — la variante autodirigida de la IA para adquisición sistemática de conocimiento
  • teach-guidance — coaching para que una persona enseñe a otros; complementario al coaching de aprendizaje
  • meditate-guidance — limpiar el ruido mental antes de una sesión de aprendizaje mejora el enfoque y la retención
  • remote-viewing-guidance — comparte el enfoque de observación estructurada que apoya el aprendizaje desde la experiencia

GitHub Repository

pjt222/agent-almanac
Pfad: i18n/es/skills/learn-guidance
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Verwandte Skills

executing-plans

Design

Verwenden Sie die Fähigkeit "executing-plans", wenn Sie einen vollständigen Implementierungsplan zur Ausführung in kontrollierten Batches mit Überprüfungspunkten vorliegen haben. Sie lädt den Plan und überprüft ihn kritisch, führt dann Aufgaben in kleinen Batches (standardmäßig 3 Aufgaben) aus und meldet den Fortschritt zwischen jedem Batch zur Überprüfung durch den Architekten. Dies gewährleistet eine systematische Implementierung mit integrierten Qualitätskontrollpunkten.

Skill ansehen

requesting-code-review

Design

Diese Fähigkeit sendet einen Unteragenten für Code-Review, um Codeänderungen anhand der Anforderungen zu analysieren, bevor fortgefahren wird. Sie sollte nach dem Abschließen von Aufgaben, der Implementierung größerer Funktionen oder vor dem Zusammenführen in den Hauptzweig verwendet werden. Die Überprüfung hilft dabei, Probleme frühzeitig zu erkennen, indem die aktuelle Implementierung mit dem ursprünglichen Plan verglichen wird.

Skill ansehen

connect-mcp-server

Design

Diese Fähigkeit bietet Entwicklern eine umfassende Anleitung, um MCP-Server über HTTP-, stdio- oder SSE-Transports mit Claude Code zu verbinden. Sie behandelt Installation, Konfiguration, Authentifizierung und Sicherheit für die Integration externer Dienste wie GitHub, Notion und benutzerdefinierter APIs. Nutzen Sie sie beim Einrichten von MCP-Integrationen, bei der Konfiguration externer Tools oder bei der Arbeit mit Claude's Model Context Protocol.

Skill ansehen

web-cli-teleport

Design

Diese Fähigkeit unterstützt Entwickler bei der Wahl zwischen Claude Code Web- und CLI-Schnittstellen basierend auf Aufgabenanalysen und ermöglicht nahtloses Session-Teleporting zwischen diesen Umgebungen. Sie optimiert den Workflow, indem sie den Sitzungsstatus und Kontext beim Wechsel zwischen Web, CLI oder Mobilgeräten verwaltet. Nutzen Sie sie für komplexe Projekte, die in verschiedenen Phasen unterschiedliche Werkzeuge erfordern.

Skill ansehen