SKILL.mk — Makefile 형식의 SKILL 문서

이 프로젝트는 Makefile 형식의 SKILL 문서에 대한 명세를 제안합니다. 이러한 문서는 명확한 논리적 연결, 낮은 토큰 소모(온디맨드 로딩), 검증 가능성, 감사 가능성을 제공합니다.

왜 Makefile 형식인가

Makefile 형식의 SKILL 문서는 다음과 같은 장점이 있어 Agent 프레임워크에 통합하기 적합합니다:

내장 논리 DAG: 대부분의 SKILL은 본질적으로 Plan Mode인 논리 DAG를 포함하고 있습니다. 이를 명시적인 DAG로 기술하면 설명의 토큰 비용을 줄일 수 있을 뿐만 아니라 Agent 실행 정확성을 높이고 오류율을 낮출 수 있습니다.
온디맨드 로딩: SKILL.mk의 메타 정보는 키워드 목록을 제공합니다. 각 키워드는 Makefile의 타겟과 직접적으로 대응됩니다. 전용 SKILL.mk 로더 도구를 통해 관련 레시피 컨텍스트만 필요할 때 로드할 수 있습니다. 이는 Agent 실행 시 토큰 비용을 효과적으로 줄입니다.
강력한 검증 가능성: SKILL.mk 자체는 검증 가능하고 실행 가능하며, 감사 기능(깃 추적, 호출 통계 등)도 지원합니다. 개별 레시피를 독립적으로 최적화할 수 있기 때문에 자기 진화에 적합합니다.
쉬운 통합: Makefile은 검증된 형식입니다. Makefile 파싱 도구는 쉽게 구할 수 있으며, 기존 Agent 프레임워크에 손쉽게 통합할 수 있습니다.

여기서는 웹 검색 SKILL을 예시로 두 형식을 비교합니다. 웹 검색은 자주

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.