detect-zero-iteration-failure
Identify and classify agent failures occurring before execution starts
- License 许可
- MIT
- 最近更新
- 2026-04-06
- Stars
- ★ 0
- Forks
- 0
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
zip-export-deliverable
Ensures codebase deliverables are properly exported as ZIP archives through a dedicated finalization step
zip-deliverable-finalization
Ensure codebase deliverables are properly packaged as ZIP exports in a dedicated final step
zero-iteration-failure-analysis
Identify and handle agent failures with 0 iterations as pre-execution system issues
write-file-fallback-report
Generate professional documents using write_file when primary data sources fail, leveraging embedded domain knowledge instead of external retrieval
fallback-doc-with-delegation
Generate professional documents after tool failures using shell_agent for complex formats or write_file for simple text/markdown
context-anchored-fallback-report
Generate documents with write_file when retrieval tools fail, with explicit guardrails against task context drift