Skill Based Prompt Example

---
title: "AI 학습 공동체에 Agent 가 스며드는 과정: ai-seminar 의 3 층 진화"
subtitle: "지식 축적이 병목이 될 때 Prompt → Context → Harness 가 차례로 필요해지고, 그 결과 /qa 스킬이 표면 인터페이스로 드러난다"
description: |
  ai-seminar 는 팀이 AI 관련 지식·역량을 축적·공유하기 위한 학습 공동체다. 자료가 쌓이면서
  "이 내용이 어디에 있더라" 가 반복되자 Agent 를 보조 도구로 들였고, 그 Agent 가 일관되게
  작동하려면 Prompt·Context·Harness 세 층이 차례로 필요해졌다. /qa 스킬은 그 구조 위에서
  학습자의 가장 빈번한 행위 (자료 기반 질문) 에 대응해 자연스럽게 드러난 표면 인터페이스다.
  이 글은 "QA 도구를 만드는 과정" 이 아니라 "학습 공동체에 Agent 가 스며드는 과정" 을 세 층의
  emergence 로 재구성한다.
tags: [engineering, tools, prompt-engineering, context-engineering, harness-engineering, skill-based-prompt, claude-code, ai-seminar, learning-community]
author: Kwangmin Kim
date: 04/16/2026
---

## 이 글의 목적

이전 포스트에서 Prompt · Context · Harness 세 층위를 동심원 구조로 정의했다.   
이 글은 그 세 층이 **왜, 어떤 순서로, 어떤 필요에 의해 만들어지는지**를 이 프로젝트(`ai-seminar`) 의 실제 발전 과정으로 보여준다. 

이 프로젝트의 목적은 **AI 학습 공동체**를 형성하기 위한 지식 보관용 저장소로 사용하는 것이다.   
- 팀원이 AI 관련 지식·역량을 함께 쌓고 공유하는 것이 목표이다. 
- 이 프로젝트의 편의성과 효율성을 높이기 위해 다음과 같은 체계적인 작업 과정을 제안한다.

**목적**은 AI 학습 공동체 형성,  
**주요 수단**은 Agent,  
**Agent 의 구조적 조건**이 3 층이다.

> "목표: 팀원들이 학습 공동체로서 AI 관련 지식을 쌓고 공유하는 시스템을 구축한다."

## 단계 0: 프로젝트의 실제 출발점 — 자료 아카이빙

`ai-seminar`  리포지토리 생성의 출발 동기

> "팀원들이 AI 관련 지식·역량을 함께 쌓고 공유하자."

어떻게?:  
- 논문 PDF 수집  
- 개념 정리 노트 작성  
- 튜토리얼·실습 코드 축적  

자료가 몇 편일 때는 Agent 가 필요하지 않다. 팀원이 직접 읽고, 서로 묻고, 답한다. 
이때, 프로젝트는 그냥 **공유 폴더**다.

자료가 수십 편을 넘어가면서 학습자 행위 패턴이 눈에 띈다.  
- "이 내용이 어디 있더라?" 라고 묻는 횟수가 급증한다  
- 같은 질문이 반복되는데 매번 누군가 다시 찾는다  
- 최신 자료가 어떤 건지 추적이 어렵다  
- 새 팀원이 들어오면 **어디서부터 읽어야 할지** 안내하기 번거롭다  

[**문제 정의**] 
- 학습 공동체의 병목은 **"자료는 있는데 찾고 이해하는 비용이 크다"** 는 것. 
- **Agent가 학습의 편의를 증가시키도록 시스템을 구축하자**

> 첫 목표 타깃은 **학습자가 가장 많이 하는 행위**: "이 자료에 이런 내용이 있나? / 이 개념이 어떤 문서에서 설명되나?"

즉,  **자료 기반 질의응답**스킬을 만든다.

"그럼, Agent 가 자료 기반 질문에 답하게 하려면 무엇이 필요한가?" 

## 단계 1: Prompt Engineering — Agent 에게 "어떻게 답하라" 를 지시

### 학습 공동체 관점의 필요

학습자마다 Agent 에게 같은 질문을 던져도 **답변 스타일·포맷·인용 형식이 제각각** 이면 공유·축적이 어렵다.   
팀의 지식 자산으로 남기려면 Agent 답변에 **일관된 포맷**이 필요하다.  
예를 들어, "결론 → 근거 → 한계" 구조로 답하게 하면, 학습자가 답변을 **학습 노트로 축적하기 편하다**.  

### 무엇을 했나: 시스템 프롬프트 하나를 정교하게 설계한다.