CrewX 0.5.0 릴리스 - Skills와 Mention-Only 모드 추가

2025년 11월 11일 · 약 3분

Founder @ SowonLabs

CrewX 0.5.0이 출시되었습니다! 이번 릴리스에서는 두 가지 주요 기능이 추가되었습니다:

Skills 시스템: Claude Code 스킬과 100% 호환되는 재사용 가능한 AI 능력 시스템
Mention-Only 모드: Slack에서 멘션했을 때만 응답하는 선택적 Bot 모드

🎯 주요 신기능

1. Skills 시스템 - Claude Code와 완벽 호환

Skills는 재사용 가능한 AI 전문성을 패키징하는 표준 방식입니다. CrewX는 Claude Code의 Skills 포맷과 100% 호환되므로, 기존 Claude 스킬을 수정 없이 바로 사용할 수 있습니다.

왜 Skills인가?

Claude Code 호환: Claude Code 스킬을 CrewX에서 그대로 사용
다중 제공자 지원: 하나의 스킬을 Claude, Gemini, Copilot, Codex 모두에서 테스트
Progressive Loading: 메타데이터만 먼저 로드, 필요할 때 콘텐츠 로드
버전 관리: 스킬을 독립적으로 관리 및 배포

3단계로 시작하기

1. SKILL.md 파일 생성

skills/hello/SKILL.md:

---
name: hello
description: 친절한 인사를 제공하는 데모 스킬
version: 0.0.1
---

# Hello Skill

CrewX 스킬 시스템이 정상 작동하는지 확인하거나 친절한 인사가 필요할 때 사용하세요.

## 기능
- hello 스킬의 작동 방식과 스크립트 위치 설명 (`skills/hello/hello.js`)
- 선택적으로 스크립트를 실행하여 인사말 생성
- 응답에 "CrewX hello skill"이 작동했음을 명시하여 테스터가 확인 가능

## 사용법
1. 빠른 인사가 필요하면 다음을 실행:
   ```bash
   node skills/hello/hello.js <name>

name은 선택사항이며 기본값은 "CrewX user" 2. 스크립트 출력을 응답에 인용하여 사용자가 결과를 볼 수 있도록 함 3. 추가 설명을 덧붙이되 짧고 친절하게 유지

**2. crewx.yaml에 설정**

```yaml
# 프로젝트 전체 스킬 설정
skills:
  paths:
    - ./skills              # 스킬 디렉토리 지정
  include:
    - hello                 # 로드할 스킬 지정

# 에이전트별 스킬 추가
agents:
  - id: "senior_dev"
    provider: "cli/claude"
    skills:
      include:
        - hello
        - code-reviewer
    inline:
      prompt: |
        You are a senior developer with specialized skills.

3. 사용하기

# 스킬을 가진 에이전트 실행
crewx query "@senior_dev test hello skill"

# 여러 AI 제공자에서 테스트 (crewx.skills.yaml 설정 필요)
CREWX_CONFIG=crewx.skills.yaml crewx query "@skill_tester_claude test hello"
CREWX_CONFIG=crewx.skills.yaml crewx query "@skill_tester_gemini test hello"

Claude Code 스킬 바로 사용

Claude Code의 .claude/skills/ 디렉토리에 있는 스킬을 그대로 사용:

skills:
  paths:
    - ./.claude/skills    # Claude Code 스킬 경로
    - ./skills            # CrewX 커스텀 스킬

수정 없이, 복사 없이, 바로 동작합니다! 동일한 파일 구조(SKILL.md + YAML frontmatter), 동일한 메타데이터 필드(name, description, version), 동일한 콘텐츠 형식(Markdown)을 사용합니다. 🎉

2. Slack Mention-Only 모드

Slack Bot이 이제 mention-only 모드를 지원합니다. 이 모드를 활성화하면 CrewX Bot이 명시적으로 멘션되었을 때만 응답합니다.

왜 필요한가?

기본 모드에서는 Bot이 채널의 모든 쓰레드에 자동으로 응답합니다. 하지만 팀원끼리 대화하는 쓰레드나 간단한 질문에는 AI가 끼어들 필요가 없을 때가 많습니다.

사용법

# Mention-only 모드로 Slack Bot 실행
crewx slack --mention-only

# 일반 모드 (모든 쓰레드에 응답)
crewx slack

동작 방식:

일반 모드: Bot이 모든 쓰레드의 메시지에 자동 응답
Mention-only 모드: @CrewX 멘션이 있을 때만 응답

# Mention-only 모드에서
👤 "코드 리뷰 부탁해"           → Bot 응답 없음
👤 "@CrewX 코드 리뷰 부탁해"   → Bot 응답! ✅

이제 필요할 때만 AI를 호출할 수 있어, 더 효율적인 팀 협업이 가능합니다.

📦 기타 개선사항

Document System 리팩토링: 에이전트 설정에서 문서 관리가 더 유연해졌습니다
성능 최적화: Skills의 Progressive Loading으로 메모리 사용량 감소
안정성 향상: 다양한 버그 수정 및 에러 핸들링 개선

🚀 업그레이드 방법

# NPM으로 업데이트
npm update -g crewx

# 또는 재설치
npm install -g crewx@latest

# 버전 확인
crewx --version  # 0.5.0이 출력되어야 합니다

기존 crewx.yaml 설정은 그대로 동작합니다. Skills를 사용하려면 위에서 설명한 대로 skills 섹션을 추가하면 됩니다.

📚 관련 문서

다음 단계

CrewX 0.5.0으로 업그레이드하고, Claude Code 스킬을 활용해보세요!

# Skills 예제 확인
git clone https://github.com/sowonlabs/crewx
cd crewx/skills/hello

# Mention-only 모드로 Slack Bot 실행
crewx slack --mention-only

궁금한 점이 있으시면 GitHub Issues에 남겨주세요! 🙌

🎯 주요 신기능​

1. Skills 시스템 - Claude Code와 완벽 호환​

왜 Skills인가?​

3단계로 시작하기​

Claude Code 스킬 바로 사용​

2. Slack Mention-Only 모드​

왜 필요한가?​

사용법​

📦 기타 개선사항​

🚀 업그레이드 방법​

📚 관련 문서​

다음 단계​