스킬 가이드

# 스킬 프론트매터에서 트리거 정의
triggers:
  keywords: ["api", "database", "authentication"] # 키워드 매칭
  agents: ["manager-spec", "expert-backend"] # 에이전트 호출 시
  phases: ["plan", "run"] # 워크플로우 단계
  languages: ["python", "typescript"] # 프로그래밍 언어

# Claude Code에서 스킬 호출
> Skill("moai-lang-python")
> Skill("moai-domain-backend")
> Skill("moai-library-mermaid")

.claude/skills/
├── moai-foundation-core/       # Foundation 카테고리
│   ├── skill.md                # 메인 스킬 문서 (500줄 이하)
│   ├── modules/                # 심층 문서 (무제한)
│   │   ├── trust-5-framework.md
│   │   ├── spec-first-ddd.md
│   │   └── delegation-patterns.md
│   ├── examples.md             # 실전 예시
│   └── reference.md            # 외부 참조 링크
│
├── moai-lang-python/           # Language 카테고리
│   ├── skill.md
│   └── modules/
│       ├── fastapi-patterns.md
│       └── testing-pytest.md
│
└── my-skills/                  # 사용자 커스텀 스킬 (업데이트 제외)
    └── my-custom-skill/
        └── skill.md

---
name: moai-lang-python
description: >
  Python 3.13+ 개발 전문가. FastAPI, Django, pytest 패턴 제공. Python API, 웹
  앱, 데이터 파이프라인 개발 시 사용.
version: 3.0.0
category: language
status: active
triggers:
  keywords: ["python", "fastapi", "django", "pytest"]
  languages: ["python"]
allowed-tools: ["Read", "Grep", "Glob", "Bash", "Context7 MCP"]
---
 
# Python 개발 전문가
 
## Quick Reference
 
(빠른 참조 - 30초)
 
## Implementation Guide
 
(구현 가이드 - 5분)
 
## Advanced Patterns
 
(고급 패턴 - 10분+)
 
## Works Well With
 
(연관 스킬/에이전트)

# 1. 사용자가 API 개발을 요청
> FastAPI로 사용자 인증 API를 만들어줘
 
# 2. MoAI-ADK가 자동으로 감지하는 키워드
# "FastAPI" → moai-lang-python 트리거
# "인증"    → moai-domain-backend 트리거
# "API"     → moai-domain-backend 트리거
 
# 3. 자동 로드되는 스킬
# - moai-lang-python (Level 2): FastAPI 패턴, pytest 테스트
# - moai-domain-backend (Level 2): API 설계 패턴, 인증 전략
# - moai-foundation-core (Level 1): TRUST 5 품질 기준
 
# 4. 에이전트가 스킬 지식을 활용하여 구현
# - FastAPI 라우터 패턴 적용
# - JWT 인증 모범 사례 적용
# - pytest 테스트 자동 생성
# - TRUST 5 품질 기준 충족