跳到正文
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(原文)

安装前可以查看交给 AI 代理的指令内容。

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 / 1000 字

此表单受 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 的全部技能

报告此技能的问题