기능 추적 네비게이터 (사용자 동작 → 호출 그래프 → 코드 워크스루)
UI 또는 API 진입점에서부터 컨트롤러, 서비스, 데이터 계층을 거쳐 호출 그래프와 주석이 달린 워크스루를 생성하여 단일 기능을 추적합니다.
프롬프트 개요
추천 팁
- 실제 실행 경로를 정확히 파악하려면 로그나 테스트 이름을 제공하세요. - 대체 흐름을 포착하기 위해 오류 처리 코드를 포함하세요. - 프로덕션에서 사용되는 짧은 샘플 페이로드를 추가하세요.
운영팀 제공NexusAi Technology해결하는 문제
기능의 전체 경로를 여러 계층에 걸쳐 찾는 것은 오류가 발생하기 쉽습니다. 이 도구는 신뢰할 수 있는 호출 그래프를 생성하고 다음에 조사할 위치를 강조합니다.
엔드 투 엔드 경로 명확성
데이터가 계층을 통해 어떻게 이동하는지 정확히 보여줍니다.
실행 가능한 주석
각 단계에 목적, 입출력, 부작용이 포함됩니다.
테스트 격차 탐지기
경로상의 누락되거나 약한 테스트를 강조합니다.
다음 파일 안내
다음에 읽어야 할 파일과 그 이유를 알려줍니다.
AI 프롬프트 지침
시니어 풀스택 엔지니어이자 코드 지도 제작자 역할을 수행하세요.
이 작업이 중요한 이유:
엔드 투 엔드 추적은 데이터 흐름, 부작용 발생 위치, 유지보수 및 테스트에 중요한 구성 요소를 드러냅니다.
중요한 경계:
- 제공된 라우트, 컨트롤러, 서비스, 모델 코드 조각만 사용하세요.
- 여러 변형이 있을 경우, 프로덕션 경로를 우선시하세요.
사용자 입력:
- 기능 설명 (예: POST /tasks를 통한 “작업 생성”)
- 관련 파일: 라우트 핸들러, 컨트롤러, 서비스, 모델, 미들웨어
- 이 경로를 다루는 로그 또는 테스트 이름
목표:
1) 진입점부터 영속성까지 명확한 호출 그래프 생성
2) 주요 함수에 목적, 입력/출력, 부작용 주석 달기
3) 위험 요소, 누락된 테스트, 관찰성 격차 식별
4) 다음에 읽어야 할 파일 순서 추천
분석 워크플로우:
1) 라우트에서 시작하여 컨트롤러와 서비스 호출 위치 파악
2) 데이터 변환 및 검증 추적
3) 외부 호출(DB, 큐, HTTP) 및 오류 처리 기록
4) 기존 테스트와 교차 검증
5) 성능, 신뢰성, 가독성 문제 요약
필수 출력 형식:
- 복사/붙여넣기 가능한 텍스트 호출 그래프(들여쓰기 목록)
- 단계별 주석: 목적, 매개변수, 출력, 부작용
- 누락된 테스트 및 제안된 테스트 케이스
- 다음에 검토할 5개 파일
품질 관리:
- 정확한 함수 이름과 파일 경로 포함
- 추측과 확실한 부분 구분, 추측은 명확히 표시
검증 체크리스트:
- 모든 계층 포함(라우트 → 컨트롤러 → 서비스 → 모델)
- 외부 통합 식별
최종 지침:
새로운 엔지니어가 버그 수정을 자신 있게 구현할 수 있도록 따라갈 수 있는 추적 결과물을 제공하세요.
예상 결과
호출 그래프: POST /tasks → routes/tasks.js:createTask → controllers/taskController.js:create → services/taskService.js:createTask → models/task.js:Task.create 주석: - createTask (라우트): 바디 스키마 검증; 컨트롤러로 전달 - controller.create: DTO 매핑, try/catch 처리 - service.createTask: 비즈니스 규칙 적용, 제목 중복 제거 - Task.create: 영속화, ID 반환 누락된 테스트: 제목 중복 거부; 잘못된 페이로드 400. 다음 파일: middleware/validateBody.js, services/notifications.js
실행 과정
Codex로 추적 생성하기
Codex를 열고 선택한 기능에 대한 라우트, 컨트롤러, 서비스, 모델 코드 조각을 붙여넣으세요. 이 프롬프트를 사용해 호출 그래프와 주석이 달린 워크스루를 요청하세요. 함수 이름과 경로가 포함된 계층화된 추적 결과를 기대할 수 있습니다.
12 minVS Code에서 호출 검증하기
VS Code에서 각 함수로 이동하여 매개변수, 반환값, 부작용을 확인하세요. 누락된 단계(큐, 캐싱, HTTP 호출)를 추가하거나 수정하세요.
10 min테스트 체크리스트로 변환하기
누락된 테스트 목록을 테스트 러너의 테스트 이름으로 전환하고 플레이스홀더를 만드세요. 추적 결과와 체크리스트를 저장소 문서에 공유하여 다음 PR 작업을 안내하세요.
8 min
