A professional framework for AI agents to analyze, verify, and document bug fixes through structured reflection and comprehensive reporting.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install bug-reflection
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install bug-reflection using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Bug Reflection & Fix Report?
The Bug Reflection skill is a robust protocol designed for Openclaw Skills to transform haphazard debugging into a disciplined engineering process. It mandates a deep-dive analysis phase where agents must identify root causes before applying any patches, ensuring that fixes are based on technical truth rather than guesswork.
By integrating official documentation cross-referencing and rigorous performance audits, this skill prevents regressions and technical debt. It concludes with a structured Fix Report that captures the entire lifecycle of a bug, serving as a long-term knowledge base for the development team.
Bug Reflection & Fix Report Use Cases
- When a user reports a bug or unexpected behavior in an application.
- During post-mortem analysis of critical system failures.
- When verifying if a proposed code change adheres to official API specifications.
- Identifying performance bottlenecks like memory leaks or high complexity logic.
How Bug Reflection & Fix Report Works
- Information Collection: The agent gathers error logs, reproduction steps, and screenshots immediately upon a bug report.
- Module Inference: Instead of immediate patching, the agent analyzes call stacks and error messages to pinpoint the exact failing module.
- Validation: The agent cross-references the current implementation against official documentation and performs a performance audit (complexity and memory).
- User Communication: If no bug is found, the agent provides a detailed justification based on documentation and offers alternatives.
- Documentation: Upon a successful fix, the agent generates a comprehensive Fix Report including root cause analysis and failed attempts.
Bug Reflection & Fix Report Setup
To enable this protocol within your Openclaw Skills environment, add the bug-reflection definition to your agent's skill directory.
# Example of triggering the skill manually or via automated workflow
openclaw-agent run bug-reflection --issue-id "BUG-123"
Bug Reflection & Fix Report Data Schema & Taxonomy
The skill maintains a structured history of fixes and validations to improve future agent performance.
| Data Point | Format | Description |
|---|---|---|
| Bug Description | String | Detailed manifestation of the issue |
| Root Cause | String | The fundamental technical reason for the failure |
| Attempt Log | Array | List of successful and failed solution attempts |
| Checklist Status | Boolean Map | Verification of docs, modules, and performance |
| Lessons Learned | String | Knowledge extracted for the Openclaw Skills database |
Bug Reflection & Fix Report Advanced Features
- No-Patch Policy: Strictly forbids applying "band-aid" fixes without a verified root cause analysis.
- Documentation Alignment: Automatic validation against official library specs to ensure logical and syntax accuracy.
- Performance Guardrails: Integrated checks for time/space complexity and infinite loops during the fix verification stage.
- Knowledge Recirculation: Uses historical Fix Reports as a reference to prevent the recurrence of past mistakes.
SKILL.md
Loading
Related Openclaw Skills
Solidot Push
An automated news aggregator that scrapes Solidot articles and pushes them to Feishu docs or local markdown files.
Web Crawl
An advanced web content extraction tool designed for systematic site analysis and multi-mode data harvesting.
docx-output
A professional-grade document engine that converts AI-generated content into strictly formatted .docx files following Chinese national and industry standards.
Helius Wallet API Skill
A specialized Openclaw Skills integration for performing high-fidelity, read-only Solana wallet intelligence operations via the Helius API.
Brawl Stars Skill
An automation skill designed to track, scrape, and organize Brawl Stars game updates, event details, and community guidelines safely and efficiently.
Eggy Party Automation Skill
An automated data extraction tool for Eggy Party that tracks game updates, event rewards, and official community guidelines.
Featured*
