Ruflo
Código del router Ruflo: límites de palabra, orden y copias antiguas
Reproduce diferencias entre el generador actual y la instantánea raíz, y entiende por qué prioridad y confianza heurística no equivalen a comprensión o precisión medida.
Qué aprenderás
- Encuentra el generador antes del ayudante
- Comprende la mejora y su límite
- Reproduce un modelo independiente pequeño
Antes de empezar
- Conceptos básicos de Node.js, Git y terminal
- Repositorio propio y límites de tarea y permisos definidos
Explica el código del capítulo y reproduce su prueba acotada sin confundir un ayudante con todo el runtime.
Conclusiones clave
- Prueba salida generada y archivo activo por separado.
- Los límites de palabra reducen subcadenas, no ambigüedad por orden.
- Valores heurísticos fijos no son precisión del modelo medida.
Encuentra el generador antes del ayudante
El smoke test examinado señala generateAgentRouter, en helpers-generator.ts, como fuente de verdad. Devuelve un ayudante JavaScript completo que generateHelpers incluye al habilitar el componente. La prueba verificó el hash, seleccionó esa función del árbol TypeScript y evaluó su salida con argumentos simulados, sin escribir ayudantes en el proyecto.
La copia raíz se probó aparte. Ante “review latest issues”, su subcadena test sin límites coincide dentro de latest y elige tester antes de review. El generador actual elige reviewer. Esto no demuestra que todos los proyectos instalados estén actualizados: una carpeta existente puede seguir ejecutando el ayudante antiguo.
Comprende la mejora y su límite
El generador añade límites de palabra a tokens individuales; las frases con espacios o barra se escapan y coinciden literalmente. Los patrones precompilados se recorren en orden. “review and add tests” elige coder porque su entrada anterior coincide con add. No ordena todos los agentes coincidentes ni interpreta qué cláusula importa más.
Los valores de coincidencia y alternativa son constantes, 0.6 y 0.3. No se calibran para la tarea ni proceden de resultados de usuarios. Las reglas inglesas tampoco prueban calidad multilingüe. Si necesitas selección sensible al idioma o varias etiquetas, evalúa ese requisito sin extrapolar desde esta tabla sencilla.
Reproduce un modelo independiente pequeño
El ejemplo conserva tres roles para mostrar límites y orden: devuelve reviewer para la primera tarea, coder para la mezcla y fallback para una palabra que contiene ci internamente. Es un modelo didáctico independiente, no el generador completo de ocho roles. Sus resultados se prueban en las tres ediciones lingüísticas.
Para verificar una actualización, conserva peticiones positivas y palabras cercanas como decision o specifications. Compara la salida del ayudante activo antes y después, junto con revisión y explicación. Puedes detectar regresiones sin arrancar agentes, pero una ruta correcta aún no prueba que el agente elegido complete la tarea.
Pasos de implementación
- 1
Localiza generateAgentRouter y el ayudante activo.
- 2
Compara positivos y palabras cercanas.
- 3
Prueba una petición con varios roles.
- 4
Registra selección aparte de aceptación final.
Ejemplo para copiar
function chooseRole(task) {
const rules = [[/\b(?:add|build)\b/i,"coder"],[/\btest\b/i,"tester"],[/\breview\b/i,"reviewer"]];
return rules.find(([pattern]) => pattern.test(task))?.[1] ?? "fallback";
}
console.log(["review latest issues","review and add tests","make a decision"].map(chooseRole));Preguntas frecuentes
¿La prueba del router inició un agente real?
No. Evaluó el ayudante con argumentos simulados y comprobó únicamente la sugerencia devuelta.
¿Por qué no interpretar 0.6 como 60% de éxito?
El código lo llama valor previo heurístico. Ningún conjunto de resultados lo calibró como probabilidad.
Fuentes
- v3/@claude-flow/cli/src/init/helpers-generator.tsFuente verificada 2026-09-08
- .claude/helpers/router.cjsFuente verificada 2026-09-08
- scripts/smoke-router-regex.mjsFuente verificada 2026-09-08