@kood/claude-code 0.1.9 → 0.1.11

package/templates/npx/docs/skills/command-creator/scripts/init_command.py

@@ -0,0 +1,244 @@
+#!/usr/bin/env python3
+"""
+커맨드 초기화 스크립트 - 템플릿에서 새 슬래시 커맨드 생성
+
+사용법:
+    init_command.py <커맨드명> --path <경로>
+    init_command.py <커맨드명> --project
+    init_command.py <커맨드명> --personal
+
+예시:
+    init_command.py review-security --path .claude/commands
+    init_command.py commit-fix --project
+    init_command.py my-helper --personal
+"""
+
+import sys
+import os
+from pathlib import Path
+
+
+COMMAND_TEMPLATE = """---
+description: [TODO: 커맨드가 하는 일에 대한 간단한 설명]
+allowed-tools: [TODO: 필요한 도구 목록, 예: Bash(git:*), Read, Write]
+argument-hint: [TODO: 예상 인자, 예: <file> <type>]
+---
+
+# {command_title}
+
+[TODO: 여기에 커맨드 지시사항 작성]
+
+## 예시 패턴
+
+### 인자 사용하기
+
+모든 인자를 단일 문자열로:
+```
+다음을 처리하세요: $ARGUMENTS
+```
+
+위치 인자:
+```
+$1 파일을 $2 우선순위로 검토하세요
+```
+
+### 컨텍스트 포함하기
+
+파일 내용:
+```
+@$1 의 코드를 검토하세요
+```
+
+셸 출력:
+```
+현재 상태: !`git status`
+```
+
+### 일반적인 지시사항
+
+[TODO: 실제 커맨드 지시사항으로 대체. 예시:]
+
+**코드 리뷰용:**
+```
+다음 코드를 검토하세요:
+- 보안 취약점
+- 성능 이슈
+- 코드 스타일 위반
+
+@$ARGUMENTS
+```
+
+**커밋 생성용:**
+```
+다음 형식으로 git 커밋 생성:
+- 타입: $1
+- 메시지: $2
+
+컨벤셔널 커밋 형식을 따르세요.
+```
+
+**테스트 생성용:**
+```
+@$1 의 코드에 대한 유닛 테스트 생성
+
+포함할 것:
+- 엣지 케이스
+- 에러 처리
+- 해피 패스 시나리오
+```
+
+---
+
+이 템플릿 내용을 삭제하고 위에 실제 커맨드 지시사항을 작성하세요.
+"""
+
+SIMPLE_TEMPLATE = """---
+description: {description}
+allowed-tools: {tools}
+argument-hint: {hint}
+---
+
+{instructions}
+"""
+
+
+def title_case_command_name(command_name):
+    """하이픈으로 구분된 커맨드명을 Title Case로 변환."""
+    return ' '.join(word.capitalize() for word in command_name.split('-'))
+
+
+def get_project_commands_path():
+    """프로젝트 커맨드 디렉토리 경로 반환."""
+    return Path.cwd() / '.claude' / 'commands'
+
+
+def get_personal_commands_path():
+    """개인 커맨드 디렉토리 경로 반환."""
+    return Path.home() / '.claude' / 'commands'
+
+
+def init_command(command_name, path):
+    """
+    템플릿으로 새 커맨드 파일 초기화.
+
+    Args:
+        command_name: 커맨드 이름 (.md 확장자 제외)
+        path: 커맨드 파일이 생성될 경로
+
+    Returns:
+        생성된 커맨드 파일 경로, 오류 시 None
+    """
+    # 커맨드명 검증
+    if not command_name:
+        print("❌ 오류: 커맨드 이름이 필요합니다")
+        return None
+
+    # .md 확장자 제거
+    if command_name.endswith('.md'):
+        command_name = command_name[:-3]
+
+    # 이름 규칙 검증
+    import re
+    if not re.match(r'^[a-z0-9-]+$', command_name):
+        print(f"❌ 오류: 커맨드 이름 '{command_name}'은 하이픈-케이스여야 합니다")
+        print("  (소문자, 숫자, 하이픈만 허용)")
+        return None
+
+    if command_name.startswith('-') or command_name.endswith('-') or '--' in command_name:
+        print(f"❌ 오류: 커맨드 이름 '{command_name}'은 하이픈으로 시작/끝나거나")
+        print("  연속된 하이픈을 포함할 수 없습니다")
+        return None
+
+    if len(command_name) > 40:
+        print(f"❌ 오류: 커맨드 이름 '{command_name}'이 40자를 초과합니다")
+        return None
+
+    # 커맨드 파일 경로 결정
+    command_dir = Path(path).resolve()
+    command_file = command_dir / f'{command_name}.md'
+
+    # 파일 존재 여부 확인
+    if command_file.exists():
+        print(f"❌ 오류: 커맨드 파일이 이미 존재합니다: {command_file}")
+        return None
+
+    # 필요시 디렉토리 생성
+    try:
+        command_dir.mkdir(parents=True, exist_ok=True)
+    except Exception as e:
+        print(f"❌ 오류: 디렉토리 생성 실패: {e}")
+        return None
+
+    # 템플릿에서 커맨드 파일 생성
+    command_title = title_case_command_name(command_name)
+    command_content = COMMAND_TEMPLATE.format(
+        command_name=command_name,
+        command_title=command_title
+    )
+
+    try:
+        command_file.write_text(command_content)
+        print(f"✅ 커맨드 파일 생성: {command_file}")
+    except Exception as e:
+        print(f"❌ 오류: 커맨드 파일 생성 실패: {e}")
+        return None
+
+    # 다음 단계 안내
+    print(f"\n✅ 커맨드 '{command_name}' 초기화 완료!")
+    print(f"\n사용법: /{command_name}")
+    print("\n다음 단계:")
+    print("1. 커맨드 파일을 편집하여 TODO 항목 완성")
+    print("2. frontmatter의 description 업데이트")
+    print("3. 템플릿 내용을 실제 지시사항으로 교체")
+    print(f"4. 커맨드 테스트: /{command_name}")
+
+    return command_file
+
+
+def main():
+    if len(sys.argv) < 3:
+        print("사용법: init_command.py <커맨드명> --path <경로>")
+        print("       init_command.py <커맨드명> --project")
+        print("       init_command.py <커맨드명> --personal")
+        print("\n커맨드명 요구사항:")
+        print("  - 하이픈-케이스 식별자 (예: 'review-security')")
+        print("  - 소문자, 숫자, 하이픈만 허용")
+        print("  - 최대 40자")
+        print("\n예시:")
+        print("  init_command.py review-security --path .claude/commands")
+        print("  init_command.py commit-fix --project")
+        print("  init_command.py my-helper --personal")
+        sys.exit(1)
+
+    command_name = sys.argv[1]
+    option = sys.argv[2]
+
+    # 옵션에 따라 경로 결정
+    if option == '--project':
+        path = get_project_commands_path()
+    elif option == '--personal':
+        path = get_personal_commands_path()
+    elif option == '--path':
+        if len(sys.argv) < 4:
+            print("❌ 오류: --path는 디렉토리 인자가 필요합니다")
+            sys.exit(1)
+        path = sys.argv[3]
+    else:
+        print(f"❌ 오류: 알 수 없는 옵션 '{option}'")
+        print("--path <경로>, --project, --personal 중 하나를 사용하세요")
+        sys.exit(1)
+
+    print(f"🚀 커맨드 초기화: {command_name}")
+    print(f"   위치: {path}")
+    print()
+
+    result = init_command(command_name, path)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/templates/npx/docs/skills/command-creator/scripts/package_command.py

