빌더 에이전트 가이드

---
# 공식 필드 (Official Fields)
name: my-custom-skill # 스킬 식별자 (kebab-case, 최대 64자)
description: > # 목적 설명 (50~1024자, 3인칭)
  커스텀 스킬의 설명. 어떤 작업에 사용하는지, 어떤 전문 지식을 제공하는지
  3인칭으로 작성.
allowed-tools: # 허용 도구 (쉼표 구분 또는 리스트)
  - Read
  - Grep
  - Glob
model: claude-sonnet-4-20250514 # 사용할 모델 (생략 시 현재 모델)
context: fork # 서브 에이전트 컨텍스트에서 실행
agent: general-purpose # context: fork 시 사용할 에이전트
hooks: # 스킬 수명 주기 훅
  PreToolUse: ...
user-invocable: true # 슬래시 명령 메뉴 표시 여부
disable-model-invocation: false # false면 Claude도 직접 호출 가능
argument-hint: "[issue-number]" # 자동완성 힌트
 
# MoAI-ADK 확장 필드 (Extended Fields)
version: 1.0.0 # 시맨틱 버전 (MAJOR.MINOR.PATCH)
category: domain # 8개 카테고리 중 택 1
modularized: false # modules/ 디렉토리 사용 여부
status: active # active | experimental | deprecated
updated: "2025-01-28" # 마지막 수정일
tags: # 발견용 태그 배열
  - graphql
  - api
related-skills: # 연관 스킬
  - moai-domain-backend
  - moai-lang-typescript
context7-libraries: # MCP Context7 라이브러리 ID
  - graphql
aliases: # 대체 이름
  - graphql-expert
author: YourName # 작성자
---

.claude/skills/my-skills/
└── my-graphql-patterns/
    ├── SKILL.md            # 메인 스킬 문서 (500줄 이하)
    ├── modules/            # 심층 문서 (무제한)
    │   ├── schema-design.md
    │   └── resolver-patterns.md
    ├── examples.md         # 실전 예시
    └── reference.md        # 외부 참조

---
# YAML
---
 
# 프로젝트 정보
 
프로젝트 이름: !basename $(pwd) Git 브랜치: !git branch --show-current

# Claude Code에서 builder-skill 호출
> GraphQL API 설계 패턴에 대한 커스텀 스킬을 만들어줘

---
name: my-graphql-patterns
description: >
  GraphQL API 설계 전문가. 스키마 설계, 리졸버 패턴, N+1 문제 해결, DataLoader
  패턴을 제공한다. GraphQL API 개발 시 사용.
version: 1.0.0
category: domain
status: active
triggers:
  keywords: ["graphql", "schema", "resolver", "dataloader"]
  agents: ["expert-backend"]
allowed-tools: ["Read", "Grep", "Glob"]
---
 
# GraphQL API 설계 전문가
 
## Quick Reference
 
- 스키마 우선 설계 (Schema-First)
- N+1 문제 방지를 위한 DataLoader 필수
- 페이지네이션은 Relay Cursor 방식 사용
 
## Implementation Guide
 
(상세 구현 가이드)
 
## Advanced Patterns
 
(고급 패턴)
 
## Works Well With
 
- moai-domain-backend
- moai-lang-typescript

---
name: my-data-analyst
description: >
  데이터 분석 전문가. 데이터 파이프라인 설계, ETL 프로세스, 분석 쿼리 최적화를
  담당. PROACTIVELY 사용하여 데이터 분석 작업 시 자동 위임.
tools: Read, Write, Edit, Grep, Glob, Bash, TodoWrite
disallowedTools: Task, Skill # 선택사항: 제외할 도구
model: sonnet # sonnet | opus | haiku | inherit
permissionMode: default # 권한 모드
skills: # 사전 로드할 스킬
  - moai-lang-python
  - moai-domain-database
hooks: # 에이전트 수명 주기 훅
  PostToolUse:
    - matcher: "Write|Edit"
      hooks:
        - type: command
          command: "echo 'File modified'"
---
 
당신은 데이터 분석 전문가입니다.
 
## Primary Mission
 
데이터 파이프라인 설계 및 구현을 통해 데이터 기반 인사이트를 제공합니다.
 
## Core Capabilities
 
- 데이터 파이프라인 설계 및 구현
- ETL 프로세스 자동화
- 분석 쿼리 최적화
- 데이터 시각화
 
## Scope Boundaries
 
IN SCOPE:
 
- 데이터 분석 및 시각화
- ETL 프로세스 설계
- 쿼리 성능 최적화
 
OUT OF SCOPE:
 
- ML 모델 개발 (expert-data-science에 위임)
- 인프라 구성 (expert-devops에 위임)
 
## Delegation Protocol
 
- ML 모델 필요시: expert-data-science
- 인프라 설정시: expert-devops
 
## Quality Standards
 
- TRUST 5 프레임워크 준수
- 데이터 무결성 검증
- 쿼리 성능 최적화

my-plugin/
├── .claude-plugin/
│   └── plugin.json         # 플러그인 매니페스트
├── commands/               # 슬래시 명령어 (루트 레벨!)
│   └── analyze.md
├── agents/                 # 에이전트 정의 (루트 레벨!)
│   └── data-expert.md
├── skills/                 # 스킬 정의 (루트 레벨!)
│   └── my-skill/
│       └── SKILL.md
├── hooks/                  # Hooks 설정 (루트 레벨!)
│   └── hooks.json
├── .mcp.json               # MCP 서버 설정
├── .lsp.json               # LSP 서버 설정
├── LICENSE
├── CHANGELOG.md
└── README.md

{
  "name": "my-data-plugin",
  "version": "1.0.0",
  "description": "데이터 분석 작업을 위한 종합 플러그인",
  "author": {
    "name": "My Team",
    "email": "[email protected]",
    "url": "https://example.com"
  },
  "homepage": "https://example.com/docs",
  "repository": {
    "type": "git",
    "url": "https://github.com/owner/repo"
  },
  "license": "MIT",
  "keywords": ["data", "analytics", "etl"],
  "commands": ["./commands/"],
  "agents": ["./agents/"],
  "skills": ["./skills/"],
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json",
  "lspServers": "./.lsp.json",
  "outputStyles": "./output-styles/"
}

{
  "name": "my-marketplace",
  "owner": {
    "name": "My Organization",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "plugin-one",
      "source": "./plugins/plugin-one"
    },
    {
      "name": "plugin-two",
      "source": {
        "type": "github",
        "repo": "owner/repo"
      }
    }
  ]
}

# GitHub에서 플러그인 설치
$ /plugin install owner/repo
 
# 로컬 플러그인 검증
$ /plugin validate .
 
# 플러그인 활성화
$ /plugin enable my-data-plugin
 
# Marketplace 추가
$ /plugin marketplace add ./path/to/marketplace
 
# 설치된 플러그인 목록
$ /plugin list

# 플러그인 생성 요청
> 데이터 분석 플러그인을 만들어줘.
> 스킬, 에이전트, 명령어를 모두 포함해줘.

# 스킬 생성
> @"builder-skill (agent)" GraphQL 패턴에 대한 커스텀 스킬을 만들어줘
 
# 에이전트 생성
> @"builder-agent (agent)" 데이터 분석 전문가 에이전트를 만들어줘
 
# 플러그인 생성
> @"builder-plugin (agent)" 데이터 분석 종합 플러그인을 만들어줘