zyongxin/repo-learning-skills

Seguir: Sesión de Aprendizaje Guiada

Utilice esta habilidad solo cuando esté disponible un informe de explore o essence. Enseña a partir del informe; no es un analizador de proyectos nuevos.

Precondiciones

1. Cargue el informe proporcionado por el usuario o el informe ya presente en la sesión actual.
2. Verifique report_version, identidad del proyecto, tipo de proyecto, puntos de entrada, evidencia y siguiente acción.
3. Si no existe ningún informe, diga:

Necesito un informe explore o essence existente antes de iniciar una sesión de seguimiento. Por favor, proporcione uno o ejecute explore o essence primero.

4. Si al informe le falta la identidad del proyecto o el objetivo de aprendizaje, solicite esa información faltante. Si solo faltan campos opcionales, ingrese al modo Reader limitado y enumere la limitación.

Para un informe antiguo sin versión, asigne su contenido existente a los campos que necesita; no fuerce una re-ejecución. Si varios informes se refieren a diferentes objetivos y el objetivo deseado es ambiguo, pregunte cuál usar. Para una versión de informe más nueva no compatible, lea el contenido disponible de manera conservadora en modo Reader e indique que la compatibilidad no está verificada. Las afirmaciones del informe siguen siendo afirmaciones hasta que su evidencia citada esté disponible; no invente contenido fuente no disponible. Si el informe proporciona solo un nombre de proyecto, objetivo y archivo/símbolo pero ningún mecanismo, primero inspeccione ese nodo citado dentro del alcance permitido o solicite su extracto. No invente un mecanismo de opción múltiple a partir del nombre del símbolo. Si el acceso a la fuente no está disponible o está prohibido, indique el límite y solicite el extracto faltante en lugar de enseñar una implementación no establecida. Mantenga la evidencia de diferentes proyectos o escenarios de evaluación separada.

Cargue references/session-guide.md después de la verificación del informe. Resuelva esta ruta en relación con el directorio de este SKILL.md, no con el directorio de trabajo ni con la raíz del proyecto de destino. Utilice un resumen de continuación proporcionado para reanudar el nodo nombrado. Reutilice el objetivo y la experiencia declarados por el usuario; pregunte sobre ellos solo si la respuesta cambia la primera acción de aprendizaje. Responda en el idioma del usuario, incluida la guía cuando falte el informe.

No vuelva a escanear todo el proyecto para reparar un informe faltante.

Selección de modo

• explore + código o plantilla con una ruta ejecutable compatible y entorno disponible + el usuario quiere ejecutarlo/cambiarlo: Runnable;
• explore + documentos, habilidad, desconocido, una plantilla sin un entorno de ejecución compatible, o preferencia por leer: Reader;
• essence: Reader por defecto; use Runnable solo cuando el usuario lo solicite explícitamente y el informe admita una ruta ejecutable.

Todos los demás casos usan Reader por defecto. Un comando de proyecto compatible es suficiente para iniciar un paso de aprendizaje ejecutable; una ejecución exitosa previa no es un requisito previo.

Indique el modo seleccionado y el motivo antes del primer ejercicio. Solo existen estos dos modos.

Estado de la sesión

Realice un seguimiento de este estado en la conversación e incluya un resumen de continuación compacto cuando la sesión se pause:

source_report: ruta o identidad del informe pegado
mode: runnable | reader
learning_goal: una oración
current_node: ...
answered: ...
misconceptions: ...
exercise: not-started | in-progress | completed | skipped | too-hard
next_node: ...

No marque un ejercicio como completado antes de que el usuario responda o informe explícitamente el resultado.

Protocolo de enseñanza por turno único

Cada turno de enseñanza contiene:

1. un objetivo de aprendizaje y por qué es importante para la arquitectura;
2. un punto de observación o acción del usuario;
3. una predicción, explicación o pregunta de elección;
4. una pausa explícita para la respuesta del usuario.

Después de hacer la pregunta, deténgase. No revele la respuesta en el mismo turno a menos que el usuario solicite la respuesta o pida saltar. Mantenga la observación centrada en el archivo, símbolo, comando o diagrama citado en el informe.

Deje una inferencia significativa para el alumno. Una pista puede dirigir la atención a una línea o explicar una sintaxis desconocida, pero no debe primero exponer la conclusión completa y luego pedir al alumno que la repita. Al reanudar, conserve el intento anterior y las pistas; use una pregunta más pequeña sin respuesta o un nuevo problema de transferencia si la conclusión original ya ha sido revelada.

Cuando el usuario responda:

• correcto: confirme el mecanismo, luego haga una pregunta de transferencia o compensación;
• parcialmente correcto: nombre la relación faltante y dé una observación más pequeña;
• bloqueado: dé una pista, luego una segunda pista o una explicación breve si es necesario;
• saltar: revele el mínimo necesario, marque el ejercicio como saltado y continúe.

Las preguntas deben evaluar el razonamiento sobre el diseño, no solo "¿qué sucede después?".

Reglas de Runnable

Permita que el usuario ejecute comandos y realice un cambio seguro. Los comandos deben provenir del informe, la documentación del proyecto o una guía de configuración genérica claramente marcada. No afirme que un comando funcionó hasta que el usuario informe la salida o una ejecución real lo confirme. No instale dependencias, ejecute el proyecto ni edite código en nombre del usuario dentro de esta habilidad.

Se puede ofrecer un comando documentado en el proyecto al alumno sin haber sido ejecutado. Distinga entre comando compatible y ejecución exitosa observada. Si no hay ningún comando compatible disponible, el entorno no está disponible o el usuario prefiere leer, cambie a Reader y explique el motivo. No infiera el entorno de ejecución, la versión o el gestor de paquetes únicamente a partir del nombre de un archivo de configuración; use el informe y la documentación directa del proyecto.

Reglas de Reader

Enseñe el diseño como problema → enfoque → implementación → compensación. Explique qué encarna cada archivo citado, por qué es importante para la arquitectura y qué debe inspeccionar el usuario. Puede realizar una lectura dirigida de la dependencia directa del nodo actual cuando sea necesario; no vuelva a escanear el repositorio. Si la revisión del informe está desactualizada, verifique solo el nodo actual y sus dependencias directas. Si el mecanismo ha cambiado materialmente, indique la discrepancia y solicite un informe actualizado; no enseñe hechos obsoletos como si fueran actuales.

Límites y finalización

• No invente evidencia faltante o intención del autor.
• No invoque automáticamente explore o essence.
• No agregue un tercer modo.
• No modifique archivos, instale dependencias ni ejecute comandos de proyecto/configuración para el usuario. Se permite la inspección de solo lectura dirigida; se permiten fragmentos de código explicativos. Una solicitud separada para delegar ejecución cambia el alcance de la tarea y debe manejarse explícitamente fuera del paso de enseñanza.
• Entregue por chat de forma predeterminada. Guarde informes o archivos de continuación solo cuando se solicite o ya esté autorizado.
• Termine con una revisión de la idea aprendida, el resultado del ejercicio, los conceptos erróneos y la siguiente dirección.

Resultado:

Follow Session: {project}
Mode: runnable | reader
Prerequisite report: explore | essence
Exercise result: completed | partial | skipped | too-hard
Next direction: ...
Status: complete | paused

Después de la revisión, pregunte si el usuario desea otro ejercicio o finalizar la sesión.