Skill Design & Multi-Agent Patterns

#!/usr/bin/env python3
"""create-skill.py — 새 스킬 생성 도우미"""
import os
from pathlib import Path

def create_skill(name: str, description: str, trigger_phrases: list = None):
    """새 스킬 디렉토리와 SKILL.md 생성"""
    skills_dir = Path.home() / '.agents' / 'skills' / name
    skills_dir.mkdir(parents=True, exist_ok=True)
    
    # 서브디렉토리 생성
    (skills_dir / 'scripts').mkdir(exist_ok=True)
    (skills_dir / 'references').mkdir(exist_ok=True)
    
    trigger_text = ''
    if trigger_phrases:
        trigger_text = '\nTrigger phrases: ' + ', '.join(trigger_phrases)
    
    skill_md = f"""---
name: {name}
description: |
  {description}{trigger_text}
allowed-tools: Read, Bash, Edit, Write
version: 1.0.0
---

# {name.replace('-', ' ').title()}

## Purpose
<!-- 이 스킬이 무엇을 하는지 1-2문장으로 -->

## When to Use
<!-- 트리거 조건: 어떤 사용자 요청에 반응하는가 -->

## Instructions
<!-- 구체적인 단계별 지침 -->

1. 첫 번째 단계
2. 두 번째 단계

## Output Format
<!-- 예상 출력 형식 -->

## Examples
<!-- 입력/출력 예시 -->

## Notes
<!-- 에지 케이스, 제한사항, 주의사항 -->
"""
    
    skill_file = skills_dir / 'SKILL.md'
    skill_file.write_text(skill_md)
    
    # Claude skills 심볼릭 링크
    claude_skills_dir = Path.home() / '.claude' / 'skills' / name
    if not claude_skills_dir.exists():
        os.symlink(str(skills_dir), str(claude_skills_dir))
    
    print(f"✅ 스킬 생성: {skills_dir}")
    print(f"✅ 심볼릭 링크: {claude_skills_dir}")
    print(f"")
    print(f"다음 단계:")
    print(f"1. {skill_file} 수정")
    print(f"2. description 필드를 정밀하게 작성 (트리거 신호!)")
    print(f"3. 부정적 예시 추가 (OpenAI: 73%→85% 향상)")
    print(f"4. Claude Code 재시작 후 테스트")
    
    return str(skill_file)

def list_skills():
    """현재 설치된 스킬 목록 출력"""
    skills_dir = Path.home() / '.agents' / 'skills'
    if not skills_dir.exists():
        print("스킬 없음")
        return
    
    print("=== 설치된 스킬 ===")
    for skill_dir in sorted(skills_dir.iterdir()):
        if skill_dir.is_dir():
            skill_md = skill_dir / 'SKILL.md'
            if skill_md.exists():
                lines = skill_md.read_text().split('\n')
                desc_lines = []
                in_desc = False
                for line in lines:
                    if 'description:' in line:
                        in_desc = True
                        continue
                    if in_desc and line.startswith('  '):
                        desc_lines.append(line.strip())
                    elif in_desc:
                        break
                desc = ' '.join(desc_lines[:1])[:80] if desc_lines else '설명 없음'
                print(f"  📦 {skill_dir.name}: {desc}...")

if __name__ == '__main__':
    import sys
    if len(sys.argv) < 2:
        list_skills()
    else:
        name = sys.argv[1]
        desc = sys.argv[2] if len(sys.argv) > 2 else f'Use when working with {name}'
        create_skill(name, desc)