brmdias/investigate

조사 워크플로우 스킬

고객 문제에 대한 전체 TAM 조사 프로세스를 자동화합니다.

사용법

/investigate <고객명> <문제 설명>

예시:

• /investigate LSEG "webhook 타임아웃 오류"
• /investigate "Network International" "BeyondTrust 플러그인 인증"
• /investigate Roche "스케줄러가 작업을 트리거하지 않음"

이 스킬이 하는 일

CLAUDE.md에 정의된 전체 조사 워크플로우를 실행합니다:

1. 고객 프로필 찾기 - 고객 환경 세부 정보를 찾아 읽습니다.
2. 지식 베이스 검색 - 유사한 조사 사례와 모범 사례를 찾습니다.
3. 문서 확인 - 해당 동작이 문서화되어 있는지 확인합니다.
4. 코드 확인 - 제품 소스에서 실제 동작을 검색합니다.
5. 외부 트래커 확인 - GitHub 이슈와 Jira에서 알려진 버그/개발 현황을 검색합니다.
6. 테스트 환경 추천 - 문제 유형에 따라 적절한 샌드박스를 제안합니다.
7. 조사 결과 요약 - 참조와 함께 구조화된 요약을 제공합니다.
8. 조사 문서화 - 템플릿을 사용하여 investigations/에 새 조사 파일을 생성합니다.

지침

이 스킬이 호출되면 다음 단계를 따르세요:

1단계: 매개변수 추출

인수에서 다음을 식별합니다:

• 고객명: 고객/회사 이름
• 문제_키워드: 문제를 설명하는 핵심 용어 (오류 메시지, 기능, 구성 요소)

2단계: 고객 프로필 찾기

Grep pattern="<고객명>" path="customers/" output_mode="files_with_matches"

찾은 경우:

• 고객 프로필 파일을 Read 합니다.
• 환경(클라우드/온프레미스), Rundeck 버전, 규모, 과거 문제를 기록합니다.
• 고객 컨텍스트를 저장합니다.

찾지 못한 경우:

• 참고: "고객 프로필을 찾을 수 없음 - 잠재 고객이거나 첫 번째 계약일 수 있습니다."
• 조사를 계속 진행합니다.

3단계: 지식 베이스 검색

유사 조사 사례:

Grep pattern="<문제_키워드>" glob="investigations/**/*.md" output_mode="content" -C 3

관련 모범 사례:

Grep pattern="<문제_키워드>" glob="best-practices/**/*.md" output_mode="content" -C 2

각 결과에 대해:

• 파일 경로, 날짜(조사 파일인 경우 파일명에서), 주요 결과를 기록합니다.
• 정확히 일치하는지 또는 유사한 패턴인지 식별합니다.
• 솔루션이나 해결 방법을 추출합니다.

4단계: 문서 확인

Grep pattern="<문제_키워드>" path="repositories/docs/" output_mode="content" -C 2

다음을 판단합니다:

• 문서화된 동작인가?
• 구성 옵션이나 알려진 제한 사항이 있는가?
• 문서가 고객의 기대와 일치하는가?

5단계: 제품 코드 확인

Grep pattern="<관련_클래스_또는_메서드>" path="repositories/rundeckpro/" output_mode="content" head_limit=50

찾을 내용:

• 실제 구현 동작
• 기본값 또는 상수
• 오류 메시지 출처
• 버전별 로직

6단계: 외부 트래커 확인

GitHub 커뮤니티 이슈 (Runlayer 커넥터 사용):

Runlayer 커넥터를 통해 GitHub를 쿼리합니다. search_tools를 호출하여 GitHub 이슈 검색 도구를 찾은 후, execute_tool을 호출하여 rundeck/rundeck 및 rundeckpro/rundeckpro에서 <문제_키워드>에 대해 열린/닫힌 이슈를 검색합니다 (각각 약 10개로 제한). gh 셸 명령어를 사용하지 마세요.

Jira 개발 추적 (Runlayer 커넥터 사용):

Runlayer 커넥터를 통해 Jira를 쿼리합니다. search_tools를 호출하여 Jira 이슈 검색 도구를 찾은 후, 반환된 정확한 tool_name과 인수를 사용하여 execute_tool을 호출하고, 프로젝트 RUN에서 <문제_키워드>를 업데이트일 기준 내림차순으로 검색합니다 (동등 JQL: project=RUN AND text~"<문제_키워드>" ORDER BY updated DESC). mcp__atlassian__* 도구를 직접 호출하지 마세요.

각 관련 결과에 대해:

• 이슈 번호, 상태, 요약을 기록합니다.
• 특정 버전에서 수정되었는지 확인합니다.
• 언급된 해결 방법이 있는지 기록합니다.

7단계: 테스트 환경 추천

샌드박스 환경을 사용할 수 있는 경우에만 이 단계를 수행합니다. 사용할 수 없는 경우 "사용 가능한 샌드박스 환경 없음 - 빠른 재현을 위해 로컬 WAR 권장"이라고 기록합니다.

문제 특성에 따라 샌드박스를 추천합니다:

결정 로직: 사용 가능한 샌드박스 환경을 분석하고 가장 적절한 것을 제안합니다. 참고: 연결 세부 정보가 필요하면 .claude/memory/sandbox-environments.md를 Read 합니다. 이 스킬 내에서 샌드박스에 연결하지 말고 추천만 제공합니다.

8단계: 구조화된 요약 생성

다음 형식으로 결과를 제공합니다:

# 조사 요약: <고객명> - <문제 설명>

