구글이 밝힌 새 구조 — "필요할 때만 펼치는 매뉴얼"
2026년 8월 1일 구글 개발자 블로그는 Genkit Go에 Agent Skills 기능을 추가했다고 알렸어요. 핵심은 프로그레시브 디스클로저(progressive disclosure) 구조예요. 지침, 스크립트, 참고 자료를 SKILL.md라는 묶음 파일로 만들어 두고, 평소에는 제목과 설명 같은 맨 앞머리 정보만 에이전트의 시스템 프롬프트에 노출시켜요. 작업 내용이 특정 스킬의 설명과 맞아떨어질 때만 Genkit의 미들웨어가 나머지 내용을 불러와 실제로 반영하는 방식이죠. 매뉴얼 전체를 책장에 꽂아두고, 필요한 장만 그때그때 펼쳐서 읽는 셈이에요. 이 소식은 개발자를 대상으로 한 기술 안내지만, 그 안에 담긴 발상은 일반 사용자가 AI를 쓰는 방식과도 맞닿아 있어요.
왜 통째로 안 읽고 나눠 읽을까
이유는 단순해요. 매뉴얼 전체를 매번 다 읽으면 처리해야 할 글자 수, 즉 토큰이 늘어나고 응답 속도도 느려져요. 구글은 이 구조를 도입한 배경으로 컨텍스트 창이 불필요하게 부풀어 오르는 문제와 토큰 소비를 줄이려는 목적을 들었어요. 예를 들어 계약서 검토용 지침과 이메일 작성용 지침, 코드 리뷰용 지침을 한꺼번에 다 들고 있을 필요는 없죠. 지금 하는 작업에 맞는 것만 그때그때 꺼내 쓰면 충분해요. 사람도 회의에 들어갈 때 관련 자료만 챙기지, 사무실 캐비닛 전체를 들고 가지는 않잖아요. 같은 원리예요. 여러 지침 묶음을 한 도구 안에 등록해 두고 상황별로 쓰는 흐름은 앞으로 다른 서비스에서도 늘어날 가능성이 커요.
개발자 쪽 반론 — "알아서 잘 고르니 신경 끄라"
이 지점에서 반론이 나올 법해요. 자동으로 판단해서 필요한 부분만 불러오는 구조 자체가 이미 시간과 비용을 아껴주는 개선이니, 사용자가 내부에서 어떤 지침이 골라졌는지까지 신경 쓸 이유는 없다는 주장이죠. 실제로 이런 판단은 대체로 무난하게 작동하고, 매번 사람이 개입해서 확인해야 한다면 자동화의 의미가 줄어들긴 해요. 개발자 입장에서는 사용자에게 내부 과정을 일일이 공개하는 대신, 판단 로직 자체를 개선하는 데 공을 들이는 편이 더 실용적이라고 볼 수도 있어요. 속도와 비용 절감이라는 목표만 놓고 보면 이 주장은 꽤 설득력이 있어요.
그런데 무엇이 반영됐는지는 안 보여요
문제는 다른 데 있어요. 스킬이 호출됐는지, 어떤 지침이 실제로 결과에 녹아들었는지는 겉으로 드러나지 않아요. 시스템 프롬프트에는 제목과 설명 정도만 남아 있고, 본문 지침이 언제 불려 왔는지는 사용자 화면에 표시되지 않으니까요. 도구가 판단을 잘못했거나 설명과 작업이 미묘하게 어긋나면, 원하는 지침 없이 결과물이 나올 수도 있어요. 이건 도구 잘못이라기보다 구조상 자연스럽게 생기는 빈틈이에요. 속도를 얻은 대신 과정의 투명성 일부를 내준 셈이죠. 특히 여러 지침 묶음을 동시에 등록해 둔 경우, 어느 것이 실제로 뽑혀 쓰였는지는 결과물을 뜯어봐야만 알 수 있어요.
결과물에서 직접 확인하는 습관
그래서 확인은 사용자 몫으로 남아요. 결과물을 받으면 원래 기대했던 지침, 형식, 제약이 실제로 지켜졌는지 하나씩 대조해 보는 습관이 필요해요. 가령 특정 톤이나 분량 규칙, 인용 방식을 요구했다면, 결과물에서 그 규칙이 실제로 지켜졌는지 눈으로 짚어보는 거죠. 스킬 이름을 언급했는데도 결과물에 그 흔적이 안 보인다면, 요청 문장을 더 구체적으로 바꿔볼 필요가 있어요. 무료 범위에서 쓸 수 있는 도구들은 대체로 이런 내부 호출 과정을 사용자에게 상세히 보여주지 않아요. 로그나 디버그 화면을 따로 제공하지 않는 경우가 많죠. 그러니 결과물 자체를 검토 기준으로 삼는 편이 현실적이에요. 완벽한 자동 판단을 기대하기보다, 매번 결과를 짧게라도 점검하는 쪽이 낫죠. 이런 점검이 몇 번 쌓이면 어떤 요청 방식이 원하는 지침을 잘 불러오는지 감이 잡히고, 다음번 요청은 더 정확해져요.
참고 자료
- Enable on-demand expertise with Agent Skills in Genkit Go — developers.googleblog.com, 2026-08-01 발행
본문 집필에 참고한 공개 자료입니다. 접속 확인일: 2026-08-01.
