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
- 其他.skill_id43 B
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:
- Iteration Count: The agent reports 0 completed iterations.
- Tool Usage: No tools were invoked during the session.
- Artifacts: No documents, files, or code artifacts were created.
- 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:
- Environment Health: Check if the runtime environment initialized correctly (e.g., dependencies installed, API keys loaded).
- Prompt Parsing: Verify if the initial user instruction was malformed or triggered safety filters immediately.
- Initialization Crash: Look for stack traces or panic logs occurring before the first agent step.
- Resource Limits: Check if memory or quota limits were hit before execution began.
Action Plan
- Tag the Failure: Label the incident as
failure_mode: pre_executionrather thanfailure_mode: agent_logic. - Escalate: Route to infrastructure or platform engineering rather than prompt engineering.
- 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
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.
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.
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.
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.
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.
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.