# 클로드 하네스를 구성 스킬

> https://bookfactory.kr/board/publishers/28972
> 게시판: 출판사 공지수집
> 작성자: admin
> 작성일: 2026-05-04 14:08:14

---

```
---
name: harness
description: \"하네스를 구성합니다. 전문 에이전트를 정의하며, 해당 에이전트가 사용할 스킬을 생성하는 메타 스킬. (1) '하네스 구성해줘', '하네스 구축해줘' 요청 시, (2) '하네스 설계', '하네스 엔지니어링' 요청 시, (3) 새로운 도메인/프로젝트에 대한 하네스 기반 자동화 체계를 구축할 때, (4) 하네스 구성을 재구성하거나 확장할 때 사용.\"
---

# Harness — Agent Team & Skill Architect

도메인/프로젝트에 맞는 하네스를 구성하고, 각 에이전트의 역할을 정의하며, 에이전트가 사용할 스킬을 생성하는 메타 스킬.

**핵심 원칙:**
1. 에이전트 정의(`.claude/agents/`)와 스킬(`.claude/skills/`)을 생성한다.
2. **에이전트 팀을 기본 실행 모드로 사용한다.**

## 워크플로우

### Phase 1: 도메인 분석
1. 사용자 요청에서 도메인/프로젝트 파악
2. 핵심 작업 유형 식별 (생성, 검증, 편집, 분석 등)
3. 기존 에이전트/스킬 확인 (충돌/중복 방지)
4. 프로젝트 코드베이스 탐색
5. **사용자 숙련도 감지** — 대화 맥락으로 기술 수준 파악

### Phase 2: 팀 아키텍처 설계
- 기본값: 에이전트 팀 (2개+ 에이전트 협업)
- 패턴: 파이프라인, 팬아웃/팬인, 전문가풀, 생성-검증, 감독자, 계층적위임
- 분리 기준: 전문성·병렬성·컨텍스트·재사용성
- 상세: `references/agent-design-patterns.md`

### Phase 3: 에이전트 정의 생성
- **반드시** `.claude/agents/{name}.md` 파일로 정의
- 빌트인 타입도 파일 생성 필수
- 모든 에이전트 `model: \"opus\"` 사용
- 필수 섹션: 핵심역할, 작업원칙, 입출력프로토콜, 에러핸들링, 협업
- 상세: `references/team-examples.md`

### Phase 4: 스킬 생성
- `.claude/skills/{name}/skill.md` 에 생성
- Description: 적극적(\"pushy\") 트리거 유도
- 본문: Why 설명, 500줄 이내, 명령형
- Progressive Disclosure: metadata → skill.md → references/
- 상세: `references/skill-writing-guide.md`

### Phase 5: 통합 및 오케스트레이션
- 에이전트팀: TeamCreate + TaskCreate + SendMessage
- 서브에이전트: Agent 도구 직접 호출
- 데이터 전달: 메시지/태스크/파일 기반
- `_workspace/` 폴더에 중간 산출물 저장
- 상세: `references/orchestrator-template.md`

### Phase 6: 검증 및 테스트
- 구조 검증 (파일 위치, frontmatter)
- With/Without 비교 실행
- 트리거 검증 (should/should-NOT trigger)
- 드라이런 테스트
- 상세: `references/skill-testing-guide.md`

## 산출물 체크리스트
- [ ] `.claude/agents/` — 에이전트 정의 파일
- [ ] `.claude/skills/` — 스킬 파일들
- [ ] 오케스트레이터 스킬 1개
- [ ] 실행 모드 명시
- [ ] `model: \"opus\"` 파라미터
- [ ] `.claude/commands/` — 없음
- [ ] 스킬 description 적극적 작성
- [ ] 500줄 이내, 초과시 references/ 분리

## 참고
- `references/agent-design-patterns.md` — 6가지 패턴
- `references/team-examples.md` — 5가지 실전 예시
- `references/orchestrator-template.md` — 오케스트레이터 템플릿
- `references/skill-writing-guide.md` — 스킬 작성 가이드
- `references/skill-testing-guide.md` — 테스트 방법론
- `references/qa-agent-guide.md` — QA 에이전트 가이드

```