구조화된 성찰과 포괄적인 보고를 통해 AI 에이전트가 bug 수정을 분석, 검증 및 문서화할 수 있는 전문 프레임워크입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install bug-reflection
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 bug-reflection 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Bug Reflection & Fix Report란 무엇인가요?
Bug Reflection 기능은 Openclaw Skills를 위해 설계된 강력한 프로토콜로, 주먹구구식 디버깅을 규율 있는 엔지니어링 프로세스로 전환합니다. 에이전트가 패치를 적용하기 전에 근본 원인을 파악해야 하는 심층 분석 단계를 의무화하여, 수정이 추측이 아닌 기술적 사실에 기반하도록 보장합니다.
공식 문서 교차 참조 및 엄격한 성능 감사를 통합함으로써 이 기능은 회귀 및 기술 부채를 방지합니다. 버그의 전체 라이프사이클을 캡처하는 구조화된 Fix Report로 마무리되어 개발 팀의 장기 지식 베이스 역할을 합니다.
Bug Reflection & Fix Report 활용 사례
- 사용자가 애플리케이션에서 버그나 예기치 않은 동작을 보고할 때.
- 중대한 시스템 장애의 사후 분석(post-mortem) 중.
- 제안된 코드 변경 사항이 공식 API 사양을 준수하는지 확인할 때.
- 메모리 누수나 높은 복잡도 로직과 같은 성능 병목 현상을 식별할 때.
Bug Reflection & Fix Report 작동 원리
- 정보 수집: 에이전트는 버그 보고 즉시 오류 로그, 재현 단계 및 스크린샷을 수집합니다.
- 모듈 추론: 즉시 패치를 수행하는 대신, 에이전트는 콜 스택과 오류 메시지를 분석하여 정확한 실패 모듈을 찾아냅니다.
- 검증: 에이전트는 현재 구현을 공식 문서와 교차 참조하고 성능 감사(복잡도 및 메모리)를 수행합니다.
- 사용자 소통: 버그가 발견되지 않으면 에이전트는 문서를 바탕으로 상세한 근거를 제공하고 대안을 제시합니다.
- 문서화: 성공적으로 수정되면 에이전트는 근본 원인 분석과 실패한 시도를 포함한 포괄적인 Fix Report를 생성합니다.
Bug Reflection & Fix Report 설정 가이드
Openclaw Skills 환경 내에서 이 프로토콜을 활성화하려면 에이전트의 스킬 디렉토리에 bug-reflection 정의를 추가하세요.
# 수동 또는 자동 워크플로우를 통해 스킬을 트리거하는 예시
openclaw-agent run bug-reflection --issue-id "BUG-123"
Bug Reflection & Fix Report 데이터 스키마 및 분류 체계
이 기능은 향후 에이전트 성능을 향상시키기 위해 수정 및 검증의 구조화된 이력을 유지합니다.
| 데이터 포인트 | 형식 | 설명 |
|---|---|---|
| Bug Description | String | 문제의 상세한 발현 현상 |
| Root Cause | String | 실패에 대한 근본적인 기술적 이유 |
| Attempt Log | Array | 성공 및 실패한 솔루션 시도 목록 |
| Checklist Status | Boolean Map | 문서, 모듈 및 성능 확인 상태 |
| Lessons Learned | String | Openclaw Skills 데이터베이스를 위해 추출된 지식 |
Bug Reflection & Fix Report 고급 기능
- No-Patch 정책: 검증된 근본 원인 분석 없이 "임시방편" 수정을 적용하는 것을 엄격히 금지합니다.
- 문서 일치: 공식 라이브러리 사양에 대한 자동 검증을 통해 논리 및 구문 정확성을 보장합니다.
- 성능 가드레일: 수정 검증 단계에서 시간/공간 복잡도 및 무한 루프에 대한 통합 점검을 수행합니다.
- 지식 재순환: 과거의 실수가 재발하지 않도록 이전 Fix Report를 참조로 사용합니다.
SKILL.md
로드 중
관련 Openclaw 스킬
Solidot Push
Solidot 기사를 스크랩하여 Feishu 문서나 로컬 markdown 파일로 푸시하는 자동화된 뉴스 애그리게이터입니다.
Helius Wallet API Skill
Helius API를 통해 고정밀, 읽기 전용 Solana 지갑 인텔리전스 작업을 수행하기 위한 전문 Openclaw Skills 통합입니다.
Brawl Stars Skill
Brawl Stars 게임 업데이트, 이벤트 세부 정보 및 커뮤니티 가이드라인을 안전하고 효율적으로 추적, 스크래핑 및 구성하도록 설계된 자동화 스킬입니다.
Eggy Party 자동화 스킬
게임 업데이트, 이벤트 보상 및 공식 커뮤니티 가이드를 추적하는 Eggy Party용 자동 데이터 추출 도구입니다.
Max
Max 비디오 플랫폼의 공개 멤버십 상세 정보, 콘텐츠 채널 항목 및 크리에이터 가이드를 정리하기 위한 전문 데이터 추출 스킬입니다.
추천*
