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
|
||||
|
||||
### Added
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 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.
|
||||
|
||||
@@ -102,7 +102,11 @@ innovation-content/
|
||||
│ ├── plan.md # Development plan
|
||||
│ ├── srs.md # Software Requirements Specification
|
||||
│ ├── 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
|
||||
│ ├── curriculum-designer/ # 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 Name:** Innovation Content
|
||||
**Version:** 1.1.0
|
||||
**Version:** 1.1.1
|
||||
**Start Date:** 2026-04-24
|
||||
**Target Completion:** 2026-06-19 (8 weeks)
|
||||
**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) |
|
||||
| Skills | 30 | Specialized capabilities across all 6 modes |
|
||||
| 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
|
||||
|
||||
**Version:** 1.1.0
|
||||
**Version:** 1.1.1
|
||||
**Date:** 2026-04-24
|
||||
**Status:** Final
|
||||
|
||||
@@ -410,9 +410,9 @@ Skills may be shared between modes where capabilities overlap:
|
||||
| XML Rule Files | 42 | 42 | ✅ Complete |
|
||||
| Skills | 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
|
||||
|
||||
@@ -426,6 +426,10 @@ Skills may be shared between modes where capabilities overlap:
|
||||
- `srs.md` - Software Requirements Specification
|
||||
- `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
|
||||
- `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/)
|
||||
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