Create a new Synapse plugin using the `synapse plugin create` CLI command.
Creates a new Synapse plugin using the synapse plugin create CLI command.
/plugin marketplace add datamaker-kr/synapse-claude-marketplace/plugin install synapse-plugin-helper@synapse-marketplaceCreate a new Synapse plugin using the synapse plugin create CLI command.
Arguments: $ARGUMENTS
CRITICAL: Before proceeding, verify the development environment.
Run these checks in order:
# Check uv (priority 1)
uv --version 2>/dev/null && echo "UV_AVAILABLE=true" || echo "UV_AVAILABLE=false"
# Check pip (priority 2)
pip --version 2>/dev/null && echo "PIP_AVAILABLE=true" || echo "PIP_AVAILABLE=false"
# Check Python version (requires 3.12+)
python3 --version 2>/dev/null || python --version 2>/dev/null
Package Manager Priority:
synapse-sdk requires Python 3.12 or higher:
python3 -c "import sys; v=sys.version_info; print(f'Python {v.major}.{v.minor}.{v.micro}'); exit(0 if v >= (3,12) else 1)"
If Python < 3.12:
⚠️ Python 3.12 이상이 필요합니다.
현재 버전: [version]
설치 방법:
- macOS: brew install python@3.11
- Ubuntu: sudo apt install python3.11
- Windows: https://python.org/downloads/
# Check if synapse CLI is available
synapse --version 2>/dev/null
If synapse command not found, guide installation:
# uv가 설치되어 있는 경우
uv pip install synapse-sdk
또는 uv 가상환경 사용:
uv venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
uv pip install synapse-sdk
# pip 사용 시
pip install synapse-sdk
또는 가상환경 사용:
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install synapse-sdk
Display to user:
╔══════════════════════════════════════════════════╗
║ SYNAPSE SDK 설치 필요 ║
╠══════════════════════════════════════════════════╣
║ synapse-sdk가 설치되어 있지 않습니다. ║
║ ║
║ 설치 방법 (택 1): ║
║ ║
║ [권장] uv 사용: ║
║ uv pip install synapse-sdk ║
║ ║
║ [대안] pip 사용: ║
║ pip install synapse-sdk ║
╠══════════════════════════════════════════════════╣
║ 설치 후 다시 실행해주세요. ║
╚══════════════════════════════════════════════════╝
Ask user: "synapse-sdk를 지금 설치할까요? (uv/pip/취소)"
If user agrees:
synapse --versionExtract options from arguments:
--name - Plugin display name (optional, will prompt if not provided)--code - Plugin code/slug (optional, will prompt if not provided)--path - Target directory (default: current directory)--category - Plugin category (default: custom)--yes - Skip confirmation promptsIf plugin name/code not provided in arguments, ask user:
What should the plugin be named? (Display name, e.g., My Awesome Plugin)
What should the plugin code be? (kebab-case, e.g., my-awesome-plugin)
Run the Synapse CLI to create the plugin structure:
synapse plugin create --name [plugin-name] --code [plugin-code] --path [path] --category [category]
Available categories:
| Category | Description |
|---|---|
neural_net | ML model training/inference |
export | Data format conversion |
upload | External data import |
smart_tool | AI-assisted annotation |
pre_annotation | Pre-labeling processing |
post_annotation | Post-labeling processing |
data_validation | Data quality checks |
custom | User-defined |
After running the command:
config.yaml was createdsynapse-[code]-plugin)ls -la [plugin-path]/ # e.g., ./synapse-[code]-plugin/
cat [plugin-path]/config.yaml
Inform user about:
config.yaml/synapse-plugin:test╔══════════════════════════════════════════════════╗
║ 플러그인 생성 완료! 🎉 ║
╠══════════════════════════════════════════════════╣
║ 다음 단계: ║
║ ║
║ 1. config.yaml 수정 ║
║ - 액션 정의 추가 ║
║ - 메타데이터 설정 ║
║ ║
║ 2. 액션 코드 작성 ║
║ "BaseAction 만드는 법 알려줘" 질문하기 ║
║ ║
║ 3. 의존성 설치 ║
║ uv sync (또는 pip install -r requirements.txt)║
║ ║
║ 4. 로컬 테스트 ║
║ /synapse-plugin:test [action-name] ║
║ ║
║ 5. 배포 전 검증 ║
║ /synapse-plugin:dry-run ║
╚══════════════════════════════════════════════════╝
uv가 설치되어 있지 않습니다.
uv 설치 방법:
- macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
- pip: pip install uv
또는 pip을 직접 사용할 수 있습니다.
pip을 찾을 수 없습니다.
해결 방법:
- Python 재설치 (pip 포함 확인)
- python3 -m ensurepip --upgrade
Directory already exists. Choose:
1. Use a different path
2. Overwrite existing files (--yes)
패키지 다운로드 실패.
확인사항:
- 인터넷 연결 확인
- 프록시 설정 확인 (기업 환경)
- PyPI 접근 가능 여부: pip index versions synapse-sdk