## 고객 컨텍스트
- **프로필:** [찾음/찾지 못함]
- **환경:** [클라우드/온프레미스, 버전, 규모]
- **과거 문제:** [해당 사항이 있는 경우 관련 이력]

## 지식 베이스 결과

### 유사 조사 사례
- [조사-파일.md](경로) - <간략한 요약>
- [상태: 해결됨/해결 방법 있음/진행 중]

### 관련 모범 사례
- [모범-사례-파일.md](경로) - <간략한 요약>

## 문서 상태
- **문서화됨:** [예/아니요/부분]
- **참조:** [파일 경로 및 라인 번호]
- **주요 내용:** [관련 구성, 제한 사항 또는 지침]

## 코드 분석
- **구성 요소:** [클래스/메서드 이름]
- **동작:** [실제 구현 동작]
- **소스:** [파일_경로:라인_번호]

## 외부 트래커 상태

### GitHub 이슈
- rundeck/rundeck#<번호> - <요약> [상태]
- rundeckpro/rundeckpro#<번호> - <요약> [상태]

### Jira 이슈
- RUN-<번호> - <요약> [상태, 수정 버전(해당 시)]

## 권장 테스트 환경
**환경:** [AWS EKS / AWS EC2 / 로컬 WAR / PDT-RDTAM]
**이유:** [데이터베이스 유형 / 문제 특성 / 테스트 요구 사항]
**연결:** .claude/memory/sandbox-environments.md 참조

## 다음 단계
1. [즉시 실행 항목]
2. [테스트 권장 사항]
3. [고객 커뮤니케이션 지침]

## 관련 자료
- 고객 프로필: [경로(있는 경우)]
- 조사 사례: [관련 파일 목록]
- 모범 사례: [해당 가이드 목록]
- 문서: [핵심 문서 페이지]

품질 지침

철저하되 간결하게:

• 모든 검색 결과를 포함하지 말고 관련성 높은 결과를 우선시합니다.
• 모든 참조에 대해 파일 경로를 인용합니다 (예: investigations/2026-03-15-issue.md:45).
• 불명확한 사항은 명확히 표시합니다 (모호한 문장 대신 "유사 사례 없음").

실행 가능한 인사이트 제공:

• 단순히 결과를 나열하지 말고 패턴을 종합합니다.
• 여러 조사에서 동일한 해결책이 나오면 강조합니다.
• 문서와 코드가 충돌하는 경우 명시적으로 표시합니다.

고객 컨텍스트 고려:

• 고객 환경(클라우드 대 온프레미스, 버전)에 맞게 권장 사항을 조정합니다.
• 관련 패턴이 있으면 과거 문제를 참조합니다.
• 테스트 환경 추천을 고객 설정과 일치시킵니다.

오류 처리

고객을 찾을 수 없는 경우:

• 고객 컨텍스트 없이 조사를 계속합니다.
• 참고: "반복 계약인 경우 고객 프로필 생성을 권장합니다."

KB 결과가 없는 경우:

• 더 넓은 검색어를 시도합니다.
• 참고: "새로운 문제 - 해결 후 조사 사례로 문서화하는 것을 고려하세요."

외부 트래커를 사용할 수 없는 경우:

• 도구 실패를 기록합니다.
• 사용 가능한 정보로 계속 진행합니다.
• 수동 확인 제안: "GitHub 검색 실패 - rundeck/rundeck 이슈를 수동으로 확인하세요."

모호한 문제 설명의 경우:

• 사용 가능한 키워드로 최선을 다합니다.
• 참고: "모호한 문제 설명 - 검색 범위: [사용된 용어 목록]"
• 제안: "특정 오류 메시지나 구성 요소 이름으로 검색을 구체화하세요."

9단계: 조사 문서화

조사를 완료하고 요약을 제시한 후, 결과를 문서화하기 위해 새 조사 파일을 생성합니다:

파일 생성:

investigations/YYYY-MM-DD-간단한-케밥-케이스-설명.md

템플릿 사용: 구조는 investigations/TEMPLATE.md를 Read 합니다.

다음 항목 입력:

• 제목: 문제에 대한 간략한 설명
• 날짜: 오늘 날짜 (YYYY-MM-DD 형식)
• 고객: 조사의 고객 이름
• 제품 영역: 관련 구성 요소 (webhooks, jobs, nodes 등)
• 태그: 유사 조사에서 발견된 태그 및 문제별 태그
• 문제 설명: 사용자가 제공한 문제 설명
• 환경 세부 정보: 고객 프로필에서 (찾은 경우)
• 조사 단계: 수행된 검색 단계 요약
• 근본 원인: 조사 중 식별된 경우
• 해결책/해결 방법: KB 또는 문서에서 찾은 경우
• 관련 문서: 검색 중 발견된 참조
• 코드/문서 참조: 검색 결과의 파일 경로 및 라인 번호
• 참고/학습 내용: 조사에서 얻은 패턴이나 인사이트

파일 생성 후:

1. investigations/INDEX.md를 새 항목으로 업데이트:
   • 적절한 카테고리 섹션에 추가
   • 시간순 테이블에 추가
   • "태그로 빠른 검색" 섹션에 태그 추가
   • "마지막 업데이트" 날짜 업데이트

참고 사항

• 조사는 지식 베이스에 영구 기록을 생성합니다.
• 평균 실행 시간: 검색 30-60초 + 문서화 2-3분
• 모든 결과는 연구 결과이며, 실제 테스트는 권장 환경에서 필요합니다.
• 전략적 조언이 필요한 경우 Read .claude/memory/tam-advisory-philosophy.md를 별도로 호출하세요.
• 문서화를 통해 지식이 캡처되어 향후 조사에서 검색 가능합니다.