콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

Aggrega 스킬

Aggrega 스킬은 AI 어시스턴트에게 Aggrega를 설치하고 사용하는 방법을 가르칩니다. 이 스킬은 공개 Agent Skills 형식의 SKILL.md 파일을 담은 aggrega라는 폴더로, 많은 어시스턴트가 자체 스킬 폴더에서 이 형식을 읽고 요청이 Aggrega와 관련될 때 불러옵니다.

어시스턴트에 스킬을 제공하는 방법은 두 가지입니다. 플러그인을 설치하는 어시스턴트는 Aggrega 플러그인의 일부로 스킬을 받으며, 이 플러그인은 어시스턴트를 Aggrega MCP 서버에도 연결하여 이 모두를 한 단계로 처리합니다. 플러그인 설치를 참조하십시오. 폴더에서 스킬을 읽는 어시스턴트라면 aggrega 바이너리가 그 폴더에 스킬을 써 넣게 할 수 있습니다. 스킬만 설치를 참조하십시오.

플러그인 설치

저장소 aggrega-ai/aggrega-skills는 스킬을 담고 있으며 아래 어시스턴트용 플러그인이기도 합니다. 플러그인을 설치하면 Aggrega 스킬이 추가되고 어시스턴트가 Aggrega MCP 서버에 연결되며, 이후 어시스턴트가 직접 aggrega mcp로 서버를 시작합니다. 따라서 해당 어시스턴트에는 aggrega skills install도, MCP 서버 연결의 단계도 필요하지 않습니다.

플러그인은 aggrega 바이너리를 설치하지 않습니다. 어시스턴트가 서버를 시작할 때 PATH에서 aggrega를 찾을 수 있도록 바이너리 설치에서 설명하는 대로 먼저 설치하십시오.

Claude Code

Terminal window
claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills

Claude Code 안에서는 같은 작업이 /plugin install aggrega --marketplace aggrega-ai/aggrega-skills입니다.

Codex

Terminal window
codex plugin marketplace add aggrega-ai/aggrega-skills
codex plugin add aggrega@aggrega

첫 번째 명령은 저장소를 aggrega라는 이름의 플러그인 마켓플레이스로 추가하고, 두 번째 명령은 그곳에서 aggrega 플러그인을 설치합니다.

GitHub Copilot

GitHub Copilot CLI에서는 다음과 같습니다:

Terminal window
copilot plugin marketplace add aggrega-ai/aggrega-skills
copilot plugin install aggrega@aggrega

GitHub Copilot이 있는 Visual Studio Code는 GitHub Copilot CLI가 설치한 플러그인을 찾아 함께 사용합니다. Visual Studio Code 자체에서 플러그인을 설치하려면 명령 팔레트에서 Chat: Install Plugin from Source를 실행하고 저장소 주소 https://github.com/aggrega-ai/aggrega-skills를 입력하십시오.

Gemini CLI

Terminal window
gemini extensions install https://github.com/aggrega-ai/aggrega-skills

Gemini CLI는 플러그인을 확장 프로그램 중 하나로 설치합니다.

Antigravity

Terminal window
agy plugin install https://github.com/aggrega-ai/aggrega-skills

Cursor

Cursor는 ~/.cursor/plugins/local/ 아래의 폴더에서 플러그인을 불러옵니다. 그곳에 저장소를 둔 다음 명령 팔레트에서 Developer: Reload Window를 실행하십시오:

Terminal window
git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega

Kiro

Kiro는 플러그인을 power로 설치합니다. Powers 패널에서 Add Custom Power를 선택한 다음 Import power from GitHub를 선택하고, 저장소 주소 https://github.com/aggrega-ai/aggrega-skills를 입력한 뒤 Install을 선택하십시오. Kiro는 플러그인의 MCP 서버를 power와 함께 시작하고 중지합니다.

OpenClaw

Terminal window
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills

OpenClaw는 스스로 검토하지 않은 소스에서 플러그인을 설치하기 전에 두 번 묻습니다. 먼저 멈추고 소스를 검토한 뒤 --force를 붙여 명령을 다시 실행하라고 요청합니다. 그런 다음 --accept-capabilities로 플러그인이 가져오는 것(여기서는 스킬과 MCP 서버)에 대한 동의를 요청합니다. 저장소를 검토했다면 다음을 실행하십시오:

Terminal window
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills --force --accept-capabilities

--force는 이미 설치된 같은 이름의 플러그인도 대체하므로, 이전에 aggrega라는 플러그인을 설치한 적이 있다면 먼저 openclaw plugins list를 확인하십시오.

서버가 작업하는 폴더

