rogerchappel/connector-route-replay-skill

Connector Route Replay Skill

사용 시기

에이전트가 도구를 활성화하거나, 승인을 요청하거나, 드라이런 액션 플랜을 보여주기 전에 로컬 픽스처를 사용하여 커넥터 라우팅 동작을 검증해야 할 때 이 스킬을 사용하세요.

필수 입력

• request, candidates, 선택적 expected 필드를 포함하는 JSON 또는 간단한 YAML 라우트 픽스처
• 선택적 정책 JSON: blockedTools, approvalRequiredIntents, dryRunRequiredSideEffects 포함 가능

사이드 이펙트 경계

기본 명령어는 로컬 파일을 읽고 stdout으로만 보고서를 작성합니다. 이 스킬은 라이브 커넥터를 호출하거나, 자격 증명을 읽거나, 메시지를 게시하거나, CRM을 업데이트하거나, 외부 시스템을 변경해서는 안 됩니다.

승인 요구 사항

• 외부 쓰기, 파괴적 작업, 자격 증명 접근, 중간/높은 위험 쓰기 인텐트는 명시적 승인이 필요합니다.
• 차단된 도구는 차단된 것으로 보고되며 실행되지 않아야 합니다.
• 드라이런 전용 라우트는 계획을 준비하는 데 사용될 수 있지만, 실제 작업을 수행하는 데 사용되어서는 안 됩니다.

예시

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

검증 워크플로우

다른 저장소에서 이 스킬을 사용하기 전에 다음을 실행하세요:

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