antipattern-catalog
카탈로그 에이전트 프레임워크 안티패턴
에이전트 프레임워크에는 종종 버그와 기술 부채를 발생시키는 숨겨진 아키텍처 문제가 포함되어 있습니다. 이 스킬은 구조, 행동, 관찰 가능성 및 성능 범주에서 문제를 식별, 분류 및 수정하기 위한 안티패턴 카탈로그를 제공합니다.
下載技能 ZIP
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
開啟並開始使用
測試它
正在使用「antipattern-catalog」。 에이전트 프레임워크 설계에서 피해야 할 주요 안티패턴은 무엇입니까?
預期結果:
- 구조적 안티패턴: 깊은 상속(5+ 클래스 수준), 신 클래스(50+ 메서드), 순환 의존성, 누출 추상화, 과도한 추상화
- 행동적 안티패TERN: 숨겨진 상태 변경, 암시적 계약, 자동 실패, 무한 루프 위험, 경쟁 상태
- 관찰 가능성 안티패턴: 숨겨진 LLM 응답, 불투명한 오류, 추적 없음, 컨텍스트 손실, 메트릭 누락
- 성능 안티패턴: Async에서 Sync, N+1 쿼리, 무제한 메모리, 즉시 로딩, 캐싱 없음
正在使用「antipattern-catalog」。 내가 발견한 자동 실패 안티패턴을 문서화하는 데 도움을 주세요
預期結果:
- 패턴: 자동 도구 실패
- 범주: 행동적
- 심각도: Major
- 문제: 예외를 삼키고 null을 반환하는 try/except 블록
- 영향: 오류가 영구적으로 손실되어 디버깅이 불가능해짐
- 수정: 전체 오류 세부 정보를 캡처하고 구조화된 오류 응답 반환
安全審計
安全This is a pure documentation skill containing only a SKILL.md markdown file with 256 lines of anti-pattern catalog guidance. No executable code, scripts, network calls, file system operations, or environment variable access exists. All static findings are false positives triggered by documentation patterns (code examples showing anti-patterns, markdown syntax, and severity level terminology that the scanner misinterpreted as security-related keywords).
風險因素
🌐 網路存取 (2)
📁 檔案系統存取 (1)
⚙️ 外部命令 (24)
品質評分
你能建構什麼
코드베이스 감사
기존 에이전트 프레임워크를 검토하고 분석 중 발견된 안티패턴을 문서화합니다
설계 검토
새로운 에이전트 시스템을 구현하기 전에 잠재적 아키텍처 문제를 식별합니다
안티패턴 학습
에이전트 프레임워크 설계의 일반적인 실수를 배우고 반복하지 않도록 합니다
試試這些提示
카탈로그의 안티패턴 주요 범주를 나열하세요
안티패턴의 심각도 수준을 어떻게 평가합니까?
내가 관찰한 새로운 안티패턴에 대한 카탈로그 항목을 작성하세요: [패턴 설명]
안티패턴 카탈로그를 기반으로 Do Not Repeat 체크리스트를 작성하세요
最佳實務
- 깊은 상속 계층 구조보다 구성을 선호합니다(최대 3단계)
- 항상 토큰 수 및 모델 메타데이터와 함께 원시 LLM 응답을 노출합니다
- 예외를 절대 삼키지 않습니다; 항상 컨텍스트와 트레이스백과 함께 오류를 로깅합니다
避免
- 빈 except 블록으로 예외 삼키기(오류를 영구적으로 숨김)
- 깊은 상속 체인(6+ 수준에서 코드 흐름 추적이 불가능함)
- null을 반환하는 대신 오류 세부 정보를 전파하지 않는 자동 도구 실패