Aggrega의 도구는 워크스페이스에서 작동하며, 워크스페이스를 지정하지 않은 호출에는 서버가 시작된 폴더에서 찾은 워크스페이스에서 응답합니다. 일부 어시스턴트는 플러그인의 서버를 프로젝트가 아니라 플러그인 자체 폴더에서 시작합니다(Codex가 그렇습니다). 스킬은 어시스턴트가 프로젝트에서 작업하기 전에 config-show 도구로 서버가 어느 워크스페이스에서 응답하는지 확인하고, 둘이 다르면 해당 값을 받는 각 호출에서 프로젝트 폴더를 전체 경로로 workspace_root에 지정하도록 지시합니다. 상대 workspace_root는 서버가 이미 응답하고 있는 워크스페이스를 기준으로 읽히기 때문입니다.

스킬만 설치

플러그인 없이 스킬을 설치하려면 aggrega 바이너리를 사용합니다. 바이너리는 내장된 사본을 씁니다. 컴퓨터에 있는 어시스턴트를 위해 모든 프로젝트에 설치합니다:

Terminal window
aggrega skills install --global

현재 프로젝트에 어시스턴트 하나를 지정하여 설치합니다:

Terminal window
aggrega skills install --agent claude-code

설치할 수 있는 어시스턴트와 각 어시스턴트가 읽는 폴더를 나열합니다:

Terminal window
aggrega skills list

설치 명령도 바이너리를 설치하면서 스킬을 추가할 수 있습니다. 해당 옵션은 설치하면서 어시스턴트 스킬 추가에서 설명합니다. 이 방법으로 설치한 스킬에는 서버 연결이 포함되지 않으므로, MCP 서버 연결에서 설명하는 대로 어시스턴트를 서버에 연결하십시오.

스킬이 어시스턴트에 알려 주는 내용

스킬은 어시스턴트에게 Aggrega를 설치하는 방법, aggrega mcp 서버에 연결하는 방법, 워크스페이스를 시작하는 방법, 그리고 Aggrega 파일 작성에서 설명하는 작성 루프(scaffold, validate, build)를 실행하는 방법을 알려 줍니다. 스킬에는 스키마나 엔티티 계약의 사본이 전혀 없습니다. 구조에 관한 모든 답은 바이너리에서 얻도록(서버가 연결되어 있으면 MCP 도구, 그렇지 않으면 aggrega 명령줄) 하고, 의미에 관한 것은 공개된 문서를 참고하도록 어시스턴트를 안내합니다.

스킬과 MCP 서버는 서로 다른 역할을 하며, 어시스턴트는 둘 다 있을 때 가장 잘 작동합니다. 스킬은 어시스턴트가 읽는 지침이고, 플러그인이나 MCP 서버 연결로 연결하는 서버는 어시스턴트가 호출하는 도구입니다. 플러그인을 설치하지 않고 --agent 목록에도 없는 어시스턴트는 스킬을 건너뛰지만 서버를 통해 같은 도구와 참조 자료에 접근할 수 있습니다.

설치 위치

플러그인은 어시스턴트가 플러그인을 보관하는 폴더에 스킬을 보관합니다. aggrega skills install은 다른 곳에 씁니다. --global 없이 실행하면 워크스페이스 루트에 있는 어시스턴트의 프로젝트 스킬 폴더에 쓰며, 프로젝트의 스킬은 그곳에 커밋됩니다. --global을 지정하면 홈 디렉터리에 있는 어시스턴트의 사용자별 스킬 폴더에 쓰며, 어시스턴트는 모든 프로젝트에서 이 폴더를 읽습니다. --global을 지정하고 --agent를 지정하지 않으면, 명령은 컴퓨터에 있는 어시스턴트를 찾아 찾은 각 어시스턴트와 무엇으로 찾았는지를 출력하고, 터미널에서는 쓰기 전에 묻습니다. aggrega skills에서 각 어시스턴트의 폴더, 각 어시스턴트를 무엇으로 찾는지, 명령이 덮어쓰기를 거부하는 대상을 확인할 수 있습니다.

스킬을 최신 상태로 유지하기

플러그인과 함께 설치된 스킬은 어시스턴트 자체의 플러그인 업데이트 방식을 통해 플러그인과 함께 업데이트됩니다. Cursor의 로컬 폴더에 복제한 플러그인은 그 폴더에서 git pull을 실행한 다음 Developer: Reload Window를 실행하여 업데이트합니다. 플러그인은 PATH에 있는 aggrega 바이너리가 실행하는 서버를 연결하므로, 도구와 참조 자료는 설치한 바이너리를 따릅니다.

스킬은 aggrega 바이너리에도 내장되어 있으므로 aggrega skills install이 쓰는 사본은 설치된 버전과 일치합니다. Aggrega를 업그레이드한 후(설치 프로그램 명령은 바이너리를 제자리에서 업데이트합니다) 같은 aggrega skills install 명령을 다시 실행하여 그 사본을 새 버전으로 업데이트하십시오.