@@ -0,0 +1,125 @@
+#!/usr/bin/env python3
+"""
+커맨드 패키저 - 커맨드 파일을 배포용 zip 파일로 생성
+
+사용법:
+    python package_command.py <commands-폴더-경로> [출력-디렉토리]
+    python package_command.py <command.md-경로> [출력-디렉토리]
+
+예시:
+    python package_command.py .claude/commands
+    python package_command.py .claude/commands ./dist
+    python package_command.py .claude/commands/review-security.md
+"""
+
+import sys
+import zipfile
+from pathlib import Path
+from quick_validate import validate_command, validate_commands_folder
+
+
+def package_commands(source_path, output_dir=None):
+    """
+    커맨드 파일(들)을 zip 파일로 패키징.
+
+    Args:
+        source_path: 커맨드 파일 또는 커맨드 폴더 경로
+        output_dir: zip 파일 출력 디렉토리 (선택)
+
+    Returns:
+        생성된 zip 파일 경로, 오류 시 None
+    """
+    source_path = Path(source_path).resolve()
+
+    # 소스 존재 확인
+    if not source_path.exists():
+        print(f"❌ 오류: 경로를 찾을 수 없음: {source_path}")
+        return None
+
+    # 단일 파일인지 폴더인지 확인
+    is_folder = source_path.is_dir()
+
+    # 패키징 전 검증
+    print("🔍 커맨드 검증 중...")
+
+    if is_folder:
+        valid, results = validate_commands_folder(source_path)
+        for name, v, message in results:
+            status = "✅" if v else "❌"
+            print(f"  [{status}] {name}: {message}")
+        if not valid:
+            print("\n❌ 검증 실패. 패키징 전에 오류를 수정해주세요.")
+            return None
+        print(f"\n✅ 모든 {len(results)}개 커맨드 검증 완료.\n")
+    else:
+        valid, message = validate_command(source_path)
+        if not valid:
+            print(f"  ❌ 검증 실패: {message}")
+            print("\n패키징 전에 검증 오류를 수정해주세요.")
+            return None
+        print(f"  ✅ {message}\n")
+
+    # 출력 위치 결정
+    if is_folder:
+        zip_name = source_path.name
+    else:
+        zip_name = source_path.stem
+
+    if output_dir:
+        output_path = Path(output_dir).resolve()
+        output_path.mkdir(parents=True, exist_ok=True)
+    else:
+        output_path = Path.cwd()
+
+    zip_filename = output_path / f"{zip_name}-commands.zip"
+
+    # zip 파일 생성
+    try:
+        with zipfile.ZipFile(zip_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
+            if is_folder:
+                # 폴더의 모든 .md 파일 추가
+                for md_file in source_path.glob('**/*.md'):
+                    arcname = md_file.relative_to(source_path.parent)
+                    zipf.write(md_file, arcname)
+                    print(f"  📦 추가: {arcname}")
+            else:
+                # 단일 파일 추가
+                arcname = source_path.name
+                zipf.write(source_path, arcname)
+                print(f"  📦 추가: {arcname}")
+
+        print(f"\n✅ 패키징 완료: {zip_filename}")
+        return zip_filename
+
+    except Exception as e:
+        print(f"❌ zip 파일 생성 오류: {e}")
+        return None
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("사용법: python package_command.py <commands-경로> [출력-디렉토리]")
+        print("\n예시:")
+        print("  python package_command.py .claude/commands")
+        print("  python package_command.py .claude/commands ./dist")
+        print("  python package_command.py .claude/commands/review-security.md")
+        sys.exit(1)
+
+    source_path = sys.argv[1]
+    output_dir = sys.argv[2] if len(sys.argv) > 2 else None
+
+    print(f"📦 커맨드 패키징: {source_path}")
+    if output_dir:
+        print(f"   출력 디렉토리: {output_dir}")
+    print()
+
+    result = package_commands(source_path, output_dir)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/templates/npx/docs/skills/command-creator/scripts/quick_validate.py

@@ -0,0 +1,143 @@
+#!/usr/bin/env python3
+"""
+커맨드 검증 스크립트 - 최소 버전
+"""
+
+import sys
+import re
+from pathlib import Path
+
+
+def validate_command(command_path):
+    """
+    커맨드 파일 기본 검증.
+
+    Args:
+        command_path: .md 커맨드 파일 경로
+
+    Returns:
+        (유효 여부, 메시지) 튜플
+    """
+    command_path = Path(command_path)
+
+    # 파일 존재 확인
+    if not command_path.exists():
+        return False, f"커맨드 파일을 찾을 수 없음: {command_path}"
+
+    # 파일 확장자 확인
+    if command_path.suffix != '.md':
+        return False, "커맨드 파일은 .md 확장자여야 합니다"
+
+    # 파일명 규칙 확인
+    name = command_path.stem
+    if not re.match(r'^[a-z0-9-]+$', name):
+        return False, f"커맨드 이름 '{name}'은 하이픈-케이스여야 합니다 (소문자, 숫자, 하이픈만 허용)"
+
+    if name.startswith('-') or name.endswith('-') or '--' in name:
+        return False, f"커맨드 이름 '{name}'은 하이픈으로 시작/끝나거나 연속된 하이픈을 포함할 수 없습니다"
+
+    if len(name) > 40:
+        return False, f"커맨드 이름 '{name}'이 40자를 초과합니다"
+
+    # 내용 읽기
+    try:
+        content = command_path.read_text()
+    except Exception as e:
+        return False, f"파일 읽기 오류: {e}"
+
+    # 빈 파일 확인
+    if not content.strip():
+        return False, "커맨드 파일이 비어있습니다"
+
+    # frontmatter가 있으면 검증
+    if content.startswith('---'):
+        match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+        if not match:
+            return False, "잘못된 frontmatter 형식 (닫는 --- 누락)"
+
+        frontmatter = match.group(1)
+
+        # 허용된 frontmatter 필드 검증
+        valid_fields = {'description', 'allowed-tools', 'argument-hint', 'model', 'disable-model-invocation'}
+        for line in frontmatter.split('\n'):
+            line = line.strip()
+            if not line or line.startswith('#'):
+                continue
+            if ':' in line:
+                field = line.split(':')[0].strip()
+                if field and field not in valid_fields:
+                    return False, f"알 수 없는 frontmatter 필드: '{field}'"
+
+        # description 확인
+        desc_match = re.search(r'description:\s*(.+)', frontmatter)
+        if desc_match:
+            description = desc_match.group(1).strip()
+            if '<' in description or '>' in description:
+                return False, "description에 꺾쇠괄호(< 또는 >)를 포함할 수 없습니다"
+            if '[TODO' in description:
+                return False, "description에 TODO 플레이스홀더가 있습니다 - 완성해주세요"
+
+        # frontmatter 이후 내용 확인
+        body = content[match.end():].strip()
+        if not body:
+            return False, "커맨드에 frontmatter만 있고 지시사항이 없습니다"
+
+    return True, "커맨드가 유효합니다!"
+
+
+def validate_commands_folder(folder_path):
+    """
+    폴더 내 모든 커맨드 파일 검증.
+
+    Args:
+        folder_path: .md 파일이 포함된 폴더 경로
+
+    Returns:
+        (전체 유효 여부, 결과 리스트) 튜플
+    """
+    folder_path = Path(folder_path)
+
+    if not folder_path.exists():
+        return False, [("folder", False, f"폴더를 찾을 수 없음: {folder_path}")]
+
+    if not folder_path.is_dir():
+        return False, [("path", False, f"경로가 디렉토리가 아님: {folder_path}")]
+
+    # 모든 .md 파일 찾기
+    md_files = list(folder_path.glob('**/*.md'))
+
+    if not md_files:
+        return False, [("folder", False, "폴더에 .md 파일이 없습니다")]
+
+    results = []
+    all_valid = True
+
+    for md_file in md_files:
+        valid, message = validate_command(md_file)
+        results.append((md_file.name, valid, message))
+        if not valid:
+            all_valid = False
+
+    return all_valid, results
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("사용법: python quick_validate.py <command.md 또는 commands-폴더>")
+        sys.exit(1)
+
+    path = Path(sys.argv[1])
+
+    if path.is_file():
+        valid, message = validate_command(path)
+        print(message)
+        sys.exit(0 if valid else 1)
+    elif path.is_dir():
+        all_valid, results = validate_commands_folder(path)
+        for name, valid, message in results:
+            status = "✅" if valid else "❌"
+            print(f"[{status}] {name}: {message}")
+        sys.exit(0 if all_valid else 1)
+    else:
+        print(f"경로를 찾을 수 없음: {path}")
+        sys.exit(1)