본문으로 건너뛰기
cccskills
무료GitHub에 공개

diagnose-awf

Diagnose an AWF (Agentic Workflow Firewall) failure from an error, workflow run URL, or symptom. Covers auth (api-proxy, enterprise/BYOK Copilot, OIDC, mcpg), ARC/DinD and self-hosted runners, alternative runtimes (gVisor/Kata/chroot), Squid/DNS/egress denials, CI and gh-aw safe-output failures, and suspected security regressions. Routes to the canonical diagnosis registry in docs/diagnostics.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md3.3 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Diagnose AWF Failures

Single entry point for diagnosing AWF failures. The canonical knowledge lives in the diagnosis registry — this skill only routes and reports.

Procedure

  1. Read the index — docs/diagnostics/README.md for boundary routing and specialist references, and docs/diagnostics/agent-playbook.md for the report shape and safety rules.

  2. Fingerprint the run: AWF version, runner type (GitHub-hosted / self-hosted / ARC+DinD / GHES / GHEC), DOCKER_HOST, GITHUB_SERVER_URL, container runtime, provider, auth mode. Use unknown where unverified.

  3. Classify the failing boundary: runner, runtime, network, auth, ci, security.

  4. Load only matching records:

    npx tsx scripts/diagnostics/cli.ts search "<redacted error string>" --boundary <boundary>
    

    Without a clone, use the portable artifact .github/agents/diagnose-awf.md (prefer a tag matching your AWF version).

  5. Probe with the matched finding's read-only probe when the match is ambiguous — one probe at a time.

  6. Report: observed symptom, matched finding ID and evidence, affected version/topology, safe next probe, fix/workaround, citations.

Auth routing

  • api-proxy sidecar / provider token exchange → AUTH-001, AUTH-002
  • GitHub/Copilot enterprise and BYOK routing → AUTH-001, docs/auth-matrix.md
  • gh-aw-launched mcpg HTTP MCP GitHub OIDC → AUTH-003

Check configuration presence/shape, route and health status, and redacted error classes only.

Safety rules

  • Never request API keys, tokens, JWTs, Authorization headers, environment dumps, inference probes, or token exchanges.
  • Never recommend --env-all, disabling isolation, or broadening the domain allowlist by default.
  • Suspected isolation or credential-boundary regressions route to SEC-001 and the repository security review process.
  • If no record matches, say so, name the smallest missing evidence, and stop. Never invent a fix.

Specialist references

  • .github/workflows/shared/self-hosted-failure-modes.md — full runner catalog
  • .github/skills/debug-firewall/SKILL.md — Squid, iptables, container state
  • .github/skills/awf-debug-tools/SKILL.md — log parsing helpers
  • .github/skills/debugging-workflows/SKILL.md — GitHub Actions log retrieval
  • docs/auth-matrix.md, docs/compatibility.md, docs/troubleshooting.md

Updating knowledge

Follow docs/diagnostics/patterns.md. Edit the canonical record, run npm run diagnostics:render, and open a reviewed PR. Never edit generated artifacts or .lock.yml files by hand.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Decide and implement how to support a new LLM provider or agent engine in AWF - either as a proxied provider (api-proxy adapter) or a direct-API engine (domain allowlist only), e.g. Cursor, Aider, or any tool that calls its own endpoint.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

github/gh-aw-firewall1492026년 10월 19일 업데이트

Route gh-aw design, creation, diagnosis, patching, active debugging, and upgrade requests to the right strategies.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

github/gh-aw-firewall1492026년 10월 19일 업데이트

Practical Python scripts for debugging awf - parse logs, diagnose issues, inspect containers, test domains

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

github/gh-aw-firewall1492026년 10월 19일 업데이트

awf-skill

무료

Use the AWF (Agentic Workflow Firewall) to run commands with network isolation and domain whitelisting. Provides L7 HTTP/HTTPS egress control for AI agents.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

github/gh-aw-firewall1492026년 10월 19일 업데이트

Debug the AWF firewall by inspecting Docker containers (awf-squid, awf-agent), analyzing Squid access logs, checking iptables rules, and troubleshooting blocked domains or network issues.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

github/gh-aw-firewall1492026년 10월 19일 업데이트

Debug GitHub Actions workflows by downloading logs, analyzing summaries, and understanding how agentic workflows and the AWF firewall work together.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

github/gh-aw-firewall1492026년 10월 19일 업데이트

github의 스킬 모두 보기

이 스킬의 문제 신고