여러 프로그래밍 언어에 걸쳐 린팅, 타입 불일치, 구문 오류를 자동으로 복구하는 지능형 오류 수정 엔진입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install auto-fix
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 auto-fix 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
자동 수정 (Auto-Fix)란 무엇인가요?
Auto-Fix 스킬은 사소한 코드 오류를 수동으로 해결하는 번거로움을 제거하기 위해 설계된 개발자 생산성 도구입니다. Openclaw Skills의 핵심 구성 요소로서, 린팅, 타입 체크 및 테스트 실행 중 발생하는 실패를 모니터링합니다. 휴리스틱 기반의 복구와 업계 표준 CLI 도구를 적용하여 최소한의 수동 개입으로 코드베이스를 깔끔하고 기능적으로 유지합니다.
JavaScript의 엉망인 포맷팅이나 TypeScript의 복잡한 타입 불일치를 처리할 때도 이 스킬은 높은 성공률의 로직을 활용하여 안전하게 수정을 적용합니다. 문제 식별과 해결 사이의 간극을 메워 현대적인 소프트웨어 개발 파이프라인에서 높은 속도를 유지하는 데 필수적인 도구입니다.
자동 수정 (Auto-Fix) 활용 사례
- 파일 저장 시 ESLint 및 Prettier 포맷팅 위반 자동 수정.
- 누락된 속성이나 잘못된 타입 할당과 같은 일반적인 TypeScript 오류 해결.
- 누락된 괄호, 세미콜론 또는 들여쓰기 문제와 같은 손상된 구문 복구.
- CI/CD 또는 로컬 테스트 실행 중 실패한 테스트 스냅샷 업데이트 및 타임아웃 조정.
자동 수정 (Auto-Fix) 작동 원리
- 터미널 출력 및 파일 시스템 변경 사항을 모니터링하여 오류와 경고를 감지합니다.
- 오류 시그니처를 분석하여 Lint, Type, Syntax 또는 Test 카테고리로 분류합니다.
- 감지된 언어 및 환경에 따라 특정 복구 명령(예: npx eslint --fix 또는 ruff --fix)을 실행합니다.
- 진단 도구를 다시 실행하여 수정이 성공했는지 검증 단계를 수행합니다.
- 수정으로 인해 새로운 오류가 발생하면 자동으로 변경 사항을 되돌리고 사용자에게 수동 개입을 알립니다.
자동 수정 (Auto-Fix) 설정 가이드
Openclaw Skills 환경에서 이 스킬을 활용하려면 프로젝트에 필요한 기본 도구가 설치되어 있는지 확인하세요.
# JavaScript/TypeScript 프로젝트의 경우
npm install --save-dev eslint prettier typescript
# Python 프로젝트의 경우
pip install black ruff mypy pytest
스킬 설정 파일에서 auto_trigger: true를 설정하여 자율적인 백그라운드 수정을 활성화하세요.
자동 수정 (Auto-Fix) 데이터 스키마 및 분류 체계
| 카테고리 | 감지된 패턴 | 수정 메커니즘 | 성공률 |
|---|---|---|---|
| 린팅 | ESLint/StyleLint 오류 | CLI 수정 명령 | 90%+ |
| TypeScript | TS2XXX 오류 | 타입 주석/옵셔널 체이닝 | 70% |
| 구문 | 예기치 않은 토큰 | 구조적 재구성 | 85% |
| 테스트 | 어설션 오류 | 스냅샷 업데이트/모킹 수정 | 40% |
자동 수정 (Auto-Fix) 고급 기능
- 커밋되지 않은 작업의 우발적인 손실을 방지하기 위해 Git 상태를 확인하는 스마트 안전 가드.
- JS/TS 에코시스템 및 Python을 포함하는 다국어 지원.
- 자동 수정이 불가능한 복잡한 논리적 실패를 위임하기 위한 systematic-debug와의 통합.
- 회귀가 발생하지 않았는지 확인하기 위해 전체 테스트 도구를 실행하는 수정 후 검증.
SKILL.md
로드 중
관련 Openclaw 스킬
로그 분석기
오류 패턴을 식별하고, 빈도 분포를 계산하며, 시스템 및 애플리케이션 로그에서 실행 가능한 요약을 제공하는 자동화된 로그 파싱 유틸리티입니다.
