Error Writer는 잘못된 오류 메시지와 예외 문자열을 최종 사용자, API, 시스템 로그에 최적화된 명확하고 실행 가능한 변형으로 자동 재작성합니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install phy-error-writer
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 phy-error-writer 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Error Writer란 무엇인가요?
Error Writer는 개발자 경험, UX 라이팅, 애플리케이션 로깅을 최적화하기 위해 설계된 Openclaw Skills 생태계의 필수 추가 요소입니다. 이 스킬은 모호하거나 암호 같은 오류 문자열을 매우 명확하고 유익한 메시지로 체계적으로 변환하여 불필요한 지원 티켓과 디버깅 막다른 골목의 주요 원인을 제거합니다. 외부 API 종속성 없이 완전히 작동하며 초기 구성이 필요 없고 코드베이스의 주요 안티 패턴을 즉시 감사할 수 있습니다.
원시 오류 입력, 상수 파일 또는 전체 소스 디렉토리를 처리하여 각 알림을 대상 및 범주 차원에 따라 분석합니다. 그런 다음 입증된 3단계 공식을 사용하여 포괄적인 재작성 보고서를 출력합니다: 정확히 무슨 일이 일어났는지, 왜 일어났는지 설명하고, 다음에 수행할 명확하고 실행 가능한 단계를 제공합니다.
Error Writer 활용 사례
- 레거시 코드베이스 리팩터링: 전체 저장소에서 "Something went wrong"과 같이 오래되고 모호한 오류 메시지를 감사하고 업데이트합니다.
- 개발자 친화적인 API 설계: 엄격한 SCREAMING_SNAKE_CASE 오류 코드를 활용하여 내부 시스템 예외를 구조화되고 안전한 JSON 응답 본문으로 변환합니다.
- 사용자 인터페이스 다듬기: 최종 사용자에게 노출되는 텍스트를 정리하여 유출된 기술적 세부 정보, 내부 파일 경로 또는 무서운 엔지니어링 전문 용어를 제거합니다.
- 시스템 로그 표준화: Ops 및 SRE 경고를 필수 추적 ID, 사용자 컨텍스트 및 디버깅 매개변수를 유지하는 깔끔한 JSON 형식으로 구조화합니다.
Error Writer 작동 원리
- 입력 수집: 개발자가
\/error-writer또는 특정 구문을 통해 스킬을 트리거하고 원시 문자열, 스니펫 파일 또는 로컬 디렉토리 경로를 전달합니다. - 분류: 엔진은 발견된 각 오류 메시지를 대상 사용자(최종 사용자, 개발자, Ops/SRE, 내부 개발자) 및 오류 범주(유효성 검사, 인증, 시간 초과 등)별로 분류합니다.
- 안티 패턴 감사: 메시지에서 유출된 내부 정보, 모호한 의미론, 비난조 언어 또는 복구 경로 누락과 같은 주요 취약점 및 잘못된 스타일을 스캔합니다.
- 3단계 공식 재작성: [무슨 일이 일어났는지] + [왜 일어났는지] + [다음에 할 일]을 요약하는 표준 아키텍처 패턴을 적용하여 컨텍스트별 대안을 생성합니다.
- 다중 채널 전달: 이 스킬은 UI 표시, API 응답 및 서버 로깅 인프라를 위한 별도의 변형을 구성합니다.
- 보고서 및 상수 생성: 구조화된 Markdown 보고서 요약과 함께 바로 사용할 수 있는 상수 파일 및 맞춤형 프로젝트 스타일 가이드를 출력합니다.
Error Writer 설정 가이드
활성 Openclaw Skills 워크플로우 내에서 이 도구를 활용하려면 터미널 환경 또는 채팅 인터페이스에서 지정된 명령 접두사를 사용하십시오:
# 단일 오류 재작성 실행 또는 파일 경로 직접 감사
\/error-writer src\/errors.ts
# 안티 패턴에 대해 전체 프로젝트 저장소 스캔
\/error-writer --audit src\/
# 특정 사용자 기반 세그먼트를 직접 타겟팅
\/error-writer --audience end-user "User not found in database"
Error Writer 데이터 스키마 및 분류 체계
시스템에서 생성된 출력 보고서는 엄격한 분류 및 다중 채널 코드 스키마를 자세히 설명합니다:
보고서 지표 스키마
| 섹션 | 내용 | 목적 |
|---|---|---|
| 감사 요약 | 심각도 수(심각, 높음, 중간)와 관찰된 안티 패턴을 일치시키는 표. | 코드 건강 지표를 한눈에 평가합니다. |
| 재작성 매트릭스 | 레거시 문자열과 최적화된 UI, API, 로그 대안의 나란한 비교. | 즉각적인 텍스트 업그레이드를 제공합니다. |
| 상수 파일 | 구조화된 키-값 맵을 활용하여 생성된 코드베이스 상수 (errors.ts). |
직접 구현을 가속화합니다. |
| 스타일 가이드 | 프로젝트별 형식 규칙(예: 대소문자, 능동태 제약). | 지속적인 팀 정렬을 유지합니다. |
Error Writer 고급 기능
- 자동화된 안티 패턴 스위퍼: 데이터베이스 유출이나 공포를 유발하는 시스템 언어와 같은 고위험 문제를 자동으로 타겟팅하고 플래그를 지정합니다.
- 다중 채널 생성: 단일 입력 문자열을 평가하여 UI 모달, API 응답 페이로드 및 SRE 모니터링 환경을 위한 디커플링된 변형을 동시에 생성합니다.
- 직접 상수 내보내기: 모든 재구조화된 오류를 빠른 구현을 위해 깔끔한 TypeScript/JavaScript 내보내기 가능 객체로 컴파일합니다.
- 프로젝트별 스타일 합성: 코드베이스의 고유한 컨텍스트에서 직접 도출된 맞춤형 오류 메시지 스타일 가이드를 동적으로 작성합니다.
SKILL.md
로드 중
관련 Openclaw 스킬
Prompt Diff
Prompt Diff는 단순한 줄 단위 diff가 아닌 LLM 시스템 Prompt 및 Agent 지침에 대한 풍부한 행동 및 의미론적 변경 로그를 제공합니다.
Pipeline Contract Enforcer
스키마를 검증하고 파이프라인 단계 간의 드리프트를 감지하여 보이지 않는 파이프라인 장애를 방지하는 로컬 환경의 에이전트 네이티브 데이터 계약 집행 도구입니다.
Dotenv Inheritance Mapper
프레임워크의 복잡한 .env 파일 오버라이드 계층 구조를 리졸브하고, 구성 리스크를 플래그하며, 소스 코드 사용 내역과 교차 참조하는 로컬 환경 변수 분석 스킬입니다.
OpenAPI Mock Server
백엔드 코드를 작성하지 않고도 모든 OpenAPI 3.x 또는 Swagger 2.0 사양 파일이나 URL에서 로컬 HTTP Mock Server를 즉시 실행하세요.
Flag Janitor
Flag Janitor는 오래되었거나, 하드코딩되었거나, 정의되지 않은 feature flag를 감지하고 정확한 리팩토링 계획을 생성하여 정리하는 로컬 기반의 프라이버시 우선 기술 부채 분석기입니다.
Schema Sleuth
복잡한 실제 샘플 데이터에서 즉시 깔끔하고 타입 안전한 Pydantic, Zod, TypeScript 및 Go schema를 추론하는 무종속성 개발자 유틸리티입니다.
추천*
