CD
c92433b0b1
- tools/anissia_client.py: Anissia API 클라이언트 (편성표/자막) - tools/nyaa_client.py: Nyaa.si RSS 토렌트 검색 - tools/qbit_client.py: qBittorrent Web API 클라이언트 - tools/subtitle_downloader.py: Google Drive/Tistory/Naver 자막 파서 - tools/title_matcher.py: 제목 매칭 + NAS 폴더명 생성 - tools/anime_pipeline.py: 전체 파이프라인 오케스트레이터 - tools/nas_scanner.py: NAS 폴더/파일 스캔 - prompts/unified.md: anime 모드 추가 (AI 평문 의도 분류) - api/discord_bot.py: AI 평문 anime 핸들러 + /anime 슬래시 커맨드 - config.py: qBittorrent/NAS 설정 추가 - .agents/: agent_guide 워크플로우 통합 - docs/devlog: 세션 기록
53 lines
1.8 KiB
Markdown
53 lines
1.8 KiB
Markdown
---
|
|
description: 에러/버그 발생 시 체계적 디버깅 워크플로우 (에러, 안돼요, 왜 안돼, 버그, 디버그, 수정)
|
|
---
|
|
|
|
# Debug Workflow
|
|
|
|
> [!IMPORTANT]
|
|
> 추측으로 코드를 수정하지 마세요. 반드시 이 순서를 따릅니다.
|
|
|
|
## 1단계: 정보 수집 (추측 금지)
|
|
|
|
- [ ] 에러 메시지 **전문** 확인 (절대 잘라내지 않기)
|
|
- [ ] 관련 로그 파일 확인
|
|
- [ ] 환경 정보 확인 (OS, Node/Python 버전, 의존성 버전 등)
|
|
- [ ] 에러가 발생하는 **정확한 입력/조건** 파악
|
|
|
|
## 2단계: Known Issues 확인
|
|
|
|
`.agents/references/known-issues.md`를 읽고 동일하거나 유사한 문제가 있는지 확인합니다.
|
|
|
|
> [!CAUTION]
|
|
> **known-issues 확인 없이 해결 시도를 시작하지 마세요.**
|
|
> 이미 해결된 문제를 다시 삽질하는 것은 시간 낭비입니다.
|
|
|
|
## 3단계: 근본 원인 분석
|
|
|
|
- [ ] 에러가 발생하는 **정확한 코드 위치** 확인
|
|
- [ ] 가설을 세우고, 가설을 검증할 수 있는 **최소한의 테스트** 수행
|
|
- [ ] 가설이 틀렸다면 **즉시 다른 가설로 전환**
|
|
|
|
> [!WARNING]
|
|
> **동일한 접근을 2회 초과 시도하지 마세요.**
|
|
> 2회 실패 시 유저에게 보고하고 판단을 요청합니다.
|
|
> 보고 내용: 시도한 것 / 실패한 것 / 원인 가설 / 다음 제안
|
|
|
|
## 4단계: 수정 및 검증
|
|
|
|
- [ ] 수정 적용
|
|
- [ ] 동일 에러가 재현되지 않는지 확인
|
|
- [ ] 사이드 이펙트(다른 기능에 영향) 없는지 확인
|
|
|
|
## 5단계: 기록
|
|
|
|
- [ ] `known-issues.md`에 새 항목 추가 (아래 포맷 사용)
|
|
|
|
```markdown
|
|
### [날짜] [키워드] — 한줄 요약
|
|
- **증상**: 무엇이 잘못되었는가
|
|
- **원인**: 근본 원인
|
|
- **해결**: 올바른 해결 방법
|
|
- **주의**: 재발 방지를 위한 교훈
|
|
```
|