rogerchappel/connector-route-replay-skill

Skill de Reprodução de Rotas de Conector

Quando Usar

Use esta skill quando um agente precisar validar o comportamento de roteamento de conectores a partir de fixtures locais antes de habilitar ferramentas, solicitar aprovação ou exibir um plano de ação em modo dry-run.

Entradas Necessárias

• Uma fixture de rota em JSON ou YAML simples com os campos request, candidates e, opcionalmente, expected.
• Opcionalmente, uma política JSON com os campos blockedTools, approvalRequiredIntents e dryRunRequiredSideEffects.

Limites de Efeitos Colaterais

Os comandos padrão leem arquivos locais e escrevem relatórios apenas no stdout. A skill não deve chamar conectores ativos, ler credenciais, postar mensagens, atualizar CRMs ou alterar sistemas externos.

Requisitos de Aprovação

• Escritas externas, ações destrutivas, acesso a credenciais e intenções de escrita de risco médio/alto exigem aprovação explícita.
• Ferramentas bloqueadas são relatadas como bloqueadas e não devem ser executadas.
• Rotas exclusivas de dry-run podem ser usadas para preparar um plano, mas não para executar a ação.

Exemplos

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

Fluxo de Validação

Execute estes comandos antes de confiar na skill em outro repositório:

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