스킬·MCP·훅·서브에이전트의 책임 구분하기

에이전트가 작업 절차를 빠뜨리는 문제와 외부 자료를 읽을 수 없는 문제는 필요한 해결 방법이 다릅니다. 절차에는 스킬을, 도구와 자료 연결에는 MCP를 검토할 수 있습니다. 반복 처리를 실행할 시점과 별도 작업의 담당 범위도 구분해야 합니다.

Jian Wang의 구성 요소 설명은 스킬, MCP, 훅, 서브에이전트를 지식, 연결, 실행 시점, 작업자의 관점으로 구분합니다. 아래에서는 절차 누락, 자료 접근, 반복 처리, 독립된 조사에 어떤 구성이 필요한지 정리합니다. 이 분류는 설명 틀이며 모든 제품의 고정된 계층 구조는 아닙니다.

구성	주로 정하는 것	예시
스킬	특정 작업의 절차와 참고 자료	코드 리뷰 기준과 검사 순서
MCP	외부 도구와 자료를 사용하는 연결 규격	저장소 이슈를 읽는 도구
훅	정해진 이벤트에서 실행할 처리	파일 편집 뒤 포맷 검사
서브에이전트	별도 실행 단위에 맡길 작업	범위를 정한 코드 조사

필요할 때 읽는 스킬

스킬은 관련 작업에서 읽는 지침과 자료, 스크립트의 묶음입니다. 문서 작성 스킬이라면 구성 순서와 검토 기준을 담을 수 있습니다. 모든 내용을 항상 입력에 넣는 대신 필요한 작업에서 참조하는 방식입니다.

데이터베이스 조회 스킬을 사용하려면 지침 외에 조회 도구와 권한도 필요합니다. 지침에 적힌 작업이 현재 사용자 요청과 허용 범위에 맞는지 확인합니다.

각 기능의 역할을 직접 그린 관계도입니다. 그림에는 작업 절차, 외부 도구 연결, 이벤트 처리와 별도 과제 실행을 구분해 표시했습니다.

도구와 자료를 연결하는 MCP

MCP는 Model Context Protocol의 약자입니다. 공식 명세는 서버가 도구, 자료, 프롬프트를 제공하는 방법을 정의합니다. 어떤 서버를 연결하느냐에 따라 읽을 자료와 실행할 기능이 달라집니다. 스킬에 “저장소 이슈를 읽는다”고 적혀 있어도 실제 도구와 권한이 없으면 해당 절차를 실행할 수 없습니다.

외부 자료를 읽는 도구와 수정하는 도구는 효과가 다릅니다. 연결을 추가할 때는 인증, 제공하는 기능, 필요한 권한을 확인해야 합니다. MCP가 에이전트의 모든 외부 접근을 담당해야 하는 것은 아니며, 제품에 따라 기존 API나 CLI도 사용할 수 있습니다.

이벤트에서 실행하는 훅

훅은 정해진 이벤트에서 프로그램이 실행하는 처리입니다. 모델이 매번 “검사를 실행하자”고 판단하기를 기다리는 대신 특정 시점에 같은 검사를 수행하도록 만들 수 있습니다.

훅을 설정하는 개발자는 결과 처리 방식도 정해야 합니다. 검사가 실패하면 작업을 막을지, 결과만 알려줄지, 어떤 파일을 검사할지 정해야 합니다. 모든 편집 뒤 전체 검사를 실행하면 작은 수정에서도 비용이 커질 수 있습니다. 실행 시점과 검사 범위를 맞춰야 합니다.

별도 과제를 맡는 서브에이전트

서브에이전트는 별도 실행 단위에 작업을 맡기는 방식입니다. 컨텍스트와 사용할 도구, 모델, 권한을 어느 정도 분리할 수 있는지는 제품의 기능에 따라 다릅니다. 이름만 다른 역할을 붙였다고 실행 환경까지 격리되는 것은 아닙니다.

위임할 때는 목표, 담당 범위, 완료 기준, 받을 근거를 정합니다. 메인은 결과를 통합하고 필요한 검증을 수행합니다. 같은 파일을 여러 작업자가 동시에 수정하면 충돌이 생길 수 있고, 원본 근거 없이 요약만 합치면 잘못된 판단이 전달될 수 있습니다.

막힌 지점에 맞는 구성

플러그인은 이런 확장 기능을 묶어 배포할 수 있습니다. 포함된 스킬과 도구, 요구 권한은 플러그인마다 확인해야 합니다.

에이전트가 PR 검토에서 코드 리뷰 순서를 빠뜨린다면 스킬을, 파일 편집 뒤 같은 검사를 반복해서 요청해야 한다면 훅을 검토할 수 있습니다. 에이전트가 이슈를 읽을 수 없다면 도구 연결을 확인하고, 독립된 코드 조사가 남았다면 별도 작업자에게 맡길 수 있습니다.

구성을 추가한 뒤에는 처음 실패한 작업을 같은 조건으로 다시 검사합니다. 절차를 빠뜨렸다면 검사 순서를 지키는지, 이슈를 읽지 못했다면 필요한 자료를 가져오는지 확인합니다. 기능을 연결했다는 사실과 작업이 성공했다는 결과를 구분해야 합니다.