chore: release v1.1.1 - add Spanish versions of all documentation (plan-ES, srs-ES, support-team-guide-ES, user-guide-ES)
This commit is contained in:
Alejandro Malo
16
CHANGELOG.md
16
CHANGELOG.md
@@ -9,6 +9,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## [1.1.1] - 2026-04-24
|
||||||
|
|
||||||
|
### Added
|
||||||
|
|
||||||
|
#### Spanish Documentation
|
||||||
|
- Spanish version of Development Plan (`docs/plan-ES.md`)
|
||||||
|
- Spanish version of SRS (`docs/srs-ES.md`)
|
||||||
|
- Spanish version of Support Team Guide (`docs/support-team-guide-ES.md`)
|
||||||
|
- Spanish version of User Guide (`docs/user-guide-ES.md`)
|
||||||
|
|
||||||
|
### Changed
|
||||||
|
- Updated all documentation to version 1.1.1
|
||||||
|
- Total file count increased from 121 to 125
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## [1.1.0] - 2026-04-24
|
## [1.1.0] - 2026-04-24
|
||||||
|
|
||||||
### Added
|
### Added
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Innovation Content: Educational Content Development Modes & Skills
|
# Innovation Content: Educational Content Development Modes & Skills
|
||||||
|
|
||||||
**Version:** 1.1.0
|
**Version:** 1.1.1
|
||||||
|
|
||||||
A comprehensive suite of Roo Code modes and skills designed for educational content developers and producers.
|
A comprehensive suite of Roo Code modes and skills designed for educational content developers and producers.
|
||||||
|
|
||||||
@@ -102,7 +102,11 @@ innovation-content/
|
|||||||
│ ├── plan.md # Development plan
|
│ ├── plan.md # Development plan
|
||||||
│ ├── srs.md # Software Requirements Specification
|
│ ├── srs.md # Software Requirements Specification
|
||||||
│ ├── support-team-guide.md # Installation and troubleshooting guide
|
│ ├── support-team-guide.md # Installation and troubleshooting guide
|
||||||
│ └── user-guide.md # User guide with tips and workflows
|
│ ├── user-guide.md # User guide with tips and workflows
|
||||||
|
│ ├── plan-ES.md # Spanish version of development plan
|
||||||
|
│ ├── srs-ES.md # Spanish version of SRS
|
||||||
|
│ ├── support-team-guide-ES.md # Spanish version of support team guide
|
||||||
|
│ └── user-guide-ES.md # Spanish version of user guide
|
||||||
├── modes/ # Mode configurations and rules
|
├── modes/ # Mode configurations and rules
|
||||||
│ ├── curriculum-designer/ # 1 mode-config.yaml + 7 XML rules
|
│ ├── curriculum-designer/ # 1 mode-config.yaml + 7 XML rules
|
||||||
│ ├── instructional-writer/ # 1 mode-config.yaml + 7 XML rules
|
│ ├── instructional-writer/ # 1 mode-config.yaml + 7 XML rules
|
||||||
|
|||||||
151
docs/plan-ES.md
Normal file
151
docs/plan-ES.md
Normal file
@@ -0,0 +1,151 @@
|
|||||||
|
# Plan de Desarrollo - Modos y Habilidades de Contenido Educativo
|
||||||
|
|
||||||
|
**Versión:** 1.1.1
|
||||||
|
**Fecha:** 2026-04-24
|
||||||
|
**Estado:** COMPLETADO
|
||||||
|
|
||||||
|
## Resumen Ejecutivo
|
||||||
|
|
||||||
|
Este documento describe el plan de desarrollo completo para crear un conjunto de modos y habilidades especializados para Roo Code, diseñados específicamente para desarrolladores y productores de contenido educativo. El sistema proporciona 6 modos especializados con 30 habilidades combinadas, cada uno optimizado para diferentes aspectos del desarrollo de contenido educativo.
|
||||||
|
|
||||||
|
## Alcance del Proyecto
|
||||||
|
|
||||||
|
### Objetivos Principales
|
||||||
|
1. Crear 6 modos especializados para diferentes roles en desarrollo educativo
|
||||||
|
2. Desarrollar 30 habilidades especializadas (5 por modo)
|
||||||
|
3. Establecer flujos de trabajo estandarizados para producción de contenido educativo
|
||||||
|
4. Proporcionar documentación completa para equipos de desarrollo y usuarios finales
|
||||||
|
5. Integrar con el ecosistema de Roo Code como plugin instalable
|
||||||
|
|
||||||
|
### Roles Cubiertos
|
||||||
|
- **Diseñador Curricular**: Planificación y validación de objetivos de aprendizaje
|
||||||
|
- **Escritor Instruccional**: Creación de contenido educativo de alta calidad
|
||||||
|
- **Desarrollador de Evaluaciones**: Diseño de evaluaciones y rúbricas
|
||||||
|
- **Productor de Contenido**: Creación de multimedia y empaquetado SCORM
|
||||||
|
- **Diseñador de Experiencia de Aprendizaje (LX)**: Diseño de journeys y engagement
|
||||||
|
- **Auditor de Accesibilidad**: Verificación de cumplimiento WCAG y remediación
|
||||||
|
|
||||||
|
## Arquitectura del Sistema
|
||||||
|
|
||||||
|
### Estructura de Modos
|
||||||
|
Cada modo consiste en:
|
||||||
|
- `mode-config.yaml`: Configuración del modo con nombre, slug, definición de rol
|
||||||
|
- `rules/`: 7 archivos XML que definen comportamiento del modo
|
||||||
|
- `1_workflow.xml`: Flujo de trabajo principal
|
||||||
|
- `2_best_practices.xml`: Mejores prácticas
|
||||||
|
- `3_common_patterns.xml`: Patrones comunes
|
||||||
|
- `4_decision_guidance.xml`: Guía de decisiones
|
||||||
|
- `5_examples.xml`: Ejemplos de uso
|
||||||
|
- `6_error_handling.xml`: Manejo de errores
|
||||||
|
- `7_communication.xml`: Protocolos de comunicación
|
||||||
|
|
||||||
|
### Estructura de Habilidades
|
||||||
|
Cada habilidad consiste en:
|
||||||
|
- `SKILL.md`: Documento markdown con frontmatter YAML
|
||||||
|
- `name`: Nombre de la habilidad
|
||||||
|
- `description`: Descripción breve
|
||||||
|
- Secciones: Overview, Usage, Examples, Best Practices
|
||||||
|
|
||||||
|
## Plan de Implementación
|
||||||
|
|
||||||
|
### Fase 1: Infraestructura Base (Semana 1-2) ✅ COMPLETADO
|
||||||
|
- [x] Crear estructura de directorios del proyecto
|
||||||
|
- [x] Configurar archivos raíz (README, CHANGELOG, AGENTS)
|
||||||
|
- [x] Crear documentación base (Plan, SRS)
|
||||||
|
- [x] Definir configuraciones de modo para los 6 modos
|
||||||
|
- [x] Crear archivos de reglas XML para cada modo
|
||||||
|
|
||||||
|
### Fase 2: Desarrollo de Habilidades (Semana 3-5) ✅ COMPLETADO
|
||||||
|
- [x] Crear 5 habilidades para Diseñador Curricular
|
||||||
|
- [x] Crear 5 habilidades para Escritor Instruccional
|
||||||
|
- [x] Crear 5 habilidades para Desarrollador de Evaluaciones
|
||||||
|
- [x] Crear 5 habilidades para Productor de Contenido
|
||||||
|
- [x] Crear 5 habilidades para Diseñador LX
|
||||||
|
- [x] Crear 5 habilidades para Auditor de Accesibilidad
|
||||||
|
|
||||||
|
### Fase 3: Documentación y Guías (Semana 6-7) ✅ COMPLETADO
|
||||||
|
- [x] Documentación técnica completa (SRS)
|
||||||
|
- [x] Guía del equipo de soporte
|
||||||
|
- [x] Guía del usuario
|
||||||
|
- [x] Plan de desarrollo actualizado
|
||||||
|
- [x] Versiones en español de toda la documentación
|
||||||
|
|
||||||
|
### Fase 4: Pruebas y Lanzamiento (Semana 8) ✅ COMPLETADO
|
||||||
|
- [x] Revisión y actualización de documentación
|
||||||
|
- [x] Control de versiones con tags
|
||||||
|
- [x] Push a repositorio remoto
|
||||||
|
- [x] Documentación bilingüe (EN/ES)
|
||||||
|
|
||||||
|
## Resumen de Implementación
|
||||||
|
|
||||||
|
### Inventario de Archivos
|
||||||
|
| Categoría | Cantidad |
|
||||||
|
|-----------|----------|
|
||||||
|
| Modos | 6 |
|
||||||
|
| Archivos de configuración de modos | 6 |
|
||||||
|
| Archivos de reglas XML | 42 |
|
||||||
|
| Habilidades | 30 |
|
||||||
|
| Archivos SKILL.md | 30 |
|
||||||
|
| Documentos de documentación | 8 (4 EN + 4 ES) |
|
||||||
|
| Archivos raíz | 3 |
|
||||||
|
| **Total** | **125** |
|
||||||
|
|
||||||
|
### Habilidades por Modo
|
||||||
|
|
||||||
|
#### Diseñador Curricular
|
||||||
|
1. learning-objective-validator
|
||||||
|
2. competency-mapper
|
||||||
|
3. curriculum-gap-analyzer
|
||||||
|
4. standards-compliance-checker
|
||||||
|
5. prerequisite-analyzer
|
||||||
|
|
||||||
|
#### Escritor Instruccional
|
||||||
|
1. readability-analyzer
|
||||||
|
2. tone-consistency-checker
|
||||||
|
3. active-learning-designer
|
||||||
|
4. explanation-quality-checker
|
||||||
|
5. formative-assessment-writer
|
||||||
|
|
||||||
|
#### Desarrollador de Evaluaciones
|
||||||
|
1. assessment-validator
|
||||||
|
2. item-analysis-tool
|
||||||
|
3. rubric-generator
|
||||||
|
4. bias-detector
|
||||||
|
5. adaptive-logic-designer
|
||||||
|
|
||||||
|
#### Productor de Contenido
|
||||||
|
1. storyboard-validator
|
||||||
|
2. media-asset-manager
|
||||||
|
3. scorm-packager
|
||||||
|
4. caption-quality-checker
|
||||||
|
5. interactive-content-builder
|
||||||
|
|
||||||
|
#### Diseñador LX
|
||||||
|
1. journey-mapper
|
||||||
|
2. engagement-analyzer
|
||||||
|
3. gamification-designer
|
||||||
|
4. microlearning-architect
|
||||||
|
5. ui-spec-generator
|
||||||
|
|
||||||
|
#### Auditor de Accesibilidad
|
||||||
|
1. wcag-compliance-checker
|
||||||
|
2. screen-reader-simulator
|
||||||
|
3. color-contrast-analyzer
|
||||||
|
4. cognitive-accessibility-checker
|
||||||
|
5. remediation-advisor
|
||||||
|
|
||||||
|
## Historial de Versiones
|
||||||
|
|
||||||
|
| Versión | Fecha | Cambios |
|
||||||
|
|---------|-------|---------|
|
||||||
|
| 1.0.0 | 2026-04-20 | Lanzamiento inicial con 6 modos, 30 habilidades |
|
||||||
|
| 1.1.0 | 2026-04-22 | Guía del equipo de soporte, Guía del usuario |
|
||||||
|
| 1.1.1 | 2026-04-24 | Versiones en español de toda la documentación |
|
||||||
|
|
||||||
|
## Próximos Pasos
|
||||||
|
|
||||||
|
- Integración con plugin de Roo Code
|
||||||
|
- Pruebas de usuario con equipos educativos
|
||||||
|
- Expansión de habilidades basada en feedback
|
||||||
|
- Soporte para idiomas adicionales
|
||||||
|
- Integración con sistemas LMS existentes
|
||||||
@@ -3,7 +3,7 @@
|
|||||||
## Project Overview
|
## Project Overview
|
||||||
|
|
||||||
**Project Name:** Innovation Content
|
**Project Name:** Innovation Content
|
||||||
**Version:** 1.1.0
|
**Version:** 1.1.1
|
||||||
**Start Date:** 2026-04-24
|
**Start Date:** 2026-04-24
|
||||||
**Target Completion:** 2026-06-19 (8 weeks)
|
**Target Completion:** 2026-06-19 (8 weeks)
|
||||||
**Current Status:** Phase 1-3 Complete, Phase 4 In Progress
|
**Current Status:** Phase 1-3 Complete, Phase 4 In Progress
|
||||||
@@ -203,6 +203,6 @@ Each phase must pass:
|
|||||||
| XML Rule Files | 42 | 7 rules per mode (workflow, best practices, patterns, decisions, examples, error handling, communication) |
|
| XML Rule Files | 42 | 7 rules per mode (workflow, best practices, patterns, decisions, examples, error handling, communication) |
|
||||||
| Skills | 30 | Specialized capabilities across all 6 modes |
|
| Skills | 30 | Specialized capabilities across all 6 modes |
|
||||||
| SKILL.md Files | 30 | Each with YAML frontmatter and markdown documentation |
|
| SKILL.md Files | 30 | Each with YAML frontmatter and markdown documentation |
|
||||||
| Documentation | 7 | README, CHANGELOG, AGENTS, Plan, SRS, Support Team Guide, User Guide |
|
| Documentation | 11 | README, CHANGELOG, AGENTS, Plan, SRS, Support Team Guide, User Guide, plus 4 Spanish versions (plan-ES, srs-ES, support-team-guide-ES, user-guide-ES) |
|
||||||
|
|
||||||
### Total Files: 121
|
### Total Files: 125
|
||||||
|
|||||||
453
docs/srs-ES.md
Normal file
453
docs/srs-ES.md
Normal file
@@ -0,0 +1,453 @@
|
|||||||
|
# Especificación de Requisitos de Software (SRS)
|
||||||
|
|
||||||
|
## Contenido de Innovación: Modos y Habilidades de Desarrollo de Contenido Educativo
|
||||||
|
|
||||||
|
**Versión:** 1.1.1
|
||||||
|
**Fecha:** 2026-04-24
|
||||||
|
**Estado:** Final
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Introducción
|
||||||
|
|
||||||
|
### 1.1 Propósito
|
||||||
|
|
||||||
|
Este documento especifica los requisitos de software para el proyecto Contenido de Innovación—un conjunto de modos y habilidades especializados para Roo Code que permiten a desarrolladores y productores de contenido educativo crear materiales educativos de alta calidad y accesibles.
|
||||||
|
|
||||||
|
### 1.2 Alcance
|
||||||
|
|
||||||
|
El proyecto proporciona:
|
||||||
|
- 6 modos especializados para diferentes roles de contenido educativo
|
||||||
|
- 30 habilidades que apoyan esos modos (5 por modo)
|
||||||
|
- 42 archivos de instrucción XML que definen patrones de comportamiento (7 por modo)
|
||||||
|
- Archivos de configuración para registro de modos
|
||||||
|
- Documentación completa
|
||||||
|
|
||||||
|
### 1.3 Definiciones y Acrónimos
|
||||||
|
|
||||||
|
| Término | Definición |
|
||||||
|
|---------|------------|
|
||||||
|
| Modo | Una configuración especializada de Roo Code para un rol específico |
|
||||||
|
| Habilidad | Una capacidad reutilizable que puede ser invocada por modos |
|
||||||
|
| LMS | Sistema de Gestión de Aprendizaje (Learning Management System) |
|
||||||
|
| SCORM | Modelo de Referencia de Objeto de Contenido Compartible |
|
||||||
|
| xAPI | API de Experiencia (Tin Can API) |
|
||||||
|
| WCAG | Pautas de Accesibilidad para el Contenido Web |
|
||||||
|
| Taxonomía de Bloom | Clasificación de objetivos de aprendizaje por nivel cognitivo |
|
||||||
|
|
||||||
|
### 1.4 Referencias
|
||||||
|
|
||||||
|
- Documentación de Roo Code Mode Writer
|
||||||
|
- Pautas WCAG 2.1/2.2
|
||||||
|
- Especificación SCORM 2004
|
||||||
|
- Marco de la Taxonomía de Bloom
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Descripción General
|
||||||
|
|
||||||
|
### 2.1 Perspectiva del Producto
|
||||||
|
|
||||||
|
El proyecto Contenido de Innovación extiende las capacidades de Roo Code proporcionando modos y habilidades específicos del dominio adaptados al desarrollo de contenido educativo. Cada modo opera como un agente especializado con permisos, comportamientos y flujos de trabajo definidos.
|
||||||
|
|
||||||
|
### 2.2 Funciones del Producto
|
||||||
|
|
||||||
|
1. **Diseño Curricular:** Crear y validar currículos educativos
|
||||||
|
2. **Escritura Instruccional:** Producir contenido de lecciones atractivo
|
||||||
|
3. **Desarrollo de Evaluaciones:** Diseñar evaluaciones válidas y confiables
|
||||||
|
4. **Producción de Contenido:** Crear materiales educativos multimedia
|
||||||
|
5. **Diseño de Experiencia de Aprendizaje:** Diseñar journeys de aprendizaje atractentes
|
||||||
|
6. **Auditoría de Accesibilidad:** Asegurar que el contenido cumpla con estándares de accesibilidad
|
||||||
|
|
||||||
|
### 2.3 Características del Usuario
|
||||||
|
|
||||||
|
| Rol del Usuario | Experiencia | Modos Principales |
|
||||||
|
|-----------------|-------------|-------------------|
|
||||||
|
| Diseñador Curricular | Diseño educativo, alineación de estándares | curriculum-designer |
|
||||||
|
| Escritor Instruccional | Escritura, pedagogía | instructional-writer |
|
||||||
|
| Desarrollador de Evaluaciones | Psicometría, medición | assessment-dev |
|
||||||
|
| Productor de Contenido | Producción multimedia | content-producer |
|
||||||
|
| Diseñador LX | Diseño UX, engagement | lx-designer |
|
||||||
|
| Especialista en Accesibilidad | WCAG, tecnología asistiva | accessibility-auditor |
|
||||||
|
|
||||||
|
### 2.4 Restricciones
|
||||||
|
|
||||||
|
- Los modos deben operar dentro de los permisos de archivo definidos
|
||||||
|
- Las habilidades deben ser autocontenidas y documentadas
|
||||||
|
- Todo el contenido debe cumplir con los estándares educativos
|
||||||
|
- La accesibilidad es obligatoria, no opcional
|
||||||
|
|
||||||
|
### 2.5 Suposiciones
|
||||||
|
|
||||||
|
- Los usuarios tienen familiaridad básica con Roo Code
|
||||||
|
- El contenido educativo sigue los estándares organizacionales
|
||||||
|
- Las plataformas objetivo admiten contenido SCORM/xAPI
|
||||||
|
- Los requisitos de accesibilidad son conocidos y documentados
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Requisitos Específicos
|
||||||
|
|
||||||
|
### 3.1 Requisitos de Modos
|
||||||
|
|
||||||
|
#### 3.1.1 Modo Diseñador Curricular
|
||||||
|
|
||||||
|
**ID:** MODE-001
|
||||||
|
**Prioridad:** Crítica
|
||||||
|
|
||||||
|
**Requisitos Funcionales:**
|
||||||
|
- FR-001: Debe validar objetivos de aprendizaje contra la Taxonomía de Bloom
|
||||||
|
- FR-002: Debe mapear objetivos a marcos de competencia
|
||||||
|
- FR-003: Debe identificar brechas en la cobertura del currículo
|
||||||
|
- FR-004: Debe verificar la alineación con estándares educativos
|
||||||
|
- FR-005: Debe analizar y validar cadenas de prerrequisitos
|
||||||
|
|
||||||
|
**Requisitos No Funcionales:**
|
||||||
|
- NFR-001: Debe procesar documentos curriculares en menos de 30 segundos
|
||||||
|
- NFR-002: Debe soportar Common Core, NGSS y estándares personalizados
|
||||||
|
|
||||||
|
**Permisos:**
|
||||||
|
- Lectura: Repositorio completo
|
||||||
|
- Edición: `curriculum/`, `docs/learning-objectives/`, `*.curriculum.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### 3.1.2 Modo Escritor Instruccional
|
||||||
|
|
||||||
|
**ID:** MODE-002
|
||||||
|
**Prioridad:** Crítica
|
||||||
|
|
||||||
|
**Requisitos Funcionales:**
|
||||||
|
- FR-006: Debe analizar la legibilidad del contenido
|
||||||
|
- FR-007: Debe asegurar la consistencia del tono en documentos
|
||||||
|
- FR-008: Debe diseñar ejercicios de aprendizaje activo
|
||||||
|
- FR-009: Debe evaluar la calidad de las explicaciones
|
||||||
|
- FR-010: Debe generar preguntas de evaluación formativa
|
||||||
|
|
||||||
|
**Requisitos No Funcionales:**
|
||||||
|
- NFR-003: Debe soportar múltiples métricas de legibilidad (Flesch-Kincaid, SMOG)
|
||||||
|
- NFR-004: Debe mantener el cumplimiento de la guía de estilo
|
||||||
|
|
||||||
|
**Permisos:**
|
||||||
|
- Lectura: Repositorio completo
|
||||||
|
- Edición: `lessons/`, `exercises/`, `docs/learner/`, `*.lesson.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### 3.1.3 Modo Desarrollador de Evaluaciones
|
||||||
|
|
||||||
|
**ID:** MODE-003
|
||||||
|
**Prioridad:** Alta
|
||||||
|
|
||||||
|
**Requisitos Funcionales:**
|
||||||
|
- FR-011: Debe validar la alineación de evaluaciones a objetivos
|
||||||
|
- FR-012: Debe realizar análisis de ítems (dificultad, discriminación)
|
||||||
|
- FR-013: Debe generar rúbricas con descriptores de desempeño
|
||||||
|
- FR-014: Debe detectar sesgo en ítems de evaluación
|
||||||
|
- FR-015: Debe diseñar lógica de evaluación adaptativa
|
||||||
|
|
||||||
|
**Requisitos No Funcionales:**
|
||||||
|
- NFR-005: Debe soportar múltiples tipos de evaluación (opción múltiple, ensayo, desempeño)
|
||||||
|
- NFR-006: Debe calcular índices estadísticos con precisión
|
||||||
|
|
||||||
|
**Permisos:**
|
||||||
|
- Lectura: Repositorio completo
|
||||||
|
- Edición: `assessments/`, `quizzes/`, `rubrics/`, `*.assessment.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### 3.1.4 Modo Productor de Contenido
|
||||||
|
|
||||||
|
**ID:** MODE-004
|
||||||
|
**Prioridad:** Alta
|
||||||
|
|
||||||
|
**Requisitos Funcionales:**
|
||||||
|
- FR-016: Debe validar storyboards contra objetivos
|
||||||
|
- FR-017: Debe gestionar activos de medios con metadatos
|
||||||
|
- FR-018: Debe empaquetar contenido para SCORM/xAPI
|
||||||
|
- FR-019: Debe validar la calidad de subtítulos y transcripciones
|
||||||
|
- FR-020: Debe crear contenido interactivo (H5P)
|
||||||
|
|
||||||
|
**Requisitos No Funcionales:**
|
||||||
|
- NFR-007: Debe producir paquetes compatibles con SCORM 1.2 y 2004
|
||||||
|
- NFR-008: Debe soportar formatos de medios comunes (MP4, WebM, PNG, SVG)
|
||||||
|
|
||||||
|
**Permisos:**
|
||||||
|
- Lectura: Repositorio completo
|
||||||
|
- Edición: `content/`, `media/`, `scripts/`, `*.storyboard.md`
|
||||||
|
- Navegador: Vista previa y prueba
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### 3.1.5 Modo Diseñador de Experiencia de Aprendizaje
|
||||||
|
|
||||||
|
**ID:** MODE-005
|
||||||
|
**Prioridad:** Media
|
||||||
|
|
||||||
|
**Requisitos Funcionales:**
|
||||||
|
- FR-021: Debe mapear journeys de aprendizaje
|
||||||
|
- FR-022: Debe analizar patrones de engagement
|
||||||
|
- FR-023: Debe diseñar elementos de gamificación
|
||||||
|
- FR-024: Debe arquitecturar estructuras de microaprendizaje
|
||||||
|
- FR-025: Debe generar especificaciones de UI
|
||||||
|
|
||||||
|
**Requisitos No Funcionales:**
|
||||||
|
- NFR-009: Debe soportar visualización de journeys
|
||||||
|
- NFR-010: Debe alinear la gamificación a objetivos de aprendizaje
|
||||||
|
|
||||||
|
**Permisos:**
|
||||||
|
- Lectura: Repositorio completo
|
||||||
|
- Edición: `design/`, `ux/`, `*.journey.md`, `*.spec.md`
|
||||||
|
- Navegador: Prototipo y prueba
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
#### 3.1.6 Modo Auditor de Accesibilidad
|
||||||
|
|
||||||
|
**ID:** MODE-006
|
||||||
|
**Prioridad:** Alta
|
||||||
|
|
||||||
|
**Requisitos Funcionales:**
|
||||||
|
- FR-026: Debe auditar el cumplimiento de WCAG 2.1/2.2
|
||||||
|
- FR-027: Debe simular la experiencia de lector de pantalla
|
||||||
|
- FR-028: Debe analizar ratios de contraste de color
|
||||||
|
- FR-029: Debe evaluar accesibilidad cognitiva
|
||||||
|
- FR-030: Debe proporcionar guía de remediación
|
||||||
|
|
||||||
|
**Requisitos No Funcionales:**
|
||||||
|
- NFR-011: Debe verificar todos los criterios de éxito WCAG en niveles A, AA, AAA
|
||||||
|
- NFR-012: Debe priorizar problemas por severidad
|
||||||
|
|
||||||
|
**Permisos:**
|
||||||
|
- Lectura: Repositorio completo
|
||||||
|
- Edición: `docs/accessibility/`, `*.audit.md`, `a11y-reports/`
|
||||||
|
- Navegador: Simulación de lector de pantalla
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 3.2 Requisitos de Habilidades
|
||||||
|
|
||||||
|
#### 3.2.1 Arquitectura de Habilidades
|
||||||
|
|
||||||
|
Cada habilidad debe:
|
||||||
|
- Tener un identificador único (slug)
|
||||||
|
- Incluir un archivo SKILL.md con descripción y capacidades
|
||||||
|
- Ser invocable por uno o más modos
|
||||||
|
- Devolver resultados estructurados
|
||||||
|
- Documentar limitaciones y suposiciones
|
||||||
|
|
||||||
|
#### 3.2.2 Inventario de Habilidades
|
||||||
|
|
||||||
|
| ID de Habilidad | Nombre | Modo Principal | Prioridad |
|
||||||
|
|-----------------|--------|----------------|-----------|
|
||||||
|
| SKILL-001 | learning-objective-validator | curriculum-designer | Crítica |
|
||||||
|
| SKILL-002 | competency-mapper | curriculum-designer | Alta |
|
||||||
|
| SKILL-003 | curriculum-gap-analyzer | curriculum-designer | Alta |
|
||||||
|
| SKILL-004 | standards-compliance-checker | curriculum-designer | Media |
|
||||||
|
| SKILL-005 | prerequisite-analyzer | curriculum-designer | Media |
|
||||||
|
| SKILL-006 | readability-analyzer | instructional-writer | Crítica |
|
||||||
|
| SKILL-007 | tone-consistency-checker | instructional-writer | Alta |
|
||||||
|
| SKILL-008 | active-learning-designer | instructional-writer | Alta |
|
||||||
|
| SKILL-009 | explanation-quality-checker | instructional-writer | Media |
|
||||||
|
| SKILL-010 | formative-assessment-writer | instructional-writer | Media |
|
||||||
|
| SKILL-011 | assessment-validator | assessment-dev | Crítica |
|
||||||
|
| SKILL-012 | item-analysis-tool | assessment-dev | Alta |
|
||||||
|
| SKILL-013 | rubric-generator | assessment-dev | Alta |
|
||||||
|
| SKILL-014 | bias-detector | assessment-dev | Media |
|
||||||
|
| SKILL-015 | adaptive-logic-designer | assessment-dev | Media |
|
||||||
|
| SKILL-016 | storyboard-validator | content-producer | Crítica |
|
||||||
|
| SKILL-017 | media-asset-manager | content-producer | Alta |
|
||||||
|
| SKILL-018 | scorm-packager | content-producer | Alta |
|
||||||
|
| SKILL-019 | caption-quality-checker | content-producer | Media |
|
||||||
|
| SKILL-020 | interactive-content-builder | content-producer | Media |
|
||||||
|
| SKILL-021 | journey-mapper | lx-designer | Crítica |
|
||||||
|
| SKILL-022 | engagement-analyzer | lx-designer | Alta |
|
||||||
|
| SKILL-023 | gamification-designer | lx-designer | Alta |
|
||||||
|
| SKILL-024 | microlearning-architect | lx-designer | Media |
|
||||||
|
| SKILL-025 | ui-spec-generator | lx-designer | Media |
|
||||||
|
| SKILL-026 | wcag-compliance-checker | accessibility-auditor | Crítica |
|
||||||
|
| SKILL-027 | screen-reader-simulator | accessibility-auditor | Alta |
|
||||||
|
| SKILL-028 | color-contrast-analyzer | accessibility-auditor | Alta |
|
||||||
|
| SKILL-029 | cognitive-accessibility-checker | accessibility-auditor | Media |
|
||||||
|
| SKILL-030 | remediation-advisor | accessibility-auditor | Media |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 3.3 Requisitos de Interfaz
|
||||||
|
|
||||||
|
#### 3.3.1 Interfaz de Configuración de Modos
|
||||||
|
|
||||||
|
Cada configuración de modo debe incluir:
|
||||||
|
- `name`: Nombre para mostrar
|
||||||
|
- `slug`: Identificador único
|
||||||
|
- `roleDefinition`: Descripción detallada del rol
|
||||||
|
- `whenToUse`: Guía de uso
|
||||||
|
- `permissions`: Restricciones de archivos y comandos
|
||||||
|
- `customInstructions`: Reglas de comportamiento específicas del modo
|
||||||
|
|
||||||
|
#### 3.3.2 Interfaz de Habilidades
|
||||||
|
|
||||||
|
Cada habilidad debe incluir:
|
||||||
|
- `name`: Nombre para mostrar
|
||||||
|
- `description`: Descripción de capacidad
|
||||||
|
- `capabilities`: Lista de capacidades específicas
|
||||||
|
- `usage`: Cuándo y cómo usar la habilidad
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 3.4 Requisitos de Integración
|
||||||
|
|
||||||
|
#### 3.4.1 Transferencias entre Modos
|
||||||
|
|
||||||
|
| De Modo | A Modo | Contenido de Transferencia |
|
||||||
|
|---------|--------|---------------------------|
|
||||||
|
| curriculum-designer | instructional-writer | Objetivos de aprendizaje, estructura del curso |
|
||||||
|
| instructional-writer | content-producer | Guiones, esquemas de contenido |
|
||||||
|
| lx-designer | content-producer | Especificaciones de elementos interactivos |
|
||||||
|
| assessment-dev | todos los modos | Requisitos de evaluación |
|
||||||
|
| todos los modos | accessibility-auditor | Contenido listo para revisión |
|
||||||
|
|
||||||
|
#### 3.4.2 Compartición de Habilidades
|
||||||
|
|
||||||
|
Las habilidades pueden compartirse entre modos donde las capacidades se superponen:
|
||||||
|
- `readability-analyzer` puede ser usado por content-producer
|
||||||
|
- `assessment-validator` puede ser usado por instructional-writer
|
||||||
|
- `wcag-compliance-checker` puede ser usado por content-producer
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Requisitos No Funcionales
|
||||||
|
|
||||||
|
### 4.1 Rendimiento
|
||||||
|
|
||||||
|
- NFR-013: El cambio de modo debe completarse en menos de 5 segundos
|
||||||
|
- NFR-014: La invocación de habilidades debe completarse en menos de 30 segundos
|
||||||
|
- NFR-015: Las operaciones de archivo deben respetar los límites de permisos
|
||||||
|
|
||||||
|
### 4.2 Confiabilidad
|
||||||
|
|
||||||
|
- NFR-016: Los modos no deben fallar con entrada inválida
|
||||||
|
- NFR-017: Las habilidades deben devolver mensajes de error estructurados
|
||||||
|
- NFR-018: Los errores de configuración deben reportarse claramente
|
||||||
|
|
||||||
|
### 4.3 Seguridad
|
||||||
|
|
||||||
|
- NFR-019: Los permisos de archivo deben ser aplicados
|
||||||
|
- NFR-020: Los modos no deben acceder a archivos fuera de su alcance
|
||||||
|
- NFR-021: Las habilidades no deben ejecutar comandos arbitrarios
|
||||||
|
|
||||||
|
### 4.4 Mantenibilidad
|
||||||
|
|
||||||
|
- NFR-022: Todas las configuraciones deben estar bajo control de versiones
|
||||||
|
- NFR-023: Todas las habilidades deben estar documentadas
|
||||||
|
- NFR-024: Los cambios deben rastrearse en CHANGELOG.md
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Criterios de Aceptación
|
||||||
|
|
||||||
|
### 5.1 Aceptación de Modos
|
||||||
|
|
||||||
|
- [x] Los 6 modos están configurados correctamente
|
||||||
|
- [x] Todos los archivos de instrucción XML están bien formados
|
||||||
|
- [x] Los permisos de archivo se aplican
|
||||||
|
- [ ] Las transferencias entre modos funcionan como se especifica
|
||||||
|
- [x] La documentación está completa y es precisa
|
||||||
|
|
||||||
|
### 5.2 Aceptación de Habilidades
|
||||||
|
|
||||||
|
- [x] Las 30 habilidades están documentadas
|
||||||
|
- [x] Las habilidades devuelven resultados estructurados
|
||||||
|
- [x] Las habilidades manejan errores elegantemente
|
||||||
|
- [x] Las habilidades se integran con modos padre
|
||||||
|
- [ ] Las habilidades compartidas funcionan entre modos
|
||||||
|
|
||||||
|
### 5.3 Aceptación de Integración
|
||||||
|
|
||||||
|
- [ ] Los flujos de trabajo de extremo a extremo se completan exitosamente
|
||||||
|
- [ ] No ocurren conflictos de permisos
|
||||||
|
- [ ] Todos los escenarios de prueba pasan
|
||||||
|
- [ ] Se cumplen los requisitos de rendimiento
|
||||||
|
- [ ] Se cumplen los requisitos de seguridad
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Apéndices
|
||||||
|
|
||||||
|
### 6.1 Referencia de la Taxonomía de Bloom
|
||||||
|
|
||||||
|
| Nivel | Verbos | Descripción |
|
||||||
|
|-------|--------|-------------|
|
||||||
|
| Recordar | listar, definir, identificar, recordar | Recordar hechos y conceptos básicos |
|
||||||
|
| Comprender | explicar, describir, resumir, interpretar | Explicar ideas o conceptos |
|
||||||
|
| Aplicar | usar, resolver, demostrar, implementar | Usar información en nuevas situaciones |
|
||||||
|
| Analizar | comparar, contrastar, diferenciar, examinar | Establecer conexiones entre ideas |
|
||||||
|
| Evaluar | juzgar, criticar, justificar, defender | Justificar una posición o decisión |
|
||||||
|
| Crear | diseñar, construir, producir, desarrollar | Producir trabajo nuevo u original |
|
||||||
|
|
||||||
|
### 6.2 Principios WCAG 2.1
|
||||||
|
|
||||||
|
1. **Perceptible:** La información debe presentarse de formas que los usuarios puedan percibir
|
||||||
|
2. **Operable:** Los componentes de la interfaz deben ser operables por todos los usuarios
|
||||||
|
3. **Comprensible:** La información y operación de la UI deben ser comprensibles
|
||||||
|
4. **Robusto:** El contenido debe ser lo suficientemente robusto para varias tecnologías asistivas
|
||||||
|
|
||||||
|
### 6.3 Versiones SCORM
|
||||||
|
|
||||||
|
| Versión | Año | Características Clave |
|
||||||
|
|---------|-----|----------------------|
|
||||||
|
| SCORM 1.2 | 2001 | Secuenciación básica, modelo de datos simple |
|
||||||
|
| SCORM 2004 | 2004 | Secuenciación avanzada, estado compartido |
|
||||||
|
|
||||||
|
### 6.4 Estado de Implementación
|
||||||
|
|
||||||
|
**Al 2026-04-24:**
|
||||||
|
|
||||||
|
| Componente | Requerido | Implementado | Estado |
|
||||||
|
|------------|-----------|--------------|--------|
|
||||||
|
| Modos | 6 | 6 | ✅ Completo |
|
||||||
|
| Archivos de Configuración de Modos | 6 | 6 | ✅ Completo |
|
||||||
|
| Archivos de Reglas XML | 42 | 42 | ✅ Completo |
|
||||||
|
| Habilidades | 30 | 30 | ✅ Completo |
|
||||||
|
| Archivos SKILL.md | 30 | 30 | ✅ Completo |
|
||||||
|
| Documentación | 8 | 8 | ✅ Completo |
|
||||||
|
|
||||||
|
**Total de Archivos Creados: 125**
|
||||||
|
|
||||||
|
### 6.5 Inventario de Archivos
|
||||||
|
|
||||||
|
#### Documentación Raíz
|
||||||
|
- `README.md` - Resumen del proyecto y guía de inicio rápido
|
||||||
|
- `CHANGELOG.md` - Historial de versiones con registro detallado de cambios
|
||||||
|
- `AGENTS.md` - Configuración de agentes y directrices de comportamiento
|
||||||
|
|
||||||
|
#### Documentación (docs/)
|
||||||
|
- `plan.md` - Plan de desarrollo con 4 fases e hitos
|
||||||
|
- `srs.md` - Especificación de Requisitos de Software
|
||||||
|
- `support-team-guide.md` - Guía de instalación, solución de problemas y extensión para equipos de soporte
|
||||||
|
- `user-guide.md` - Guía del usuario con introducción conceptual, consejos de uso de modos y optimización de flujo de trabajo
|
||||||
|
- `plan-ES.md` - Versión en español del plan de desarrollo
|
||||||
|
- `srs-ES.md` - Versión en español de la especificación de requisitos
|
||||||
|
- `support-team-guide-ES.md` - Versión en español de la guía del equipo de soporte
|
||||||
|
- `user-guide-ES.md` - Versión en español de la guía del usuario
|
||||||
|
|
||||||
|
#### Modos (modes/)
|
||||||
|
Cada modo contiene:
|
||||||
|
- `mode-config.yaml` - Configuración del modo con permisos
|
||||||
|
- `rules/1_workflow.xml` - Definición del flujo de trabajo principal
|
||||||
|
- `rules/2_best_practices.xml` - Mejores prácticas y directrices
|
||||||
|
- `rules/3_common_patterns.xml` - Patrones de diseño comunes
|
||||||
|
- `rules/4_decision_guidance.xml` - Directrices para la toma de decisiones
|
||||||
|
- `rules/5_examples.xml` - Ejemplos resueltos
|
||||||
|
- `rules/6_error_handling.xml` - Procedimientos de manejo de errores
|
||||||
|
- `rules/7_communication.xml` - Protocolos de comunicación y transferencia
|
||||||
|
|
||||||
|
#### Habilidades (skills/)
|
||||||
|
Cada habilidad contiene:
|
||||||
|
- `SKILL.md` - Documentación de habilidad con frontmatter YAML que incluye:
|
||||||
|
- `name` - Identificador de habilidad
|
||||||
|
- `description` - Descripción de capacidad
|
||||||
|
- Sección de capacidades
|
||||||
|
- Directrices de uso
|
||||||
|
- Especificaciones de entrada/salida
|
||||||
|
- Limitaciones y suposiciones
|
||||||
10
docs/srs.md
10
docs/srs.md
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
## Innovation Content: Educational Content Development Modes & Skills
|
## Innovation Content: Educational Content Development Modes & Skills
|
||||||
|
|
||||||
**Version:** 1.1.0
|
**Version:** 1.1.1
|
||||||
**Date:** 2026-04-24
|
**Date:** 2026-04-24
|
||||||
**Status:** Final
|
**Status:** Final
|
||||||
|
|
||||||
@@ -410,9 +410,9 @@ Skills may be shared between modes where capabilities overlap:
|
|||||||
| XML Rule Files | 42 | 42 | ✅ Complete |
|
| XML Rule Files | 42 | 42 | ✅ Complete |
|
||||||
| Skills | 30 | 30 | ✅ Complete |
|
| Skills | 30 | 30 | ✅ Complete |
|
||||||
| SKILL.md Files | 30 | 30 | ✅ Complete |
|
| SKILL.md Files | 30 | 30 | ✅ Complete |
|
||||||
| Documentation | 7 | 7 | ✅ Complete |
|
| Documentation | 11 | 11 | ✅ Complete |
|
||||||
|
|
||||||
**Total Files Created: 121**
|
**Total Files Created: 125**
|
||||||
|
|
||||||
### 6.5 File Inventory
|
### 6.5 File Inventory
|
||||||
|
|
||||||
@@ -426,6 +426,10 @@ Skills may be shared between modes where capabilities overlap:
|
|||||||
- `srs.md` - Software Requirements Specification
|
- `srs.md` - Software Requirements Specification
|
||||||
- `support-team-guide.md` - Installation, troubleshooting, and extension guide for support teams
|
- `support-team-guide.md` - Installation, troubleshooting, and extension guide for support teams
|
||||||
- `user-guide.md` - User guide with conceptual intro, mode usage tips, and workflow optimization
|
- `user-guide.md` - User guide with conceptual intro, mode usage tips, and workflow optimization
|
||||||
|
- `plan-ES.md` - Spanish version of development plan
|
||||||
|
- `srs-ES.md` - Spanish version of SRS
|
||||||
|
- `support-team-guide-ES.md` - Spanish version of support team guide
|
||||||
|
- `user-guide-ES.md` - Spanish version of user guide
|
||||||
|
|
||||||
#### Modes (modes/)
|
#### Modes (modes/)
|
||||||
Each mode contains:
|
Each mode contains:
|
||||||
|
|||||||
579
docs/support-team-guide-ES.md
Normal file
579
docs/support-team-guide-ES.md
Normal file
@@ -0,0 +1,579 @@
|
|||||||
|
# Guía del Equipo de Soporte
|
||||||
|
|
||||||
|
## Contenido de Innovación: Modos y Habilidades de Desarrollo de Contenido Educativo
|
||||||
|
|
||||||
|
**Versión:** 1.1.1
|
||||||
|
**Audiencia:** Equipo de Soporte, Administradores de Sistemas, Líderes Técnicos
|
||||||
|
**Fecha:** 2026-04-24
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Introducción
|
||||||
|
|
||||||
|
Esta guía proporciona al equipo de soporte instrucciones precisas para instalar, configurar, solucionar problemas y extender los modos y habilidades de Contenido de Innovación para Roo Code.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Prerrequisitos
|
||||||
|
|
||||||
|
### 2.1 Requisitos del Sistema
|
||||||
|
|
||||||
|
| Componente | Requisito |
|
||||||
|
|------------|-----------|
|
||||||
|
| Roo Code | Versión 3.8 o posterior |
|
||||||
|
| Node.js | Versión 18.x o posterior (para scripts de validación) |
|
||||||
|
| Git | Versión 2.30 o posterior |
|
||||||
|
| Sistema Operativo | Windows 10/11, macOS 12+, Linux (Ubuntu 20.04+) |
|
||||||
|
|
||||||
|
### 2.2 Permisos Requeridos
|
||||||
|
|
||||||
|
- Acceso de lectura/escritura al espacio de trabajo del proyecto
|
||||||
|
- Capacidad para modificar el archivo de configuración `.roomodes`
|
||||||
|
- Acceso al directorio `.agents/skills/`
|
||||||
|
- Acceso al navegador (para modos Content Producer y LX Designer)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Instalación
|
||||||
|
|
||||||
|
### 3.1 Clonar Repositorio
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://archi.pinion.education/PinionEducation/pinion-modes-skills.git innovation-content
|
||||||
|
cd innovation-content
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 Instalar Modos
|
||||||
|
|
||||||
|
**Opción A: Instalación Manual**
|
||||||
|
|
||||||
|
Copie cada configuración de modo a su archivo `.roomodes` de Roo Code:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# En Windows (cmd.exe)
|
||||||
|
copy innovation-content\modes\curriculum-designer\mode-config.yaml %USERPROFILE%\.roo\modes\
|
||||||
|
copy innovation-content\modes\instructional-writer\mode-config.yaml %USERPROFILE%\.roo\modes\
|
||||||
|
copy innovation-content\modes\assessment-dev\mode-config.yaml %USERPROFILE%\.roo\modes\
|
||||||
|
copy innovation-content\modes\content-producer\mode-config.yaml %USERPROFILE%\.roo\modes\
|
||||||
|
copy innovation-content\modes\lx-designer\mode-config.yaml %USERPROFILE%\.roo\modes\
|
||||||
|
copy innovation-content\modes\accessibility-auditor\mode-config.yaml %USERPROFILE%\.roo\modes\
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# En macOS/Linux
|
||||||
|
cp innovation-content/modes/*/mode-config.yaml ~/.roo/modes/
|
||||||
|
```
|
||||||
|
|
||||||
|
**Opción B: Instalación Automatizada**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Ejecutar el script de instalación (si está disponible)
|
||||||
|
./scripts/install-modes.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.3 Instalar Reglas
|
||||||
|
|
||||||
|
Copie los archivos de reglas XML al directorio de reglas apropiado para cada modo:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# En Windows (cmd.exe)
|
||||||
|
for %m in (curriculum-designer instructional-writer assessment-dev content-producer lx-designer accessibility-auditor) do (
|
||||||
|
xcopy /E /I innovation-content\modes\%m\rules %USERPROFILE%\.roo\rules-%m\
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# En macOS/Linux
|
||||||
|
for mode in curriculum-designer instructional-writer assessment-dev content-producer lx-designer accessibility-auditor; do
|
||||||
|
mkdir -p ~/.roo/rules-$mode
|
||||||
|
cp innovation-content/modes/$mode/rules/*.xml ~/.roo/rules-$mode/
|
||||||
|
done
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.4 Instalar Habilidades
|
||||||
|
|
||||||
|
Copie todos los directorios de habilidades a su carpeta de habilidades:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# En Windows (cmd.exe)
|
||||||
|
xcopy /E /I innovation-content\skills %USERPROFILE%\.agents\skills\
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# En macOS/Linux
|
||||||
|
cp -r innovation-content/skills/* ~/.agents/skills/
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.5 Verificar Instalación
|
||||||
|
|
||||||
|
1. Abra Roo Code
|
||||||
|
2. Cambie a cada modo y verifique que cargue sin errores:
|
||||||
|
- `curriculum-designer`
|
||||||
|
- `instructional-writer`
|
||||||
|
- `assessment-dev`
|
||||||
|
- `content-producer`
|
||||||
|
- `lx-designer`
|
||||||
|
- `accessibility-auditor`
|
||||||
|
3. Pruebe la invocación de una habilidad en cada modo
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Configuración
|
||||||
|
|
||||||
|
### 4.1 Estructura de Configuración de Modos
|
||||||
|
|
||||||
|
Cada archivo de configuración de modo (`mode-config.yaml`) sigue esta estructura:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
name: "Nombre para Mostrar del Modo"
|
||||||
|
slug: "slug-del-modo"
|
||||||
|
roleDefinition: "Descripción detallada de lo que hace este modo"
|
||||||
|
whenToUse: "Guía sobre cuándo activar este modo"
|
||||||
|
permissions:
|
||||||
|
fileRestrictions:
|
||||||
|
- "patrones/*.md"
|
||||||
|
- "directorio/**/*"
|
||||||
|
allowedCommands:
|
||||||
|
- "nombre-del-comando"
|
||||||
|
browserAccess: true/false
|
||||||
|
customInstructions: |
|
||||||
|
Instrucciones adicionales para el comportamiento del modo
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 Estructura de Configuración de Habilidades
|
||||||
|
|
||||||
|
Cada archivo de habilidad (`SKILL.md`) sigue esta estructura:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
name: nombre-habilidad
|
||||||
|
description: Breve descripción de la habilidad
|
||||||
|
---
|
||||||
|
|
||||||
|
# Nombre de la Habilidad
|
||||||
|
|
||||||
|
## Capacidades
|
||||||
|
- Capacidad 1
|
||||||
|
- Capacidad 2
|
||||||
|
|
||||||
|
## Uso
|
||||||
|
Cuándo y cómo usar esta habilidad
|
||||||
|
|
||||||
|
## Entrada
|
||||||
|
Formato de entrada esperado
|
||||||
|
|
||||||
|
## Salida
|
||||||
|
Formato de salida esperado
|
||||||
|
|
||||||
|
## Limitaciones
|
||||||
|
Limitaciones conocidas
|
||||||
|
|
||||||
|
## Suposiciones
|
||||||
|
Suposiciones hechas por esta habilidad
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.3 Personalizar Permisos
|
||||||
|
|
||||||
|
Para modificar los permisos de archivo de un modo, edite el archivo `mode-config.yaml`:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
permissions:
|
||||||
|
fileRestrictions:
|
||||||
|
- "directorio-personalizado/**/*"
|
||||||
|
- "*.extension-personalizada"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Solución de Problemas
|
||||||
|
|
||||||
|
### 5.1 Problemas Comunes
|
||||||
|
|
||||||
|
| Problema | Causa | Resolución |
|
||||||
|
|----------|-------|------------|
|
||||||
|
| El modo no aparece en Roo Code | Configuración no copiada | Verifique que el archivo `.roomodes` contiene la entrada del modo |
|
||||||
|
| Habilidad no encontrada | Habilidad no en directorio correcto | Verifique que `~/.agents/skills/nombre-habilidad/SKILL.md` existe |
|
||||||
|
| Permiso denegado | Restricción de archivo muy estrecha | Actualice `fileRestrictions` en mode-config.yaml |
|
||||||
|
| Error de análisis XML | XML mal formado | Valide XML con `xmllint` o validador en línea |
|
||||||
|
| Error de análisis YAML | Sintaxis YAML inválida | Valide YAML con `yamllint` o validador en línea |
|
||||||
|
|
||||||
|
### 5.2 Comandos de Diagnóstico
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Validar todos los archivos YAML
|
||||||
|
find . -name "*.yaml" -exec yamllint {} \;
|
||||||
|
|
||||||
|
# Validar todos los archivos XML
|
||||||
|
find . -name "*.xml" -exec xmllint --noout {} \;
|
||||||
|
|
||||||
|
# Verificar que existen archivos de habilidades
|
||||||
|
for skill in $(ls skills/); do
|
||||||
|
test -f "skills/$skill/SKILL.md" && echo "$skill: OK" || echo "$skill: FALTA"
|
||||||
|
done
|
||||||
|
|
||||||
|
# Verificar que existen reglas de modos
|
||||||
|
for mode in $(ls modes/); do
|
||||||
|
count=$(ls "modes/$mode/rules/"*.xml 2>/dev/null | wc -l)
|
||||||
|
echo "$mode: $count reglas"
|
||||||
|
done
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.3 Ubicaciones de Registros
|
||||||
|
|
||||||
|
| Tipo de Registro | Ubicación |
|
||||||
|
|------------------|-----------|
|
||||||
|
| Registros de Roo Code | `~/.roo/logs/` |
|
||||||
|
| Registros de activación de modos | Salida de consola al cambiar modos |
|
||||||
|
| Registros de invocación de habilidades | Salida de consola al usar habilidades |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Extender Modos y Habilidades
|
||||||
|
|
||||||
|
### 6.1 Agregar un Nuevo Modo
|
||||||
|
|
||||||
|
**Paso 1: Crear Directorio del Modo**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mkdir -p modes/nuevo-modo/rules
|
||||||
|
```
|
||||||
|
|
||||||
|
**Paso 2: Crear Configuración del Modo**
|
||||||
|
|
||||||
|
Cree `modes/nuevo-modo/mode-config.yaml`:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
name: "Nombre del Nuevo Modo"
|
||||||
|
slug: "nuevo-modo"
|
||||||
|
roleDefinition: "Describir lo que hace este modo"
|
||||||
|
whenToUse: "Describir cuándo usar este modo"
|
||||||
|
permissions:
|
||||||
|
fileRestrictions:
|
||||||
|
- "directorio-nuevo-modo/**/*"
|
||||||
|
allowedCommands:
|
||||||
|
- "comando-relevante"
|
||||||
|
customInstructions: |
|
||||||
|
Instrucciones adicionales
|
||||||
|
```
|
||||||
|
|
||||||
|
**Paso 3: Crear Archivos de Reglas XML**
|
||||||
|
|
||||||
|
Cree los 7 archivos de reglas XML requeridos:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Use esta secuencia de prompts para generar cada archivo de reglas:
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prompt para 1_workflow.xml:**
|
||||||
|
```
|
||||||
|
Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '1_workflow.xml'.
|
||||||
|
Define el flujo de trabajo principal con estas etapas:
|
||||||
|
1. Recibir entrada
|
||||||
|
2. Procesar entrada
|
||||||
|
3. Validar salida
|
||||||
|
4. Entregar resultado
|
||||||
|
|
||||||
|
Usa este formato:
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<rule name="workflow" mode="nuevo-modo">
|
||||||
|
<workflow>
|
||||||
|
<stage name="Recibir Entrada">...</stage>
|
||||||
|
<stage name="Procesar Entrada">...</stage>
|
||||||
|
<stage name="Validar Salida">...</stage>
|
||||||
|
<stage name="Entregar Resultado">...</stage>
|
||||||
|
</workflow>
|
||||||
|
</rule>
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prompt para 2_best_practices.xml:**
|
||||||
|
```
|
||||||
|
Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '2_best_practices.xml'.
|
||||||
|
Define 5 mejores prácticas para este modo con descripciones y ejemplos.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prompt para 3_common_patterns.xml:**
|
||||||
|
```
|
||||||
|
Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '3_common_patterns.xml'.
|
||||||
|
Define 3-5 patrones de diseño comunes usados en este modo.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prompt para 4_decision_guidance.xml:**
|
||||||
|
```
|
||||||
|
Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '4_decision_guidance.xml'.
|
||||||
|
Proporciona árboles de decisión y guía para elecciones comunes en este modo.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prompt para 5_examples.xml:**
|
||||||
|
```
|
||||||
|
Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '5_examples.xml'.
|
||||||
|
Proporciona 2-3 ejemplos resueltos mostrando salida correcta de este modo.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prompt para 6_error_handling.xml:**
|
||||||
|
```
|
||||||
|
Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '6_error_handling.xml'.
|
||||||
|
Define escenarios de error, métodos de detección y pasos de resolución.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prompt para 7_communication.xml:**
|
||||||
|
```
|
||||||
|
Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '7_communication.xml'.
|
||||||
|
Define plantillas de transferencia para pasar trabajo hacia y desde este modo.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Paso 4: Registrar Modo**
|
||||||
|
|
||||||
|
Agregue el modo al archivo `.roomodes` o copie `mode-config.yaml` al directorio de modos.
|
||||||
|
|
||||||
|
### 6.2 Agregar una Nueva Habilidad
|
||||||
|
|
||||||
|
**Paso 1: Crear Directorio de Habilidad**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mkdir -p skills/nueva-habilidad
|
||||||
|
```
|
||||||
|
|
||||||
|
**Paso 2: Crear SKILL.md**
|
||||||
|
|
||||||
|
Cree `skills/nueva-habilidad/SKILL.md`:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
---
|
||||||
|
name: nueva-habilidad
|
||||||
|
description: Breve descripción de lo que hace esta habilidad
|
||||||
|
---
|
||||||
|
|
||||||
|
# Nueva Habilidad
|
||||||
|
|
||||||
|
## Capacidades
|
||||||
|
- Capacidad 1: Descripción
|
||||||
|
- Capacidad 2: Descripción
|
||||||
|
- Capacidad 3: Descripción
|
||||||
|
|
||||||
|
## Uso
|
||||||
|
Describir cuándo y cómo usar esta habilidad. Incluir escenarios específicos.
|
||||||
|
|
||||||
|
## Entrada
|
||||||
|
Describir el formato de entrada esperado:
|
||||||
|
- Tipos de archivo aceptados
|
||||||
|
- Estructura de datos esperada
|
||||||
|
- Campos requeridos
|
||||||
|
|
||||||
|
## Salida
|
||||||
|
Describir el formato de salida:
|
||||||
|
- Tipos de archivo producidos
|
||||||
|
- Estructura de datos devuelta
|
||||||
|
- Indicadores de éxito/fallo
|
||||||
|
|
||||||
|
## Limitaciones
|
||||||
|
- Limitación 1
|
||||||
|
- Limitación 2
|
||||||
|
|
||||||
|
## Suposiciones
|
||||||
|
- Suposición 1
|
||||||
|
- Suposición 2
|
||||||
|
```
|
||||||
|
|
||||||
|
**Paso 3: Probar Habilidad**
|
||||||
|
|
||||||
|
1. Active el modo padre
|
||||||
|
2. Invoque la habilidad por nombre
|
||||||
|
3. Verifique que devuelva la salida esperada
|
||||||
|
4. Pruebe el manejo de errores con entrada inválida
|
||||||
|
|
||||||
|
### 6.3 Modificar Modos Existentes
|
||||||
|
|
||||||
|
**Para cambiar permisos:**
|
||||||
|
1. Edite `modes/[modo]/mode-config.yaml`
|
||||||
|
2. Actualice `fileRestrictions` o `allowedCommands`
|
||||||
|
3. Pruebe que el modo aún funciona correctamente
|
||||||
|
|
||||||
|
**Para cambiar flujo de trabajo:**
|
||||||
|
1. Edite `modes/[modo]/rules/1_workflow.xml`
|
||||||
|
2. Asegure que el XML está bien formado
|
||||||
|
3. Pruebe el flujo de trabajo en Roo Code
|
||||||
|
|
||||||
|
**Para agregar mejores prácticas:**
|
||||||
|
1. Edite `modes/[modo]/rules/2_best_practices.xml`
|
||||||
|
2. Agregue nuevos elementos `<practice>`
|
||||||
|
3. Verifique que el modo aplica las nuevas prácticas
|
||||||
|
|
||||||
|
### 6.4 Modificar Habilidades Existentes
|
||||||
|
|
||||||
|
**Para actualizar una habilidad:**
|
||||||
|
1. Edite `skills/[habilidad]/SKILL.md`
|
||||||
|
2. Actualice la sección relevante (Capacidades, Uso, Entrada, Salida, etc.)
|
||||||
|
3. Pruebe la habilidad en su modo padre
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Secuencias de Prompts para Tareas de Soporte
|
||||||
|
|
||||||
|
### 7.1 Instalar Todos los Modos y Habilidades
|
||||||
|
|
||||||
|
```
|
||||||
|
Instala los 6 modos y 30 habilidades del proyecto innovation-content.
|
||||||
|
Copia las configuraciones de modos a .roomodes, reglas XML a .roo/rules-[slug]/,
|
||||||
|
y habilidades a .agents/skills/. Verifica que cada modo carga correctamente.
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.2 Validar Instalación
|
||||||
|
|
||||||
|
```
|
||||||
|
Valida la instalación de innovation-content:
|
||||||
|
1. Verifica que las 6 configuraciones de modo existen y son YAML válido
|
||||||
|
2. Verifica que los 42 archivos de reglas XML existen y están bien formados
|
||||||
|
3. Verifica que los 30 archivos SKILL.md existen y tienen frontmatter YAML
|
||||||
|
4. Prueba cambiar a cada modo
|
||||||
|
5. Reporta cualquier problema encontrado
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.3 Agregar Nuevo Modo
|
||||||
|
|
||||||
|
```
|
||||||
|
Crea un nuevo modo llamado '[Nombre del Modo]' con slug '[slug-del-modo]'.
|
||||||
|
Debe [describir propósito].
|
||||||
|
Crea mode-config.yaml y 7 archivos de reglas XML en modes/[slug-del-modo]/.
|
||||||
|
El modo debe tener permisos para [listar directorios/patrones].
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.4 Agregar Nueva Habilidad
|
||||||
|
|
||||||
|
```
|
||||||
|
Crea una nueva habilidad llamada '[Nombre de Habilidad]' para el modo [nombre-modo].
|
||||||
|
Debe [describir capacidad].
|
||||||
|
Crea SKILL.md en skills/[slug-habilidad]/ con frontmatter YAML,
|
||||||
|
secciones de Capacidades, Uso, Entrada, Salida, Limitaciones y Suposiciones.
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.5 Depurar Problema de Carga de Modo
|
||||||
|
|
||||||
|
```
|
||||||
|
Depura por qué el modo [slug-del-modo] no está cargando correctamente.
|
||||||
|
1. Verifica que mode-config.yaml existe y es YAML válido
|
||||||
|
2. Verifica que los 7 archivos de reglas XML existen y son XML bien formado
|
||||||
|
3. Verifica que los permisos de archivo no son demasiado restrictivos
|
||||||
|
4. Verifica conflictos con otros modos
|
||||||
|
5. Reporta hallazgos y solución sugerida
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.6 Depurar Habilidad No Encontrada
|
||||||
|
|
||||||
|
```
|
||||||
|
Depura por qué la habilidad [nombre-habilidad] no se encuentra.
|
||||||
|
1. Verifica que skills/[nombre-habilidad]/SKILL.md existe
|
||||||
|
2. Verifica que el frontmatter YAML tiene nombre y descripción
|
||||||
|
3. Verifica que la habilidad está en la lista de habilidades del modo correcto
|
||||||
|
4. Verifica conflictos de nombres
|
||||||
|
5. Reporta hallazgos y solución sugerida
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.7 Actualizar Permisos de Modo
|
||||||
|
|
||||||
|
```
|
||||||
|
Actualiza los permisos para el modo [slug-del-modo] para permitir edición de:
|
||||||
|
- [nuevo-patron-1]/**/*
|
||||||
|
- *.[nueva-extension]
|
||||||
|
Actualiza modes/[slug-del-modo]/mode-config.yaml y verifica el cambio.
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.8 Generar Documentación de Modo
|
||||||
|
|
||||||
|
```
|
||||||
|
Genera documentación para el modo [slug-del-modo] incluyendo:
|
||||||
|
1. Propósito del modo y cuándo usar
|
||||||
|
2. Lista de 5 habilidades con descripciones
|
||||||
|
3. Resumen del flujo de trabajo
|
||||||
|
4. Permisos de archivo
|
||||||
|
5. Protocolos de comunicación (transferencias hacia/desde este modo)
|
||||||
|
Salida como markdown adecuado para inclusión en README o wiki.
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Mantenimiento
|
||||||
|
|
||||||
|
### 8.1 Actualizar desde Remoto
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd innovation-content
|
||||||
|
git pull origin main
|
||||||
|
# Re-instalar modos y habilidades si se agregaron nuevos
|
||||||
|
```
|
||||||
|
|
||||||
|
### 8.2 Respaldar Personalizaciones
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Respaldar configuraciones de modos personalizados
|
||||||
|
cp ~/.roo/modes/*.yaml backups/modes/
|
||||||
|
|
||||||
|
# Respaldar habilidades personalizadas
|
||||||
|
cp -r ~/.agents/skills/* backups/skills/
|
||||||
|
|
||||||
|
# Respaldar reglas personalizadas
|
||||||
|
cp -r ~/.roo/rules-* backups/rules/
|
||||||
|
```
|
||||||
|
|
||||||
|
### 8.3 Compatibilidad de Versiones
|
||||||
|
|
||||||
|
| Versión de Contenido de Innovación | Versión Mínima de Roo Code | Notas |
|
||||||
|
|-------------------------------------|----------------------------|-------|
|
||||||
|
| 1.0.x | 3.8 | Lanzamiento inicial |
|
||||||
|
| 1.1.x | 3.8 | Guía del equipo de soporte y guía del usuario |
|
||||||
|
| 1.1.1 | 3.8 | Versiones en español de toda la documentación |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Contacto y Escalamiento
|
||||||
|
|
||||||
|
| Tipo de Problema | Contacto | Ruta de Escalamiento |
|
||||||
|
|------------------|----------|---------------------|
|
||||||
|
| Problemas de instalación | Equipo de Soporte | Líder Técnico |
|
||||||
|
| Problemas de comportamiento de modo | Desarrollador de Modos | Líder del Proyecto |
|
||||||
|
| Problemas de habilidades | Desarrollador de Habilidades | Líder del Proyecto |
|
||||||
|
| Solicitudes de funciones | Líder del Proyecto | Propietario del Producto |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. Apéndice
|
||||||
|
|
||||||
|
### 10.1 Referencia de Estructura de Archivos
|
||||||
|
|
||||||
|
```
|
||||||
|
innovation-content/
|
||||||
|
├── modes/
|
||||||
|
│ └── [slug-del-modo]/
|
||||||
|
│ ├── mode-config.yaml
|
||||||
|
│ └── rules/
|
||||||
|
│ ├── 1_workflow.xml
|
||||||
|
│ ├── 2_best_practices.xml
|
||||||
|
│ ├── 3_common_patterns.xml
|
||||||
|
│ ├── 4_decision_guidance.xml
|
||||||
|
│ ├── 5_examples.xml
|
||||||
|
│ ├── 6_error_handling.xml
|
||||||
|
│ └── 7_communication.xml
|
||||||
|
├── skills/
|
||||||
|
│ └── [slug-habilidad]/
|
||||||
|
│ └── SKILL.md
|
||||||
|
└── docs/
|
||||||
|
├── plan.md
|
||||||
|
├── srs.md
|
||||||
|
├── support-team-guide.md
|
||||||
|
├── user-guide.md
|
||||||
|
├── plan-ES.md
|
||||||
|
├── srs-ES.md
|
||||||
|
├── support-team-guide-ES.md
|
||||||
|
└── user-guide-ES.md
|
||||||
|
```
|
||||||
|
|
||||||
|
### 10.2 Tarjeta de Referencia Rápida
|
||||||
|
|
||||||
|
| Tarea | Comando/Acción |
|
||||||
|
|-------|----------------|
|
||||||
|
| Instalar modos | `cp modes/*/mode-config.yaml ~/.roo/modes/` |
|
||||||
|
| Instalar reglas | `cp -r modes/*/rules/* ~/.roo/rules-[slug]/` |
|
||||||
|
| Instalar habilidades | `cp -r skills/* ~/.agents/skills/` |
|
||||||
|
| Validar YAML | `yamllint mode-config.yaml` |
|
||||||
|
| Validar XML | `xmllint --noout regla.xml` |
|
||||||
|
| Probar modo | Cambiar a modo en Roo Code |
|
||||||
|
| Probar habilidad | Invocar habilidad por nombre en modo |
|
||||||
531
docs/user-guide-ES.md
Normal file
531
docs/user-guide-ES.md
Normal file
@@ -0,0 +1,531 @@
|
|||||||
|
# Guía del Usuario
|
||||||
|
|
||||||
|
## Contenido de Innovación: Modos y Habilidades de Desarrollo de Contenido Educativo
|
||||||
|
|
||||||
|
**Versión:** 1.1.1
|
||||||
|
**Audiencia:** Desarrolladores de Contenido Educativo, Diseñadores Instruccionales, Productores de Contenido
|
||||||
|
**Fecha:** 2026-04-24
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Introducción
|
||||||
|
|
||||||
|
### 1.1 ¿Qué es Contenido de Innovación?
|
||||||
|
|
||||||
|
Contenido de Innovación es un conjunto especializado de **modos** y **habilidades** para Roo Code que transforma cómo se crea, revisa y entrega el contenido educativo. Piensa en ello como tener seis colegas expertos—cada uno especializado en un aspecto diferente del desarrollo de contenido educativo—trabajando junto a ti en tu editor de código.
|
||||||
|
|
||||||
|
### 1.2 Conceptos Clave
|
||||||
|
|
||||||
|
#### Modos
|
||||||
|
|
||||||
|
Un **modo** es una configuración especializada de Roo Code adaptada a un rol específico. Cuando activas un modo, Roo Code adopta el comportamiento, permisos y experiencia de ese rol.
|
||||||
|
|
||||||
|
| Modo | Rol | Cuándo Usar |
|
||||||
|
|------|-----|-------------|
|
||||||
|
| 📝 Diseñador Curricular | Arquitecto educativo | Al diseñar currículos, objetivos de aprendizaje y estructuras de curso |
|
||||||
|
| 📖 Escritor Instruccional | Autor de contenido | Al escribir contenido de lecciones, ejercicios y documentación para aprendices |
|
||||||
|
| 🧪 Desarrollador de Evaluaciones | Especialista en medición | Al crear cuestionarios, rúbricas y criterios de evaluación |
|
||||||
|
| 🎬 Productor de Contenido | Creador multimedia | Al producir guiones de video, contenido interactivo y activos multimedia |
|
||||||
|
| 🎨 Diseñador de Experiencia de Aprendizaje | Especialista en engagement | Al diseñar journeys de aprendizaje, gamificación y microaprendizaje |
|
||||||
|
| ♿ Auditor de Accesibilidad | Especialista en inclusión | Al auditar contenido para cumplimiento WCAG y accesibilidad |
|
||||||
|
|
||||||
|
#### Habilidades
|
||||||
|
|
||||||
|
Una **habilidad** es una capacidad reutilizable que los modos pueden invocar. Las habilidades son como herramientas especializadas en un taller—cada una hace un trabajo específico bien.
|
||||||
|
|
||||||
|
Por ejemplo, el modo Diseñador Curricular tiene estas habilidades:
|
||||||
|
- `learning-objective-validator` — Verifica que los objetivos usen verbos apropiados de la Taxonomía de Bloom
|
||||||
|
- `competency-mapper` — Mapea objetivos a estándares como Common Core o NGSS
|
||||||
|
- `curriculum-gap-analyzer` — Encuentra brechas en la cobertura del currículo
|
||||||
|
|
||||||
|
### 1.3 Cómo Funciona
|
||||||
|
|
||||||
|
```
|
||||||
|
Proporcionas entrada → El modo la procesa usando habilidades → Obtienes salida estructurada
|
||||||
|
```
|
||||||
|
|
||||||
|
Cada modo sigue un flujo de trabajo definido, aplica mejores prácticas y se comunica con otros modos a través de transferencias estandarizadas.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Primeros Pasos
|
||||||
|
|
||||||
|
### 2.1 Tu Primera Sesión
|
||||||
|
|
||||||
|
**Paso 1: Elige Tu Modo**
|
||||||
|
|
||||||
|
Piensa en lo que intentas lograr:
|
||||||
|
|
||||||
|
- "Necesito diseñar un nuevo curso" → **Diseñador Curricular**
|
||||||
|
- "Necesito escribir contenido de lección" → **Escritor Instruccional**
|
||||||
|
- "Necesito crear un cuestionario" → **Desarrollador de Evaluaciones**
|
||||||
|
- "Necesito producir un video" → **Productor de Contenido**
|
||||||
|
- "Necesito diseñar un journey de aprendizaje" → **Diseñador LX**
|
||||||
|
- "Necesito verificar accesibilidad" → **Auditor de Accesibilidad**
|
||||||
|
|
||||||
|
**Paso 2: Activa el Modo**
|
||||||
|
|
||||||
|
En Roo Code, cambia a tu modo elegido:
|
||||||
|
|
||||||
|
```
|
||||||
|
Switch to curriculum-designer mode
|
||||||
|
```
|
||||||
|
|
||||||
|
**Paso 3: Proporciona Tu Entrada**
|
||||||
|
|
||||||
|
Da al modo contexto sobre en qué estás trabajando:
|
||||||
|
|
||||||
|
```
|
||||||
|
Necesito crear un currículo para un curso de biología de secundaria sobre fotosíntesis.
|
||||||
|
La audiencia objetivo son estudiantes de noveno grado. El curso debe alinearse con estándares NGSS.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Paso 4: Revisa la Salida**
|
||||||
|
|
||||||
|
El modo generará salida estructurada. Revísala y proporciona retroalimentación:
|
||||||
|
|
||||||
|
```
|
||||||
|
Los objetivos de aprendizaje se ven bien, pero me gustaría más énfasis en las reacciones dependientes de la luz.
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.2 El Flujo de Trabajo de Desarrollo de Contenido
|
||||||
|
|
||||||
|
Los seis modos trabajan juntos en un pipeline:
|
||||||
|
|
||||||
|
```
|
||||||
|
1. El Diseñador Curricular define QUÉ enseñar
|
||||||
|
↓
|
||||||
|
2. El Escritor Instruccional crea CÓMO enseñarlo
|
||||||
|
↓
|
||||||
|
3. El Desarrollador de Evaluaciones crea CÓMO medir el aprendizaje
|
||||||
|
↓
|
||||||
|
4. El Productor de Contenido crea materiales MULTIMEDIA
|
||||||
|
↓
|
||||||
|
5. El Diseñador LX crea experiencias ATRACTIVAS
|
||||||
|
↓
|
||||||
|
6. El Auditor de Accesibilidad asegura que TODOS puedan acceder
|
||||||
|
```
|
||||||
|
|
||||||
|
Puedes comenzar en cualquier punto del pipeline dependiendo de tu rol.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Usar los Modos Efectivamente
|
||||||
|
|
||||||
|
### 3.1 Modo Diseñador Curricular
|
||||||
|
|
||||||
|
**Ideal para:** Arquitectos de cursos, coordinadores de currículo, diseñadores instruccionales
|
||||||
|
|
||||||
|
**Lo que hace:**
|
||||||
|
- Valida objetivos de aprendizaje usando la Taxonomía de Bloom
|
||||||
|
- Mapea objetivos a estándares educativos
|
||||||
|
- Identifica brechas en la cobertura del currículo
|
||||||
|
- Valida cadenas de prerrequisitos
|
||||||
|
|
||||||
|
**Cómo obtener los mejores resultados:**
|
||||||
|
|
||||||
|
1. **Sé específico sobre tu audiencia:**
|
||||||
|
```
|
||||||
|
Bueno: "Crear objetivos para estudiantes de química de décimo grado"
|
||||||
|
Mejor: "Crear 8 objetivos medibles para química de décimo grado sobre enlace químico, alineados a NGSS HS-PS1-2"
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Proporciona estándares existentes:**
|
||||||
|
```
|
||||||
|
"Alinea este currículo a los estándares de Matemáticas Common Core para Álgebra II, específicamente los clústeres A-SSE, A-APR y F-IF"
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Solicita análisis de brechas:**
|
||||||
|
```
|
||||||
|
"Analiza este currículo para brechas. ¿Hay alguna expectativa de desempeño NGSS no cubierta?"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Consejo profesional:** Comienza con el fin en mente. Dile al Diseñador Curricular qué deberían poder HACER los estudiantes después de completar el curso, y trabajará hacia atrás para diseñar el currículo.
|
||||||
|
|
||||||
|
### 3.2 Modo Escritor Instruccional
|
||||||
|
|
||||||
|
**Ideal para:** Escritores de contenido, expertos en materia, profesores
|
||||||
|
|
||||||
|
**Lo que hace:**
|
||||||
|
- Analiza legibilidad del contenido (Flesch-Kincaid, SMOG)
|
||||||
|
- Asegura consistencia de tono en lecciones
|
||||||
|
- Diseña ejercicios de aprendizaje activo
|
||||||
|
- Evalúa calidad de explicaciones
|
||||||
|
|
||||||
|
**Cómo obtener los mejores resultados:**
|
||||||
|
|
||||||
|
1. **Especifica el nivel de lectura de tu audiencia:**
|
||||||
|
```
|
||||||
|
"Escribe esta lección para nivel de lectura de octavo grado (Flesch-Kincaid grado 8)"
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Proporciona los objetivos de aprendizaje:**
|
||||||
|
```
|
||||||
|
"Escribe una lección que ayude a los estudiantes a lograr este objetivo: 'Los estudiantes podrán explicar el proceso de fotosíntesis'"
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Solicita aprendizaje activo:**
|
||||||
|
```
|
||||||
|
"Incluye 3 ejercicios de aprendizaje activo: uno individual, uno en pareja y uno en grupo"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Consejo profesional:** Usa la estructura Enganchar-Definir-Ejemplo-Elaborar-Verificar para explicaciones. El Escritor Instruccional seguirá este patrón automáticamente si pides "explicaciones bien estructuradas."
|
||||||
|
|
||||||
|
### 3.3 Modo Desarrollador de Evaluaciones
|
||||||
|
|
||||||
|
**Ideal para:** Diseñadores de evaluaciones, desarrolladores de pruebas, evaluadores
|
||||||
|
|
||||||
|
**Lo que hace:**
|
||||||
|
- Valida alineación de evaluaciones a objetivos
|
||||||
|
- Realiza análisis de ítems (dificultad, discriminación)
|
||||||
|
- Genera rúbricas con descriptores de desempeño
|
||||||
|
- Detecta sesgo en ítems de evaluación
|
||||||
|
|
||||||
|
**Cómo obtener los mejores resultados:**
|
||||||
|
|
||||||
|
1. **Proporciona los objetivos de aprendizaje:**
|
||||||
|
```
|
||||||
|
"Crea 10 preguntas de opción múltiple que evalúen este objetivo: 'Los estudiantes podrán resolver ecuaciones cuadráticas'"
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Especifica distribución de dificultad:**
|
||||||
|
```
|
||||||
|
"Incluye 3 fáciles, 5 medias y 2 difíciles"
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Solicita revisión de sesgo:**
|
||||||
|
```
|
||||||
|
"Revisa estos ítems de evaluación para sesgo de género, cultural y socioeconómico"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Consejo profesional:** Siempre pide una rúbrica al crear evaluaciones de desempeño. La habilidad rubric-generator crea rúbricas analíticas con descriptores claros de desempeño para cada nivel.
|
||||||
|
|
||||||
|
### 3.4 Modo Productor de Contenido
|
||||||
|
|
||||||
|
**Ideal para:** Productores de video, diseñadores multimedia, desarrolladores de e-learning
|
||||||
|
|
||||||
|
**Lo que hace:**
|
||||||
|
- Valida storyboards contra objetivos
|
||||||
|
- Gestiona activos multimedia
|
||||||
|
- Empaqueta contenido para entrega SCORM/xAPI a LMS
|
||||||
|
- Crea contenido interactivo H5P
|
||||||
|
|
||||||
|
**Cómo obtener los mejores resultados:**
|
||||||
|
|
||||||
|
1. **Proporciona el storyboard o guion:**
|
||||||
|
```
|
||||||
|
"Crea un storyboard de video explicativo de 5 minutos sobre el ciclo del agua para estudiantes de secundaria"
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Especifica requisitos de accesibilidad:**
|
||||||
|
```
|
||||||
|
"Asegura que todo el contenido de video incluya subtítulos y transcripciones"
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Solicita empaquetado SCORM:**
|
||||||
|
```
|
||||||
|
"Empaqueta este contenido como un paquete SCORM 2004 para Moodle LMS"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Consejo profesional:** Mantén los videos bajo 6 minutos para engagement óptimo. El Productor de Contenido sugerirá automáticamente dividir contenido más largo en micro-videos.
|
||||||
|
|
||||||
|
### 3.5 Modo Diseñador de Experiencia de Aprendizaje
|
||||||
|
|
||||||
|
**Ideal para:** Diseñadores UX, especialistas en engagement, tecnólogos de aprendizaje
|
||||||
|
|
||||||
|
**Lo que hace:**
|
||||||
|
- Mapea journeys y rutas de aprendizaje
|
||||||
|
- Analiza patrones de engagement
|
||||||
|
- Diseña elementos de gamificación
|
||||||
|
- Arquitecta estructuras de microaprendizaje
|
||||||
|
|
||||||
|
**Cómo obtener los mejores resultados:**
|
||||||
|
|
||||||
|
1. **Proporciona el paquete de contenido:**
|
||||||
|
```
|
||||||
|
"Diseña un journey de aprendiz para este curso de 8 módulos sobre ciencia de datos. Cada módulo toma unos 30 minutos"
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Especifica objetivos de engagement:**
|
||||||
|
```
|
||||||
|
"Incluye elementos de gamificación que motiven la completación sin depender de recompensas extrínsecas"
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Solicita estructura de microaprendizaje:**
|
||||||
|
```
|
||||||
|
"Divide este módulo de 2 horas en unidades de microaprendizaje de 5-15 minutos cada una"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Consejo profesional:** Enfócate en motivación intrínseca. La habilidad gamification-designer prefiere insignias y sistemas de logro que reconocen dominio sobre puntos y tablas de clasificación.
|
||||||
|
|
||||||
|
### 3.6 Modo Auditor de Accesibilidad
|
||||||
|
|
||||||
|
**Ideal para:** Especialistas en accesibilidad, probadores QA, revisores de contenido
|
||||||
|
|
||||||
|
**Lo que hace:**
|
||||||
|
- Audita cumplimiento WCAG 2.1/2.2 en niveles A, AA, AAA
|
||||||
|
- Simula experiencia de lector de pantalla
|
||||||
|
- Analiza ratios de contraste de color
|
||||||
|
- Proporciona guía de remediación
|
||||||
|
|
||||||
|
**Cómo obtener los mejores resultados:**
|
||||||
|
|
||||||
|
1. **Proporciona el contenido a auditar:**
|
||||||
|
```
|
||||||
|
"Audita esta página de lección para cumplimiento WCAG 2.1 AA"
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Especifica el nivel objetivo:**
|
||||||
|
```
|
||||||
|
"Verifica este contenido contra los criterios de éxito WCAG 2.2 AA"
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Solicita guía de remediación:**
|
||||||
|
```
|
||||||
|
"Para cada problema encontrado, proporciona pasos específicos de remediación con ejemplos de código"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Consejo profesional:** Ejecuta el Auditor de Accesibilidad temprano y a menudo. Es más fácil corregir problemas de accesibilidad durante la creación que después de la publicación.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Optimizar Tu Flujo de Trabajo
|
||||||
|
|
||||||
|
### 4.1 Estrategias para Ahorrar Tiempo
|
||||||
|
|
||||||
|
| Estrategia | Descripción | Tiempo Ahorrado |
|
||||||
|
|------------|-------------|-----------------|
|
||||||
|
| **Agrupar tareas similares** | Agrupa toda la escritura de objetivos, luego toda la escritura de lecciones, luego toda la creación de evaluaciones | 20-30% |
|
||||||
|
| **Usar transferencias entre modos** | Deja que los modos se pasen trabajo automáticamente | 15-25% |
|
||||||
|
| **Invocar habilidades directamente** | Invoca habilidades específicas cuando solo necesitas una capacidad | 10-20% |
|
||||||
|
| **Plantillar tus entradas** | Crea plantillas de entrada reutilizables para tareas comunes | 25-35% |
|
||||||
|
|
||||||
|
### 4.2 Plantillas de Entrada
|
||||||
|
|
||||||
|
**Plantilla de Diseño Curricular:**
|
||||||
|
```
|
||||||
|
Rol: Diseñador Curricular
|
||||||
|
Tarea: Crear currículo para [materia] en [nivel]
|
||||||
|
Audiencia: [audiencia objetivo, edad, conocimientos previos]
|
||||||
|
Estándares: [estándares educativos a los que alinearse]
|
||||||
|
Duración: [duración del curso, duración de sesión]
|
||||||
|
Objetivos: [número de objetivos deseados]
|
||||||
|
Formato de salida: [documento de currículo, lista de objetivos, etc.]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Plantilla de Escritura de Lecciones:**
|
||||||
|
```
|
||||||
|
Rol: Escritor Instruccional
|
||||||
|
Tarea: Escribir lección sobre [tema]
|
||||||
|
Audiencia: [audiencia objetivo, nivel de lectura]
|
||||||
|
Objetivos: [objetivos de aprendizaje que aborda esta lección]
|
||||||
|
Duración: [conteo de palabras estimado o duración]
|
||||||
|
Actividades: [tipos de actividades a incluir]
|
||||||
|
Tono: [formal, conversacional, etc.]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Plantilla de Creación de Evaluaciones:**
|
||||||
|
```
|
||||||
|
Rol: Desarrollador de Evaluaciones
|
||||||
|
Tarea: Crear evaluación para [tema/objetivo]
|
||||||
|
Tipo: [opción múltiple, ensayo, desempeño, etc.]
|
||||||
|
Ítems: [número de ítems]
|
||||||
|
Dificultad: [distribución: fácil/medio/difícil]
|
||||||
|
Rúbrica: [sí/no, tipo de rúbrica]
|
||||||
|
Revisión de sesgo: [sí/no]
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.3 Colaboración entre Modos
|
||||||
|
|
||||||
|
**Escenario: Crear un Curso Completo**
|
||||||
|
|
||||||
|
1. **Comienza con el Diseñador Curricular:**
|
||||||
|
```
|
||||||
|
"Diseña un currículo de 6 módulos sobre programación Python para principiantes.
|
||||||
|
Alinea a estándares CSTA. Cada módulo debe tener 3-5 objetivos medibles."
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Transfiere al Escritor Instruccional:**
|
||||||
|
```
|
||||||
|
"Pasa este currículo al Escritor Instruccional. Escribe contenido de lección
|
||||||
|
para el Módulo 1: Variables y Tipos de Datos. Nivel de lectura objetivo: grado 10."
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Transfiere al Desarrollador de Evaluaciones:**
|
||||||
|
```
|
||||||
|
"Pasa la lección del Módulo 1 al Desarrollador de Evaluaciones. Crea un cuestionario
|
||||||
|
de 15 ítems con 5 fáciles, 7 medios, 3 difíciles. Incluye una rúbrica para
|
||||||
|
el ejercicio de codificación."
|
||||||
|
```
|
||||||
|
|
||||||
|
4. **Transfiere al Productor de Contenido:**
|
||||||
|
```
|
||||||
|
"Pasa la lección y evaluación al Productor de Contenido. Crea un storyboard
|
||||||
|
de video explicativo de 5 minutos y 2 actividades interactivas H5P."
|
||||||
|
```
|
||||||
|
|
||||||
|
5. **Transfiere al Diseñador LX:**
|
||||||
|
```
|
||||||
|
"Pasa el paquete completo del Módulo 1 al Diseñador LX. Diseña el journey
|
||||||
|
de aprendiz con un punto de control de progreso y una insignia para completación."
|
||||||
|
```
|
||||||
|
|
||||||
|
6. **Transfiere al Auditor de Accesibilidad:**
|
||||||
|
```
|
||||||
|
"Pasa todo el contenido del Módulo 1 al Auditor de Accesibilidad. Audita para
|
||||||
|
cumplimiento WCAG 2.1 AA y proporciona guía de remediación para cualquier problema."
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.4 Errores Comunes y Cómo Evitarlos
|
||||||
|
|
||||||
|
| Error | Impacto | Prevención |
|
||||||
|
|-------|---------|------------|
|
||||||
|
| Objetivos vagos | Desalineación de contenido | Usa `learning-objective-validator` antes de proceder |
|
||||||
|
| Saltar accesibilidad | Aprendices excluidos | Ejecuta `wcag-compliance-checker` en cada etapa |
|
||||||
|
| Tono inconsistente | Contenido confuso | Usa `tone-consistency-checker` en todas las lecciones |
|
||||||
|
| Evaluaciones desalineadas | Medición inválida | Usa `assessment-validator` para verificar alineación |
|
||||||
|
| Videos demasiado largos | Desengagement del aprendiz | Mantén videos bajo 6 minutos; usa `microlearning-architect` |
|
||||||
|
| Gamificación extrínseca | Motivación a corto plazo | Usa `gamification-designer` con enfoque en motivación intrínseca |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Uso Avanzado
|
||||||
|
|
||||||
|
### 5.1 Personalizar Comportamiento de Modos
|
||||||
|
|
||||||
|
Cada modo puede personalizarse proporcionando contexto adicional en tus prompts:
|
||||||
|
|
||||||
|
```
|
||||||
|
"Como Diseñador Curricular, prioriza el aprendizaje basado en proyectos sobre instrucción directa.
|
||||||
|
Diseña objetivos que enfatizen los niveles de creación y evaluación de la Taxonomía de Bloom."
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
"Como Escritor Instruccional, usa un enfoque de cuestionamiento socrático. Incluye prompts
|
||||||
|
de reflexión después de cada concepto principal."
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.2 Combinar Habilidades
|
||||||
|
|
||||||
|
Puedes invocar múltiples habilidades en secuencia para análisis comprehensivo:
|
||||||
|
|
||||||
|
```
|
||||||
|
"Primero, usa readability-analyzer para verificar el nivel de lectura de esta lección.
|
||||||
|
Luego, usa tone-consistency-checker para asegurar que coincide con nuestra guía de estilo.
|
||||||
|
Finalmente, usa explanation-quality-checker para evaluar las explicaciones."
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.3 Refinamiento Iterativo
|
||||||
|
|
||||||
|
Los modos soportan refinamiento iterativo. Después de recibir salida, puedes pedir cambios:
|
||||||
|
|
||||||
|
```
|
||||||
|
"Los objetivos están bien, pero hazlos más específicos a las expectativas de desempeño NGSS.
|
||||||
|
Agrega dos objetivos más en el nivel 'Crear' de la Taxonomía de Bloom."
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
"La lección es demasiado técnica. Simplifica el lenguaje a nivel de lectura de grado 8
|
||||||
|
y agrega más ejemplos concretos."
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.4 Verificaciones de Calidad
|
||||||
|
|
||||||
|
Antes de finalizar cualquier contenido, ejecuta estas verificaciones de calidad:
|
||||||
|
|
||||||
|
| Verificación | Habilidad | Cuándo Usar |
|
||||||
|
|--------------|-----------|-------------|
|
||||||
|
| Calidad de objetivos | `learning-objective-validator` | Después del diseño curricular |
|
||||||
|
| Legibilidad | `readability-analyzer` | Después de escribir lección |
|
||||||
|
| Alineación de evaluación | `assessment-validator` | Después de crear evaluación |
|
||||||
|
| Revisión de sesgo | `bias-detector` | Antes de publicar evaluaciones |
|
||||||
|
| Cumplimiento WCAG | `wcag-compliance-checker` | Antes de publicar cualquier contenido |
|
||||||
|
| Alineación de storyboard | `storyboard-validator` | Antes de producción de video |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Preguntas Frecuentes
|
||||||
|
|
||||||
|
### P: ¿Puedo usar múltiples modos en una sesión?
|
||||||
|
**R:** Sí. Puedes cambiar entre modos según sea necesario. Los modos están diseñados para transferirse trabajo entre sí, así que puedes comenzar en un modo y continuar en otro.
|
||||||
|
|
||||||
|
### P: ¿Cómo sé qué modo usar?
|
||||||
|
**R:** Consulta la tabla de modos en la Sección 1.2. Si no estás seguro, comienza con Diseñador Curricular—es la base para todo el trabajo demás.
|
||||||
|
|
||||||
|
### P: ¿Puedo personalizar las habilidades?
|
||||||
|
**R:** Las habilidades están diseñadas para ser autocontenidas. Si necesitas modificar el comportamiento de una habilidad, consulta la Guía del Equipo de Soporte para instrucciones sobre extender habilidades.
|
||||||
|
|
||||||
|
### P: ¿Qué pasa si la salida no satisface mis necesidades?
|
||||||
|
**R:** Proporciona retroalimentación específica y pide revisiones. Los modos soportan refinamiento iterativo. Por ejemplo: "Los objetivos son demasiado generales. Hazlos más específicos y medibles."
|
||||||
|
|
||||||
|
### P: ¿Cómo aseguro consistencia en un proyecto grande?
|
||||||
|
**R:** Usa la habilidad `tone-consistency-checker` en todo el contenido escrito, y ejecuta `standards-compliance-checker` en el currículo completo. El Auditor de Accesibilidad también puede asegurar consistencia en todo el contenido publicado.
|
||||||
|
|
||||||
|
### P: ¿Puedo usar estos modos para contenido no educativo?
|
||||||
|
**R:** Aunque diseñados para contenido educativo, muchas habilidades (como `readability-analyzer`, `tone-consistency-checker` y `wcag-compliance-checker`) son aplicables a cualquier creación de contenido.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Referencia Rápida
|
||||||
|
|
||||||
|
### Guía de Selección de Modos
|
||||||
|
|
||||||
|
| Si necesitas... | Usa este modo | Habilidad clave |
|
||||||
|
|-----------------|---------------|-----------------|
|
||||||
|
| Definir qué deben aprender los estudiantes | Diseñador Curricular | `learning-objective-validator` |
|
||||||
|
| Escribir contenido de lección | Escritor Instruccional | `explanation-quality-checker` |
|
||||||
|
| Crear un cuestionario o prueba | Desarrollador de Evaluaciones | `assessment-validator` |
|
||||||
|
| Producir un video | Productor de Contenido | `storyboard-validator` |
|
||||||
|
| Diseñar un camino de aprendizaje | Diseñador LX | `journey-mapper` |
|
||||||
|
| Verificar accesibilidad | Auditor de Accesibilidad | `wcag-compliance-checker` |
|
||||||
|
| Verificar nivel de lectura | Escritor Instruccional | `readability-analyzer` |
|
||||||
|
| Crear una rúbrica | Desarrollador de Evaluaciones | `rubric-generator` |
|
||||||
|
| Empaquetar para LMS | Productor de Contenido | `scorm-packager` |
|
||||||
|
| Agregar gamificación | Diseñador LX | `gamification-designer` |
|
||||||
|
|
||||||
|
### Referencia Rápida de la Taxonomía de Bloom
|
||||||
|
|
||||||
|
| Nivel | Verbos Clave | Ejemplo |
|
||||||
|
|-------|--------------|---------|
|
||||||
|
| Recordar | listar, definir, identificar, recordar | "Lista las partes de una célula" |
|
||||||
|
| Comprender | explicar, describir, resumir | "Explica cómo funciona la fotosíntesis" |
|
||||||
|
| Aplicar | usar, resolver, demostrar | "Usa la fórmula para resolver el problema" |
|
||||||
|
| Analizar | comparar, contrastar, diferenciar | "Compara mitosis y meiosis" |
|
||||||
|
| Evaluar | juzgar, criticar, justificar | "Justifica tu respuesta con evidencia" |
|
||||||
|
| Crear | diseñar, construir, producir | "Diseña un experimento para probar..." |
|
||||||
|
|
||||||
|
### Referencia Rápida de WCAG 2.1
|
||||||
|
|
||||||
|
| Principio | Qué significa | Verificación clave |
|
||||||
|
|-----------|---------------|-------------------|
|
||||||
|
| Perceptible | Los usuarios pueden percibir contenido | Texto alt, subtítulos, contraste de color |
|
||||||
|
| Operable | Los usuarios pueden interactuar con contenido | Navegación por teclado, sin límites de tiempo |
|
||||||
|
| Comprensible | Los usuarios pueden entender contenido | Lenguaje claro, navegación consistente |
|
||||||
|
| Robusto | El contenido funciona con tecnología asistiva | HTML válido, etiquetas ARIA |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Recursos Adicionales
|
||||||
|
|
||||||
|
- **Guía del Equipo de Soporte:** Consulta `docs/support-team-guide.md` para instrucciones de instalación y extensión
|
||||||
|
- **Plan de Desarrollo:** Consulta `docs/plan.md` para la hoja de ruta del proyecto
|
||||||
|
- **Especificación de Requisitos:** Consulta `docs/srs.md` para requisitos detallados
|
||||||
|
- **Configuración de Agentes:** Consulta `AGENTS.md` para directrices de comportamiento de agentes
|
||||||
|
- **Versiones en Español:** Todos los documentos están disponibles en español con sufijo `-ES` (ej. `docs/plan-ES.md`)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Glosario
|
||||||
|
|
||||||
|
| Término | Definición |
|
||||||
|
|---------|------------|
|
||||||
|
| **Taxonomía de Bloom** | Un marco para clasificar objetivos de aprendizaje por nivel cognitivo (Recordar, Comprender, Aplicar, Analizar, Evaluar, Crear) |
|
||||||
|
| **Modo** | Una configuración especializada de Roo Code para un rol específico |
|
||||||
|
| **Habilidad** | Una capacidad reutilizable que los modos pueden invocar |
|
||||||
|
| **WCAG** | Pautas de Accesibilidad para el Contenido Web—estándares internacionales para accesibilidad web |
|
||||||
|
| **SCORM** | Modelo de Referencia de Objeto de Contenido Compartible—un estándar para empaquetar contenido e-learning |
|
||||||
|
| **xAPI** | API de Experiencia (Tin Can API)—una especificación para rastrear experiencias de aprendizaje |
|
||||||
|
| **NGSS** | Next Generation Science Standards—estándares de educación científica en EE.UU. |
|
||||||
|
| **CSTA** | Computer Science Teachers Association—estándares de educación en computación |
|
||||||
|
| **H5P** | HTML5 Package—un estándar para crear contenido web interactivo |
|
||||||
|
| **Microaprendizaje** | Dividir contenido en unidades pequeñas (5-15 minutos) para mejor retención |
|
||||||
Reference in New Issue
Block a user