빌드 6 — 종합 & 체크리스트

한 줄 요약 — “6요소는 따로 노는 부품이 아니라 에이전틱 루프가 소비하는 재료” 입니다. 한 요청이 처리되는 흐름으로 종합하고, 빌드 순서·체크리스트·함정 10선으로 마무리합니다.

1. 한 요청의 처리 흐름 (표준 패턴)

예 — “데이터를 분석해 보고서를 만들고 담당자에게 메일로 보내줘”:

1. 지침 — 상시 규칙 활성: 정확히 계산 · 보내기 전 확인 · 형식은 스킬대로
2. 참고자료 — 연결된 데이터 파일·문서 로드
3. 분석 스킬 — 정확한 계산·표 정리 형식 로드
4. 도구(코드 인터프리터) — RAG가 아니라 전체 데이터를 집계
5. 작성 스킬 — 단일 진실 원천의 형식·디자인 규칙 적용
6. 도구 — 보고서 생성 → 저장소 업로드 → 링크 첨부 메일 초안
7. 지침(HITL) — “수신자·미리보기 확인 후 발송” 게이트
8. 도구 — 사용자 승인 후 발송
9. 메모리 — 세션 대화는 맥락으로, 산출물은 M365에 영구 보관

2. 단계별 담당 요소 한눈에

요청 단계	활성 요소
규칙 적용	지침
데이터 획득	참고자료 + 코드 인터프리터
정확한 집계	분석 스킬
형식·산출	작성 스킬 + 저장 도구
안전한 발송	지침(HITL) + 메일 도구
맥락 지속	메모리

보충 — 이 모든 판단·실행의 추론 엔진이 모델입니다(빌드 5). 요청마다 도는 단계는 아니지만 전 단계의 품질·속도를 결정합니다.

3. 권장 빌드 순서

1. 지침 먼저 — 역할·가드레일·HITL을 평문으로 짧게
2. 참고자료 연결 — Excel·Word를 SharePoint에 올리고 Knowledge로 연결
3. 핵심 스킬 하나 — 가장 중요한 작업부터 단일 파일로
4. 최소 도구 — 코드 인터프리터 + 시나리오에 꼭 필요한 커넥터·MCP만
5. 스킬 확장 — 품질이 중요한 지점에 템플릿·리소스 투입
6. 필요할 때만 분리 — 복잡도가 요구할 때만 연결된 에이전트로

FAQ — “처음부터 다 만들어야 하지 않나?” → 아니오. 지침 + 스킬 하나 + 최소 도구로 시작해 테스트하고, 막히는 지점에서만 도구·스킬·에이전트를 추가하는 문제 주도 확장이 정석입니다. (MS Learn 권장 흐름도 같습니다: Define → Connect → Enable → Enhance → Review → Test.)

4. 빌드 체크리스트

• 지침은 짧고 “무엇을”만 담았는가 (구현 세부 없음)
• 디자인 값·절차는 지침이 아니라 스킬에 있는가 (단일 진실 원천)
• 되돌릴 수 없는 행동(발송)에 확인 게이트가 있는가
• 모든 스킬에 name·description(YAML)이 있는가
• description에 명확한 트리거 키워드가 있는가
• SKILL.md가 zip 루트에 있는가 (폴더째 압축 금지)
• 스킬 name이 소문자·숫자·하이픈만인가
• 핵심 디자인 규칙이 SKILL.md 본문에 있는가 (리소스는 자동 주입 안 됨)
• 도구는 최소인가 (중복 없음 · 코드로 되는 일에 커넥터 없음)
• 숫자는 Excel로, 문구·형식은 Word로 분리했는가

보충 — Preview로 테스트하고 Evaluate로 품질을 측정했는가 · 모델은 작업 난이도에 맞는가(실험·프리뷰 모델을 프로덕션에 쓰지 않는가)

5. 자주 겪는 함정 10선

함정	증상	해결
zip 구조 오류	“missing root-level SKILL.md”	폴더가 아니라 내용물을 압축
스킬 이름 규칙 위반	“Name must use only lowercase…”	name은 소문자·숫자·하이픈만
같은 이름 재업로드	삭제 후 재업로드해도 구버전 인식	-v2 새 이름 + Preview 확인
부분 업로드(프리뷰)	UI는 정상, 실제론 YAML만 배포	Sandbox 환경에서 개발 · app/skills 프롬프트 검증
세부를 리소스에만	규칙 없이 임의 적용	핵심 규칙은 SKILL.md 본문에
색상을 지침에	스킬 건너뜀 · 디자인 붕괴	지침은 스킬을 가리키기만
그라디언트 단독 배경	메일에서 흰 글씨 안 보임	흰 글씨 뒤엔 단색 bgcolor
파일 직접 첨부	Base64 토큰 폭발·실패	OneDrive 업로드 후 링크 첨부
중복 도구	도구 선택 혼란	목적당 하나
과설계	비대한 지침·복잡한 멀티에이전트	단순하게 시작, 막힐 때만 확장

한 줄 원칙

컨텍스트는 유한 자원. “원하는 결과를 낼 가장 작은 고신호 토큰 집합“을 유지하세요 — 항상 필요한 것은 지침, 나머지는 필요할 때 스킬·도구·참고자료로.

🧪 이 세션의 실습 → 실습 ⑥ — 통합 테스트

---

M2 빌드로 → 다음 모듈: M3. 실습

출처: 2부 · 종합 & 체크리스트 (Agentic Blog) · Effective context engineering (Anthropic) · Build an agent (MS Learn)