CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

error-recovery

排查或加固 Agent 故障恢复机制时使用——当 Agent 陷入无限循环、流式响应中途断开、上下文溢出、模型服务限流过载、需要跨厂商接管跑到一半的轨迹、设计重试与熔断策略、防止错误处理路径自身引发连锁故障时使用。覆盖四层故障分类、检测方法、分级恢复策略、熔断上限与流式中断恢复。

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, expert-level instruction skill with a clear tiered recovery workflow, concrete checklists, and validation checkpoints; its main weaknesses are dangling bundle references and dense inline prose that could be split into reference files.

Suggestions

Ship the referenced companion materials inside the bundle (chapter5/provider-failover/, chapter5/log-diagnosis/, chapter5/adaptive-log-parser/, book/chapter5.md, book/chapter1.md) or remove the 配套代码/深度阅读 sections — they currently point to files that do not exist.

Split the dense 核心原则 prose (e.g., cross-vendor takeover, streaming three-breakpoint recovery) into one-level-deep reference files, keeping SKILL.md as a decision-oriented overview with well-signaled links.

Concreteize the qualitative thresholds (e.g., "连续失败若干次就放弃压缩") with example values or a sample error→strategy mapping table entry so the escalation procedure is directly executable.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, operational expertise — fingerprint-based loop detection, retry amplification from background calls, cross-vendor thought signatures, the production-derived 3-failure compression circuit breaker — rather than generic concepts Claude already knows. Minor instances of over-explanation (e.g., the rationale for exponential backoff with jitter, "避免客户端同步重试造成二次拥塞") and some long parenthetical sentences could be trimmed, placing it at the 4 rather than the lean 5 anchor.

4 / 5

Actionability

Concrete, specific guidance throughout: a 6-step "错误 → 策略映射表" decision procedure, implementation checklists ("半截工具调用转文字 + 指纹去重", "拼接后重新解析校验参数"), and real-world anchors (Claude Code's consecutive-failure threshold, Google's thoughtSignature). As an instruction-only skill, the absence of code is not penalized; minor gaps (some thresholds remain qualitative, e.g., "连续失败若干次") keep it below fully executable 5-level guidance.

4 / 5

Workflow Clarity

The recovery flow is a clearly sequenced tiered escalation (静默重试 → 降级与接续 → 暴露给用户) with explicit validation checkpoints (re-parse and validate after splice, fingerprint dedup before continuation, duplicate-fingerprint monitoring after takeover) and checklists for the complex processes. Not 5 because some thresholds are left qualitative and the full procedure requires cross-referencing between 核心原则 and 实践模式 sections — minor validation/sequencing gaps matching the 4 anchor.

4 / 5

Progressive Disclosure

Section structure is good (何时使用 / 核心原则 / 实践模式 / 常见陷阱 / 配套代码 / 深度阅读) and references are clearly signaled one level deep, but the referenced paths ("chapter5/provider-failover/", "book/chapter5.md", "book/chapter1.md") do not exist in the bundle — no references/, scripts/, or assets/ directories are present, so the navigation points to dangling targets. This fits the 3 anchor (structure present, references present but not backed by actual files); it is above 2 because nothing is buried and the overview is well-organized.

3 / 5

Total

15

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit 'what' and 'when' with concrete trigger phrases, natural domain vocabulary, and a well-delineated niche with minimal overlap risk. Only minor room to improve via additional synonyms (timeout, death-loop variants).

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "覆盖四层故障分类、检测方法、分级恢复策略、熔断上限与流式中断恢复" — going well beyond a bare domain statement. It falls short of the 5 anchor because these are topic areas rather than multiple discrete concrete operations, and 'minor gaps in coverage' matches the 4 anchor better.

4 / 5

Completeness

It explicitly answers both what ("排查或加固 Agent 故障恢复机制…覆盖四层故障分类、检测方法、分级恢复策略、熔断上限与流式中断恢复") and when ("当 Agent 陷入无限循环、流式响应中途断开、上下文溢出…时使用" with seven concrete trigger scenarios). This mirrors the 5 anchor's structure of explicit 'what' plus concrete 'Use when…' triggers; it is clearly above the 4 anchor, whose 'when' is present but less specific.

5 / 5

Trigger Term Quality

Good coverage of natural phrases a user would actually say: "无限循环", "流式响应中途断开", "上下文溢出", "限流过载", "重试与熔断策略". A few natural variations are missing (e.g., 超时/timeout, 死循环, token 触顶), which fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — agent failure recovery: circuit breaking, streaming resumption, cross-vendor trajectory takeover, death-spiral prevention — with triggers (无限循环, 熔断, 跨厂商接管) unlikely to fire for unrelated skills. Minimal conflict risk, matching the 5 anchor; not 4 because the trigger set is highly distinctive rather than overlapping with close cousins.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

bojieli/ai-agent-book

Path

skills/error-recovery/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.