Claude가 일부 서브에이전트를 잘 인식하지 못함

작성한 질문수 2

0

안녕하세요! 🙂

결론부터 말씀드리면, @ 입력 후 목록에서 직접 선택하시면 한 번에 잡힙니다.

@ 뒤에 이름만 타이핑해서 보내면 클로드 코드는 이걸 파일 멘션으로 해석해요. 그래서 prd-generator라는 파일을 찾아 헤매다가 결국 클로드가 직접 PRD를 작성해버린 겁니다. 템플릿이 안 지켜진 것도 서브에이전트가 아예 실행되지 않아서예요.

호출은 두 가지 방법이 있어요.

• @ 입력 후 타입어헤드에서 prd-generator (agent) 선택

• 직접 타이핑하실 거면 @agent-prd-generator처럼 agent- 접두사를 붙이기 (타이핑 중에는 파일 목록이 뜨지만 전송하면 에이전트로 인식됩니다) claude

@ 목록에 아예 안 뜬다면 두 가지만 확인해 주세요. 먼저 프론트매터의 name 값이 prd-generator가 맞는지요. 파일명이 아니라 name 값이 식별자입니다. 그리고 .claude/agents/ 폴더를 세션 도중에 처음 만드셨다면 클로드 코드를 완전히 재시작해 주세요. 공식 문서에도 세션 시작 시점에 없던 폴더는 감지되지 않아 재시작이 필요하다고 나와 있어요. (공식 문서) claudeclaude

하나만 더 말씀드리면, 클로드에게 "왜 그랬냐"고 물어서 받은 답변(Bash 경로 해석 실패 → Glob으로 성공)은 그럴듯하게 들리지만 실제 원인이라는 보장이 없어요. LLM은 자기가 왜 그렇게 행동했는지 들여다볼 수 없어서, 질문을 받으면 사후에 말이 되는 설명을 만들어냅니다. 이걸 근거로 디버깅하면 계속 헤매게 돼요. 원인은 문서와 실제 동작으로 확인하시는 게 훨씬 빠릅니다.

감사합니다 🙂

0

안녕하세요, 인프런 AI 인턴입니다. sehage님.

서브에이전트 prd-generator를 만들고 사용할 때 인식 문제가 발생하는 상황을 공유해주셨군요. 해당 문제는 종종 발생할 수 있는 경로 문제일 가능성이 큽니다. 관련해서 몇 가지 확인할 것과 해결 방법을 제안드립니다.

서브에이전트 인식 문제 해결 방법

1. 폴더 경로 확인:

   • .claude/agents/docs/ 경로에 prd-generator.md 파일이 정확하게 위치해 있는지 확인해 주세요. 경로에 오타가 있거나 폴더 구조가 잘못되어 있다면 Claude가 인식하지 못할 수 있습니다.
     

2. 파일 포맷 및 내용 점검:

   • prd-generator.md 파일의 YAML frontmatter가 올바른 형식인지 확인해 보세요. 잘못된 형식의 YAML은 파일을 인식하는데 방해가 될 수 있습니다. 예를 들면, 줄바꿈을 위해 특수 문자는 제거하고 실제 줄바꿈을 삽입하는 것이 도움이 될 수 있습니다.
     

3. 캐시 초기화 및 재시작:

   • Claude를 다시 시작하여 캐시가 초기화되도록 exit 명령어를 사용하고 다시 실행해 보세요.
     

4. CLI의 최신 버전 사용:

   • CLI 환경의 버전이 영향을 미칠 수 있습니다. Claude와 관련 툴들이 최신 버전으로 설치되어 있는지 확인해 주세요.
     

5. 글로벌 환경 설정:

   • CLI에서 절대 경로가 아닌, 상대 경로를 사용하는 것이 권장됩니다. 상대 경로를 통해 프로젝트의 경로 구조와 호환될 수 있도록 설정하세요.
     

위 해결책을 시도해보시고, 문제가 지속된다면 서브에이전트 관련 질문 및 해결 방법 링크도 확인해보시기 바랍니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.