AGENT SKILL

detect-zero-iteration-failure

Identify and classify agent failures occurring before execution starts

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

01 前言 Front Matter

name
detect-zero-iteration-failure
description
Identify and classify agent failures occurring before execution starts

02 资源文件 1

03 SKILL.md 正文

Detect Zero-Iteration Failure

This skill provides a workflow for identifying and classifying agent failures that occur prior to any task execution.

Identification Criteria

Flag a task execution as a Zero-Iteration Failure if all of the following conditions are met:

  1. Iteration Count: The agent reports 0 completed iterations.
  2. Tool Usage: No tools were invoked during the session.
  3. Artifacts: No documents, files, or code artifacts were created.
  4. Conversation Log: The log ends abruptly or contains only an initial error message without agent reasoning steps.

Diagnosis Strategy

When a Zero-Iteration Failure is detected, do not attempt standard agent-level debugging (e.g., analyzing reasoning chains or tool parameters). Instead, investigate system-level causes:

  1. Environment Health: Check if the runtime environment initialized correctly (e.g., dependencies installed, API keys loaded).
  2. Prompt Parsing: Verify if the initial user instruction was malformed or triggered safety filters immediately.
  3. Initialization Crash: Look for stack traces or panic logs occurring before the first agent step.
  4. Resource Limits: Check if memory or quota limits were hit before execution began.

Action Plan

  1. Tag the Failure: Label the incident as failure_mode: pre_execution rather than failure_mode: agent_logic.
  2. Escalate: Route to infrastructure or platform engineering rather than prompt engineering.
  3. Retry Strategy: If automating retries, reset the environment context before retrying, as the previous context may be poisoned.

Example Indicators

Status: Failed
Iterations: 0
Tools Called: []
Error: "Session initialization failed: Missing environment variable"

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