MoaidHathot/Zakira.Conduit

Zakira.Conduit은(는) 무엇을 하나요?

GitHub 또는 로컬 디렉토리에서 에이전트 스킬을 미러링하여 에이전트 폴더로 가져오는 도구입니다. conduit.json 매니페스트를 기반으로 동작합니다.

개요

Zakira.Conduit은 AI 에이전트용 스킬을 중앙에서 관리하고 동기화할 수 있는 편리한 방법을 제공합니다. 단일 conduit.json 파일을 통해 여러 소스에서 스킬을 가져와 지정된 에이전트 디렉토리에 배포할 수 있습니다.

설치

# npm을 통해 전역 설치 (권장)
npm install -g @moaidhathot/zakira-conduit

# 또는 저장소 클론 후 로컬에서 실행
git clone https://github.com/MoaidHathot/Zakira.Conduit.git
cd Zakira.Conduit
npm install

사용법

1. conduit.json 생성

프로젝트 루트에 conduit.json 파일을 생성하고 다음과 같이 원하는 스킬 소스를 정의합니다:

{
  "skills": [
    {
      "name": "my-awesome-skill",
      "source": "https://github.com/username/my-awesome-skill",
      "destination": "./agent-skills"
    },
    {
      "name": "local-skill",
      "source": "./path/to/local/skill",
      "destination": "./agent-skills"
    }
  ]
}

2. 스킬 동기화 실행

# 현재 디렉토리의 conduit.json 사용
zakira-conduit sync

# 특정 manifest 파일 지정
zakira-conduit sync --manifest ./path/to/conduit.json

3. CLI 옵션

옵션	설명
--manifest, -m	사용할 manifest 파일 경로 (기본값: ./conduit.json)
--force, -f	기존 파일을 덮어씁니다
--dry-run	실제 복사 없이 수행될 작업만 표시합니다
--help	도움말을 표시합니다

conduit.json 설정

conduit.json 파일은 다음 구조를 따릅니다:

{
  "skills": [
    {
      "name": "string (필수) - 스킬의 고유 이름",
      "source": "string (필수) - GitHub URL 또는 로컬 디렉토리 경로",
      "destination": "string (필수) - 에이전트 폴더 내 대상 경로",
      "branch": "string (선택) - GitHub 소스 사용 시 브랜치 지정 (기본값: main)",
      "files": ["array (선택) - 특정 파일만 복사 (지정하지 않으면 전체 복사)"]
    }
  ]
}

예제: 특정 파일만 복사

{
  "skills": [
    {
      "name": "code-review-skill",
      "source": "https://github.com/team/code-review-skill",
      "destination": "./agent-skills/code-review",
      "files": ["skill.md", "config.json", "prompts/"]
    }
  ]
}

동작 방식

1. 파싱: conduit.json을 읽고 각 스킬 항목을 파싱합니다.
2. 소스 처리:
   • GitHub 소스: 지정된 저장소를 임시 디렉토리에 클론하거나, Git archive를 사용하여 다운로드합니다.
   • 로컬 소스: 지정된 디렉토리 경로를 확인합니다.
3. 복사: 필요한 파일을 소스에서 목적지 에이전트 폴더로 복사합니다.
4. 정리: 임시 파일은 제거하고 완료 메시지를 출력합니다.

지원되는 에이전트 플랫폼

• Claude Code: .claude/skills/ 폴더
• Cursor: .cursor/skills/ 폴더
• Codex: ~/.codex/skills/ 폴더 (또는 설정에 따라 다름)
• 기타 사용자 정의 경로 지원

라이선스

MIT