菜单
버그 원인 추적 및 수정을 위한 메인 + 독립 서브에이전트(Opus) 협업 디버깅. 에러/증상 분석, 재현, 원인 특정, 회귀 디버깅 시 사용.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | agent-debug |
| description | 버그 원인 추적 및 수정을 위한 메인 + 독립 서브에이전트(Opus) 협업 디버깅. 에러/증상 분석, 재현, 원인 특정, 회귀 디버깅 시 사용. |
| disable-model-invocation | false |
| argument-hint | [증상/에러 메시지/재현 방법] |
메인이 증상을 분석하고 원인 가설을 수립한 뒤, 독립 서브에이전트가 실제 코드를 추적하여 가설을 검증합니다. 원인이 확정된 후에만 수정을 진행하며, 수정은 항상 메인이 직접 합니다 (서브에이전트는 분석 전용).
사용자의 버그 리포트를 기반으로 codebase-memory-mcp 그래프 도구를 우선 사용하여 관련 코드를 확인하고 정리합니다.
search_graph로 관련 함수/클래스 탐색, trace_call_path로 콜체인 추적detect_changes로 최근 변경의 영향 범위 분석재현 정보가 부족하면 사용자에게 최소한의 추가 정보만 요청합니다.
증상, 관련 파일, 재현 조건(사실 정보만 — 메인의 원인 추정은 전달하지 않음)을 서브에이전트에게 전달하여 독립적으로 원인을 추적하게 합니다.
단순한 버그(원인이 한 파일 안에서 명확)는 서브에이전트 없이 메인 단독으로 처리해도 됩니다.
메인이 양쪽 분석을 종합하여 원인 후보를 축소합니다.
SendMessage로 같은 에이전트에 가장 효율적인 확인 1개를 요청원인이 충분히 좁혀진 후 메인이 직접 최소 범위로 수정합니다.
/agent-review 적용원인, 수정 내용, 검증 결과, 남은 리스크를 정리하여 보고합니다.
Agent 도구를 사용합니다:
subagent_type: "general-purpose", model: "opus"당신은 DmNote 프로젝트(Tauri + React)의 독립 디버거입니다.
READ-ONLY — 코드를 수정하지 말고 원인 분석만 보고하세요.
작업 디렉토리: (절대 경로). 파일 읽기/검색/빌드/테스트 실행 가능.
버그 증상: (사용자 입력)
관련 정보:
- 기대 동작: ...
- 재현 조건: ...
- 관련 파일/함수: (경로 목록)
- 최근 변경: (관련 커밋/diff 범위)
요청:
- 원인 후보를 독립적으로 도출하고 각각 근거 제시
- 재현 가능하면 최소 절차를 제시하고 직접 검증
- 원인 미확정 시 가장 효율적인 추가 확인 1개 제안
출력 형식 (반드시 준수):
## 원인 후보
1. (후보) - 근거: ... / 검증: ...
## 재현 결과
(재현 시도 내용과 결과)
## 추가 확인 필요
(미확정 시 다음 확인 사항)
재현 절차가 불명확하면 코드 검색과 정적 분석 위주로 조사하도록 지시합니다.
메인 비중을 높이는 경우:
서브에이전트 비중을 높이는 경우:
서브에이전트 결과를 반영할 때 메인이 자체 판단으로 필터링합니다:
(증상, 기대 동작, 재현 가능 여부)
(의심 범위, 초기 가설, 우선 조사 이유)
(확인한 파일/명령, 재현 결과, 가설별 근거, 남은 유력 원인)
(수정 파일, 변경 요지. 미수정 시 사유)
(실행한 검증, 결과)
(회귀 가능성, 추가 확인 포인트)
작업 전 독립 서브에이전트(Opus)와 협업하여 구현 계획을 수립. 작업 계획, 설계 논의, 접근 방식 검토 시 사용.
작업 완료 후 독립 서브에이전트(Opus)를 활용한 적대적 코드 리뷰. 변경사항 리뷰, 코드 품질 검토, 최종 커밋 전 필수 리뷰에 사용.
This skill should be used when the user asks to "explore the codebase", "understand the architecture", "what functions exist", "show me the structure", "how is the code organized", "find functions matching", "search for classes", "list all routes", "show API endpoints", or needs codebase orientation.
This skill should be used when the user asks about "dead code", "find dead code", "detect dead code", "show dead code", "dead code analysis", "unused functions", "find unused functions", "unreachable code", "identify high fan-out functions", "find complex functions", "code quality audit", "find functions nobody calls", "reduce codebase size", "refactor candidates", "cleanup candidates", or needs code quality analysis.
This skill should be used when the user asks about "codebase-memory-mcp tools", "graph query syntax", "Cypher query examples", "edge types", "how to use search_graph", "query_graph examples", or needs reference documentation for the codebase knowledge graph tools.
This skill should be used when the user asks "who calls this function", "what does X call", "trace the call chain", "find callers of", "show dependencies", "what depends on", "trace call path", "find all references to", "impact analysis", or needs to understand function call relationships and dependency chains.