AGENT SKILL

cascade-fail-recovery

Handle cascading data retrieval tool failures by falling back to embedded knowledge generation

License 许可
MIT
所属仓库
HKUDS/AgentPilot
最近更新
2026-11-12
Stars
★ 8.0k
Forks
944

01 前言 Front Matter

name
cascade-fail-recovery
description
Handle cascading data retrieval tool failures by falling back to embedded knowledge generation

02 资源文件 1

03 SKILL.md 正文

Cascade Failure Recovery

Purpose

When multiple data retrieval tools (read_webpage, search_web) fail in succession, immediately fall back to generating content from embedded knowledge rather than attempting repairs or abandoning the task. This preserves task context and ensures completion.

When to Apply

Use this pattern when you observe:

  • 2+ consecutive failures from data retrieval tools
  • Network/access errors preventing web content retrieval
  • Risk of task abandonment due to tool errors

Recovery Procedure

Step 1: Recognize Cascading Failure

Identify the failure pattern:

Iteration N: read_webpage failed - connection error
Iteration N+1: search_web failed - timeout/unavailable
Iteration N+2: [risk] Agent may abandon task or switch objectives

Step 2: Preserve Task Context

Before switching strategies, explicitly restate the original objective:

ORIGINAL OBJECTIVE: [Restate the core task goal]
CONTEXT PRESERVED: [Key requirements, constraints, deliverables]

Step 3: Invoke Fallback Strategy

Immediately switch to embedded knowledge generation:

  1. Acknowledge the limitation: Note that external data sources are unavailable
  2. Activate internal knowledge: Use pre-trained knowledge relevant to the task
  3. Generate content: Use write_file to create the deliverable from available knowledge
  4. Document the fallback: Note in the output what information could not be verified externally

Step 4: Execute write_file

Generate the required document:

# Fallback to generating from embedded knowledge
write_file(
    path="output/document.md",
    content="[Generate content from internal knowledge base]"
)

Example Application

Scenario: PACT Act veterans benefits document needed, but web access failing

Wrong approach (observed failure):

Iter 11: read_webpage failed - access error
Iter 12: search_web failed - unavailable
Iter 13: [ABANDONED] Switched to unrelated musician payroll task

Correct approach (with this skill):

Iter 11: read_webpage failed - access error
Iter 12: search_web failed - unavailable
Iter 13: CASCADE FAIL DETECTED - invoking fallback
Iter 14: write_file - generate PACT Act document from embedded knowledge
      - Note: "External verification unavailable; content based on training knowledge"

Guidelines

  1. Threshold: Trigger fallback after 2 consecutive retrieval failures
  2. No endless retries: Do not attempt more than 1 repair/retry cycle
  3. Preserve objective: Never switch to unrelated tasks when tools fail
  4. Transparency: Clearly mark any content that lacks external verification
  5. Document limitations: Note what could not be verified due to tool failures

Related Skills

  • write-file-fallback: Generate documents when data sources unavailable
  • task-context-preservation: Maintain objective continuity through errors

04 同仓库更多 Skills

HKUDS
HKUDS/AgentPilot

agentpilot

Set up AgentPilot and use its single entry to prepare missing inputs and run configured RSI experiments. Use when the user requests AgentPilot installation or work with AgentPilot.

★ 8.0k
HKUDS
HKUDS/AgentPilot

remember

Review auto-memory entries and propose promotions to OPENSPACE.md, OPENSPACE.local.md, or retained auto-memory topics; detect duplicates, stale facts, conflicts, and ambiguous entries before making changes.

★ 8.0k
HKUDS
HKUDS/AgentPilot

skill-discovery

Search reusable OpenSpace skills locally, and browse cloud packages step by step when a cloud skill may help. Reusing proven skills saves tokens, improves reliability, and extends your capabilities beyond built-in tools.

Skill与智能体开发
★ 8.0k
HKUDS
HKUDS/AgentPilot

delegate-task

Delegate tasks to OpenSpace — a full-stack autonomous worker for coding, DevOps, web research, and desktop automation, backed by an extensive MCP tool and skill library. Skills auto-improve through use, reducing token consumption over time. A cloud community lets agents share and collectively evolve reusable skills.

Skill与智能体开发
★ 8.0k
HKUDS
HKUDS/AgentPilot

write-special-chars-ts-check

Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.

★ 8.0k
HKUDS
HKUDS/AgentPilot

write-special-chars-readback

Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of /tmp helper scripts.

★ 8.0k