Exec Error Doctor

核心功能：针对OpenClaw、shell、GitHub CLI等工具的执行错误，分类根因并提供针对性修复方案，配套安全脚本辅助重试。典型场景：命令返回非零、JSON字段不匹配、权限/认证错误、超时等执行失败时使用。输入可为错误文本或文件，运行分类脚本获取诊断结果，按指引或调用安全脚本解决问题，无需随机重试。

bluebirdback

热度 26.76

最近更新 2026-05-11 17:25:56

分类：开发依赖：代码执行 / 读写文件 / 第三方 API应用场景：调试排错 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add exec-error-doctor

Metadata

name: exec-error-doctor
description: Diagnose and mitigate exec-related command failures across tools (OpenClaw exec output, shell errors, GitHub CLI, ClawHub CLI, missing binaries, auth failures, JSON field mismatch, permission errors, timeouts, and transient platform states). Use when a command returns non-zero, signal kill, ENOENT, unknown JSON field, or similar execution failures and you need fast triage + concrete next fixes.

Exec Error Doctor

Triage execution failures quickly, classify root cause, and apply targeted fixes instead of random retries.

Quick workflow

Run triage on raw error text:
- scripts/exec_error_triage.sh <error_text_or_file>
Apply the category fix from references/error-taxonomy.md.
Re-run with safer wrappers when relevant:
- GitHub CLI search schema drift: scripts/gh_search_repos_safe.sh
- ClawHub publish visibility lag: scripts/clawhub_publish_safe.sh
Confirm with one clean re-run and capture outcome.

Standard commands

Generic triage

bash scripts/exec_error_triage.sh "Unknown JSON field: nameWithOwner"

Safe GitHub repo search (schema-aware)

bash scripts/gh_search_repos_safe.sh "safe-exec skill" 15

Safe ClawHub publish (retry-aware inspect)

bash scripts/clawhub_publish_safe.sh ./my-skill my-skill "My Skill" 1.0.0 "Initial release"

Rules

Prefer classification before fixes.
Treat Skill not found right after publish as potentially transient if publish already returned OK.
For gh search repos --json, prefer fullName (not nameWithOwner).
Distinguish transient errors (retry/backoff) from hard errors (auth, permission, invalid args).

Resources

references/error-taxonomy.md: category→fix map.
scripts/exec_error_triage.sh: pattern-based classifier.
scripts/gh_search_repos_safe.sh: resilient GitHub search wrapper.
scripts/clawhub_publish_safe.sh: publish + retry verification wrapper.