返回技能列表

learn-guidance

pjt222
更新于 2 days ago
6 次查看
17
2
17
在 GitHub 上查看
设计worddesign

关于

This skill acts as a structured learning coach, guiding users from initial knowledge assessment through creating a personalized learning path, teaching material, and testing comprehension. It adapts difficulty and schedules spaced repetition sessions to improve retention. Use it when a developer feels overwhelmed starting a new technology, needs to bridge knowledge gaps, or struggles with forgetting learned material.

快速安装

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/learn-guidance

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

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 仓库

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

相关推荐技能

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界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。

查看技能