SOURCE SUMMARY
원문 핵심 요약
Gigi Sayfan의 Claude Code 실습 글 · 2026년 1월 공개판
작업에 맞춰 불러오는 지식 모듈
저자는 모든 지침을 상시 넣는 대신 목적별 스킬을 필요할 때 불러오는 방식을 설명한다.
정의
스킬 폴더는 이름·설명을 담은 SKILL.md와 선택적인 스크립트·문서·템플릿으로 구성된다.
단계적 로딩
처음에는 이름과 설명을 읽고, 선택되면 본문과 필요한 참조 파일을 불러온다.
실행 연결
이미지 생성 예제에서 지침을 읽은 에이전트가 Python 스크립트를 실행해 파일을 저장한다.
지침과 실행 도구를 조합한 저자 실습이며 비교 성능 실험은 아니다.
재사용을 위한 설계
작고 명확한 단위
관련 지침만 선택하고 여러 프로젝트에서 다시 쓸 수 있도록 스킬의 범위를 좁게 유지한다.
원문이 강조하는 두 가지 조건
설명이 선택을 유도
이름만큼 중요한 사용 조건
에이전트가 언제 스킬을 불러올지 판단하도록 설명을 구체화한다.
호환 범위 구분
공통 형식과 제품 확장
저자는 Agent Skills 공통 범위와 Claude Code 확장을 구분하며 공통 범위 사용을 이식성의 조건으로 제시한다.
스크립트와 템플릿으로 지침을 실행에 연결하는 방식이다.
APPLICATION PROPOSAL
별도의 적용 제안
검토 지침을 재사용하는 스킬 시범
R&D 시험 결과 검토 보조를 한 작업으로 분리
우리의 제안 · 승인된 시험 보고서 형식 검토
읽기 전용 입력과 격리된 출력 폴더 사용
작업 경계 정의
필수 항목·단위·출처 확인 등 기존 검토 기준을 짧은 지침으로 정리한다.
스킬 구성
사용 조건·금지 동작·출력 형식을 적고 필요한 검증 스크립트만 연결한다.
선택과 실행 시험
적용 대상과 비대상 요청을 섞어 스킬 선택 및 결과를 확인한다.
담당자 검토
누락·오탐·검토 시간을 확인한 뒤 버전을 고정하고 사용 범위를 승인한다.
재사용성과 통제의 지표
선택 적합률
시험 요청 중 필요한 스킬을 올바르게 선택한 비율
검토 정확도
확인된 누락 탐지와 오탐을 각각 기록
검토 소요 시간
수동 검토와 AI 보조 검토의 총 시간을 비교
재현 일치율
같은 입력·버전에서 기준 결과와 일치한 비율
지침과 실행 권한을 함께 관리
기준 체계 유지
Teamcenter·PDM·ERP와 확립된 M-BOM 기준을 변경하지 않음
코드·출처 검토
외부 스킬과 스크립트는 승인된 출처·의존성만 사용
최소 권한
운영 시스템 쓰기 권한과 비밀정보 접근은 시범 범위에서 제외
승인·이력
지침 버전과 실행 근거를 기록하고 릴리스는 담당자가 승인
- 검토 기준·범위 확정
- 격리 환경 사례 시험
- 오탐·권한 검토
- 승인 버전으로 제한 적용