AI 코딩 에이전트 전반에서 스킬과 MCP 서버를 관리하는 방법
Source: Dev.to
AI 코딩 에이전트를 동기화하기
최근 AI 코딩 에이전트를 사용하면서 예상보다 더 자주 전환하게 되었습니다.
- 때때로 모델이 토큰 제한에 걸립니다.
- 때때로 속도 제한이 적용됩니다.
- 때때로 다른 모델이 특정 작업에 더 잘 맞습니다.
그래서 같은 프로젝트 안에서도 Codex, Cursor, Gemini, Claude Code, 혹은 Copilot 같은 도구들을 오가게 됩니다.
대부분의 코딩 에이전트는 이제 대략 같은 개념을 지원합니다:
- 스킬
- MCP 서버
- 로컬 도구 및 설정
- 파일 시스템 탐색
하지만 상태를 공유하지 않기 때문에 실용적인 문제가 발생합니다:
- 한 에이전트에 새로운 MCP를 설치하면 다른 에이전트에도 다시 설치해야 합니다.
- 스킬을 업데이트하면 모든 에이전트가 최신 버전을 사용하도록 해야 합니다.
- 새로운 에이전트를 시도하면 전체 설정을 다시 만들어야 합니다.
시간이 지나면서 설정이 서로 달라집니다.
아이디어
환경을 정의하는 하나의 워크스페이스를 만들고, 에이전트는 그 정의를 소비하도록 하고 싶었습니다.
그 결과가 skills-sync 입니다.
skills-sync는 스킬과 MCP 구성을 하나의 워크스페이스에 보관하고, 지원되는 에이전트에 그 상태를 동기화해 주는 CLI 도구입니다. 각 에이전트를 별도의 수동 설정으로 다루는 대신, 단일 진실 원본을 제공합니다.
작동 방식
skills-sync를 사용하면 환경이 로컬 워크스페이스에 존재합니다. 심볼릭 링크를 사용해 에이전트가 동일한 기본 파일을 가리키게 하여 복제된 사본을 만들지 않습니다. 이는 다음을 의미합니다:
- 스킬이 한 곳에 존재
- MCP 구성이 한 곳에 존재
- 업데이트가 깔끔하게 전파
- 새로운 에이전트가 동일한 설정을 재사용 가능
- 도구를 전환해도 모든 것을 다시 구축할 필요 없음
현재 프로젝트는 Codex, Cursor, Gemini, Copilot, 그리고 Claude Code를 지원합니다.
기본 워크플로우
실제 첫 실행 예시는 다음과 같습니다:
# initialize the local workspace with starter content
skills-sync init --seed
# use the default profile
skills-sync use personal
# materialize runtime output for supported agents
skills-sync sync업스트림에서 스킬 추가하기
skills-sync profile add-upstream --source matlab/skills
skills-sync list upstream-content --upstream matlab_skills
skills-sync profile add-skill --upstream matlab_skills --path skills/matlab-test-generator드리프트 확인하기
skills-sync agents inventory
skills-sync agents drift --dry-run프로파일 내보내기 / 가져오기
같은 설정을 다른 머신으로 옮기고 싶다면, 프로파일을 내보내고 가져와서 기억에서 다시 구축할 필요 없이 사용할 수 있습니다.
결론
skills-sync는 아직 초기 단계이지만, 핵심 워크플로우는 이미 저에게 잘 작동하고 있습니다. 여러 코딩 에이전트를 동시에 사용하면서 환경이 서로 달라지는 것이 지겹다면, 한 번 살펴보세요:
피드백이나 아이디어를 언제든 환영합니다.
읽어 주셔서 감사합니다.