가장 큰 공개 Claude Code 에이전트 컬렉션들을 감사한 결과 — 92.5%가 도구(tools)가 없다고 선언했으며, 두 에이전트는 말
요약
Claude Code 에이전트 컬렉션의 도구 선언 누락과 중복 문제를 감사하는 도구인 'roster'를 소개합니다. 공개 에이전트의 92.5%가 도구 선언이 없어 모델이 기능을 추측해야 하는 비효율성을 지적하며, 이를 해결하기 위한 감사 및 관리 기능을 제공합니다.
핵심 포인트
- 공개 에이전트 컬렉션의 대다수가 도구(tools) 선언을 누락하여 토큰 비용을 낭비함
- 에이전트 간 중복 및 유사도 문제를 감지하는 감사 도구 'roster' 공개
- Claude Code 플러그인 및 독립형 CLI, MCP 서버 형태로 제공
- 중복 호출 시 경고를 보내는 PostToolUse hook 기능 포함
Claude Code에 등록하는 모든 서브에이전트(subagent)는 매 턴마다 그 설명을 컨텍스트(context)에 주입합니다. 저는 이것이 실제로 어떤 비용을 초래하는지 측정하기 위해 작은 CLI를 구축했고, 이를 인기 있는 공개 에이전트 컬렉션들에 적용해 보았습니다. 제가 발견한 놀라운 결과들은 다음과 같습니다:
wshobson/agents (199개 에이전트): 완벽한 1.000 유사도 점수를 가진 한 쌍이 포함되어 있습니다 — 설명은 같고 이름만 두 개입니다. 명단의 92.5%가 도구(tools)가 없다고 선언했습니다 (따라서 모델은 그것들이 무엇을 할 수 있는지 추측해야 합니다). 추정 고정 비용: 턴당 약 14,041 토큰.
agency-agents (255개 에이전트): 유사도 0.879인 두 개의 별도 "Backend Architect" 에이전트가 있습니다. 턴당 약 14k 토큰.
ECC (agents/ 내 67개 에이전트): 도구 선언 누락이 0%입니다 — 규율 있는 명단이 가능하다는 것을 보여주는 반례입니다.
저의 개인적인 설정: 이번 감사 과정에서 제가 33번이나 호출했지만, 이전에는 도구 사용량이 "미사용"으로 집계되었던 에이전트를 발견했습니다 — 이는 버그 수정(plugin-prefixed invocation names가 정규화되지 않았던 문제)으로 이어졌습니다.
이 도구는 Claude Code 플러그인으로 제공됩니다 — /plugin marketplace add sshworld/roster를 실행한 후 /plugin install roster를 하면 /roster-audit, /roster-usage, /roster-cleanup 기술과 함께 에이전트 파일이 변경될 때 재감사를 권장하는 drift hook을 사용할 수 있습니다. 모든 것은 Claude Code 내부에서 실행되며, 별도의 설치는 필요하지 않습니다.
v1.1.0의 새로운 기능: 호출 시점에 경고를 보냅니다 — 명단 내의 형제(sibling)와 중복되는 에이전트나 기술을 호출한 직후에 PostToolUse hook이 실행됩니다 (TF-IDF ≥ 0.7), 세션당 이름별로 한 번 실행됩니다. 따라서 감사 시점이 아니라, 실제로 하나를 사용하는 순간 당신의 배포된 두 에이전트가 거의 중복된다는 사실을 알게 됩니다. 건강한 명단은 조용합니다 — 침묵은 위험한 중복이 없음을 의미합니다.
Claude Code 외부에서 사용하고 싶다면 독립형 무의존성(zero-dep) CLI인 roster-cli 도 있습니다 — roster audit --plugin --enabled-only를 사용하면 당신의 settings.json이 실제로 활성화한 항목만 정확히 감사합니다.
그리고 MCP 서버인 roster mcp도 있습니다. 이를 통해 Cursor/Codex 사용자들도 도구 (tool)로서 이 감사 (audit)를 실행할 수 있습니다. 리포지토리 (Repo): https://github.com/sshworld/roster — 샘플 보고서 (sample report): https://sshworld.github.io/roster/demo/report.html 여러분의 로스터 (roster)가 어떻게 보이는지 궁금하다면, 직접 실행해 보고 가장 심각하게 중복되는 쌍 (overlap pair)을 게시해 주세요. /u/Worldly-Page-4810 제출 [link] [comments]
AI 자동 생성 콘텐츠
본 콘텐츠는 r/ClaudeAI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기