rogerchappel/connector-route-replay-skill

Habilidad de Reproducción de Rutas de Conectores

Cuándo Usarlo

Usa esta habilidad cuando un agente necesite validar el comportamiento de enrutamiento de conectores a partir de fixtures locales antes de habilitar herramientas, solicitar aprobación o mostrar un plan de acción en seco.

Entradas Requeridas

• Un fixture de ruta en JSON o YAML simple con los campos request, candidates y opcionalmente expected.
• Opcional: un JSON de políticas con blockedTools, approvalRequiredIntents y dryRunRequiredSideEffects.

Límites de Efectos Secundarios

Los comandos por defecto leen archivos locales y escriben informes solo en stdout. La habilidad no debe llamar a conectores en vivo, leer credenciales, publicar mensajes, actualizar CRMs ni cambiar sistemas externos.

Requisitos de Aprobación

• Las escrituras externas, acciones destructivas, acceso a credenciales e intenciones de escritura de riesgo medio/alto requieren aprobación explícita.
• Las herramientas bloqueadas se reportan como bloqueadas y no deben ejecutarse.
• Las rutas de solo dry-run pueden usarse para preparar un plan, no para realizar la acción.

Ejemplos

connector-route-replay replay fixtures/read-only-route.json --format markdown
connector-route-replay replay fixtures/write-action-route.yaml --format json
connector-route-replay verify fixtures --policy examples/policy.json

Flujo de Validación

Ejecuta estos pasos antes de confiar en la habilidad en otro repositorio:

npm run check
npm test
npm run smoke
npm run package:smoke