LLM과 신규 개발자를 생각한 Agent Skills,
업무 번거로움 해결하고 효율성은 높이고
이메일에 기록된 일정과 정보를 캘린더에 등록하고, 운동 루틴과 식단을 계획하며, 생활 속 문제를 해결하고…. AI가 일상화된 시대, 업무 환경에서도 AI는 빼놓을 수 없다. 삶의 질을 증폭시키는 AI는 빠르게 우리 일상으로 들어왔으니까. 데일리펀딩 IT실도 당연히 AI 활용의 공감대를 바탕으로 적용 영역을 확대해 왔다.
대부분은 ‘이런 게 있으면 정말 좋을 텐데….’ 하는 고민에서 출발한다. AI와 함께 일해 본 개발자라면 공감할 만한 이야기인데, 세션이 새로 만들어질 때마다 AI 에이전트(LLM)에게 항상 반복되는 내용을 알려 줘야 하고 비슷한 실수를 거듭하는 AI에 신경 쓰여 에너지와 시간, 토큰 비용을 빼앗기곤 한다. 이로 인해 AI에게 일을 맡겨 놓고도 다른 업무를 하기 힘들다.
혼자만 그런 줄 알고 약간의 스트레스를 견디던 중, 동료 개발자와 대화 나누다 알게 됐다. 나만 그런 게 아니라 다들 비슷한 상황을 겪고 있었다는 것을. 동료들의 공감대는 Agent Skills을 적용해 업무 효율성을 한 단계 강화하자는 결정에 힘을 실어 주었다.
Agent Skills은 LLM에게 업무하는 방법을 가르치는 가이드 문서로, 프로젝트 소개와 개발 규칙 등의 내용을 포함한다. 세션마다 똑같이 적용되는 개발 내용을 문서로 정리하고 소스 코드에 문서 파일을 업로드해 두면, 어떤 요청을 받을 때마다 AI가 자동으로 읽고 처리한다. 신규 입사자 온보딩 프로그램의 내용과 비슷한 내용이라 LLM과 신규 개발자 가이드용 문서로 작성했다.
레거시 호환성, 시스템 안정성 고려한 가이드 작성
LLM과 같이 대화하며 내용 보완해 나가기도
우선 스킬은 프로젝트 구조와 코딩 가이드라인, 환경 구성, 패키지 관리, 테스트로 각각 분류했다. 이렇게 스킬을 분류해 두면 LLM이 작업 시 필요한 스킬만 찾아 읽을 수 있어 업무 효율이 향상된다. 이 분류에 따라 .agents/skills 디렉토리 하위에 각 스킬별로 디렉토리를 만들고 SKILL.md 파일을 작성해 모든 AI 에이전트가 읽을 수 있도록 했다. SKILL.md 파일은 LLM뿐만 아니라 개발자도 읽고 수정하기 쉬운 마크다운 형식으로 작성한 것도 포인트다.
SKILL.md 파일에 담긴 주요 내용은 대부분 소스 코드만으로 알기 어려운 외부 환경 정보나 규칙, 코딩 컨벤션, 유틸 함수, 라이브러리 활용 등이었다. 개발자가 누락하기 쉬운 Django 마이그레이션 생성이나 환경 변수, django settings 같은 설정도 체크하도록 신경 썼다.
특히 더 살폈던 부분은 분류와 레거시 플랫폼과의 호환성이었다. 데일리펀딩이 진행 중인 대규모 마이그레이션 프로젝트는 기존 레거시 플랫폼을 정상적으로 운영하면서 새로운 플랫폼이 데이터 구조를 처리하는 게 관건이다. LLM이 이러한 기반 지식이 없을 경우 호환성을 고려하지 않은 코드를 작성할 가능성이 존재한다. 그럼 기존 플랫폼과의 호환성이 떨어져 서비스 안정성이 낮아진다. 레거시 플랫폼이 사용 중인 DB 모델이나 데이터 처리 방법, 호환 레이어에 대한 설명을 꼼꼼히 챙긴 이유다.
