심화 실습 — 보고서 양식 스킬 (동반 파일·참조 문서)

목표 — 스킬에 동반 파일(companion files) 을 붙여, 조직 양식·용어집 같은 참조 자료를 스킬이 필요할 때 로드하게 만듭니다. ⏱ 약 15분 · 사용 기능: OneDrive skills 폴더 · 동반 파일

배경 — 왜 동반 파일인가

지침에 모든 걸 넣으면 SKILL.md가 비대해집니다. 공식 가이드의 로딩 3계층:

계층	로드 시점	크기 목표
frontmatter (name+description)	항상 (세션 시작)	~100 토큰
SKILL.md 본문	스킬 발동 시	1,500~2,000 단어
references/ 참조 파일	필요할 때만	제한 없음(파일당 5MB)

본문은 워크플로만, 세부 기준은 references로 — 컨텍스트를 아끼는 설계입니다.

실습 1 — 참조 파일 추가

1. OneDrive /Documents/Cowork/skills/weekly-report/에 references 폴더 생성

2. references/report-style.md 생성:

   # 보고서 스타일 기준
   - 제목: "주간 업무 보고서 — YYYY-MM-DD"
   - 어조: 간결한 개조식, 존댓말 종결 없이
   - 완료/진행 항목: "프로젝트명 — 내용 (상태)" 형식
   - 리스크 표 열: 리스크 | 영향 | 대응 | 담당
   

3. SKILL.md 본문 끝에 참조 안내 추가:

   ## Additional Resources
   - `references/report-style.md` — 보고서 스타일·표 형식 기준
   

실습 2 — 스타일 반영 확인

1. 새 세션 → 주간 보고서 만들어줘
2. • 제목·리스크 표 열 구성이 report-style.md 기준대로 나오는지 확인
3. 스타일 파일만 수정해 재실행 — 지침과 스타일의 분리가 주는 유지보수성 체감

✅ 완료 기준 — 스킬 본문은 그대로 두고 참조 파일 수정만으로 산출물 형식이 바뀐다.

💡 한도: 동반 파일 20개/스킬 · 파일당 5MB · 스킬당 총 10MB. 숨김 파일·절대 경로·.. 불가 — M5-2의 검증 규칙 참고.

출처

출처: Build plugins for Copilot Cowork — companion files (MS Learn) · Use Copilot Cowork (MS Learn)