작동하는 AI 작업을 재사용 가능한 스킬로 전환하는 방법

사용할 수 있는 GitHub 주간 보고서가 있으면, 다음 보고서도 같은 규칙을 따르길 원할 것입니다: 병합 날짜로 필터링하고, 소스 링크를 유지하며, 누락된 맥락을 드러내는 것입니다. 이러한 규칙을 저장하면 매주 긴 대화를 복사하는 것보다 재사용하고 검토하기가 더 쉬워집니다.

Leina에서는 검증된 워크플로를 스킬로 패키징할 수 있습니다. 스킬은 공개된 Agent Skills 명세를 따르는 구조화된 SKILL.md 파일입니다. 매주 월요일마다 팀의 보고 표준을 다시 설명하는 대신, 현재 저장소, 날짜, 시간대, 그리고 작업에 필요한 대상을 제공하면 됩니다.

이미 확인한 보고서를 시작점으로 사용하세요. GitHub-to-Notion 워크스루는 보고서를 준비하고 검토하는 방법을 보여줍니다.

변경되는 입력과 표준 규칙 분리

신뢰할 수 있는 스킬은 이번 실행을 위한 입력과 재사용할 규칙을 분리합니다.

이번 실행을 위한 입력	SKILL.md에 저장된 규칙
대상 저장소 또는 저장소 목록	정확한 필터 규칙 (병합 타임스탬프 vs. 종료 날짜)
보고 기간과 시간대	출처 인용 요구사항 (PR 링크와 작성자 포함)
쓰기 작업을 위한 Notion 대상 페이지 URL	증거 규칙 (누락된 맥락을 미문서화로 표시)
의도된 독자 / 세부 수준	쓰기 지침 (요청된 범위를 존중하고 기존 콘텐츠 확인)

자격 증명과 액세스 토큰은 절대 스킬 파일에 포함되어서는 안 됩니다. Leina는 승인된 연결을 통해 접근을 관리합니다. 스킬은 에이전트가 사용자 환경에서 사용 가능한 도구를 어떻게 사용해야 하는지를 정의할 뿐입니다.

`SKILL.md` 파일 구조화

SKILL.md 파일은 YAML 프론트매터와 Markdown 지침으로 구성됩니다. 이 스타터는 사용 가능한 도구로 적응하고 테스트하기 위한 예시이며, 사용자의 계정에 대해 실행된 적이 없습니다.

---
name: weekly-pr-report
description: 지정된 저장소와 기간에 대해 출처가 연결된 주간 GitHub 풀 리퀘스트 보고서를 준비하고, 선택적으로 승인된 Notion 쓰기를 수행합니다. 엔지니어링 상태 보고서에 사용하며, 코드 리뷰나 개인 생산성 평가에는 사용하지 않습니다.
---

# 주간 PR 보고서

에이전트 환경에서 사용 가능한 도구로 적응하고 평가하기 위한 예시 지침입니다. 이 파일은 커넥터를 설치하거나 계정 접근 권한을 부여하지 않습니다.

## 입력

요청에서 저장소 목록, 시간대가 포함된 보고 기간, 의도된 독자를 확인합니다. 보고서를 변경할 누락된 범위가 있으면 요청합니다. Notion 쓰기의 경우 정확한 페이지, 보고서 제목, 사용자가 추가를 원하는지 교체를 원하는지도 확인합니다.

현재 환경에서 노출된 승인된 GitHub 읽기를 사용합니다. 해당 작업을 사용할 수 없으면 누락된 기능을 보고합니다. 커넥터 작업 ID나 검색된 레코드를 절대 만들어내지 마세요.

## 선택 및 요약

- 병합 타임스탬프가 요청된 기간 내에 있는 병합된 PR을 포함합니다. 종료되었지만 병합되지 않은 레코드와 병합된 작업을 구분합니다.
- 요청된 경우에만 검색 시점을 표시한 별도의 현재 열린 PR 스냅샷을 포함합니다. 현재 상태를 과거 상태로 제시하지 마세요.
- 지원되는 경우 범위 내의 모든 결과 페이지를 검색합니다. 사용할 수 없는 레코드, 잘린 결과 또는 실패한 쿼리를 공개합니다. 불완전한 쿼리는 결과가 0인 쿼리가 아닙니다.
- PR URL, 번호, 제목, 작성자, 상태 및 관련 타임스탬프를 유지합니다. 도구에서 사용할 수 있는 PR 설명과 변경 사항을 바탕으로 요약합니다.
- 영향, 배포, 차단 요소 및 다음 작업 소유자는 증거가 뒷받침하는 경우에만 설명합니다. 작성자를 기본적으로 다음 작업 소유자로 간주하지 마세요.
- 선택된 범위, 보고서 섹션, 소스 링크 및 미해결 질문을 반환합니다. 세부 수준을 의도된 독자에 맞춥니다.

## 선택적 Notion 쓰기

초안 요청은 초안을 반환합니다. 사용자가 구체적인 대상과 작업을 승인한 경우에만 쓰기합니다. 반복적인 확인을 요구하기보다 기존 승인을 유지합니다.

추가하기 전에 보고서 제목이 있는지 확인합니다. 보고서가 이미 존재하고 교체가 승인되지 않은 경우, 해당 위치를 반환하고 어떻게 진행할지 질문합니다. 관련 없는 콘텐츠를 보존합니다.

쓰기 후 지원되는 경우 해당 섹션을 다시 읽고 위치를 반환합니다. 쓰기 결과가 불확실한 경우 재시도하기 전에 대상을 검사합니다. 검증을 사용할 수 없는 경우 쓰기가 확인되었다고 주장하기보다 그 한계를 보고합니다.

동일한 weekly-pr-report SKILL.md 다운로드하여 팀의 필드에 맞게 사용자 정의하세요.

파일에서 유지할 가치가 있는 세 가지 선택:

집중된 설명: 스킬이 언제 유용한지 명시합니다. 검색과 호출은 에이전트 환경에 따라 달라집니다.
명시적 선택 규칙: 병합 시간이 완료된 작업 섹션에 어떤 PR이 속하는지 결정합니다.
정의된 쓰기 범위: 지침은 에이전트에게 기존 콘텐츠를 확인하고 요청된 작업을 존중하도록 요청합니다. 지침은 행동을 안내하고, 권한은 접근을 강제합니다.

배포 전 엣지 케이스 테스트

팀과 스킬을 공유하기 전에 다른 주 또는 저장소에 대해 실행하고 출력을 소스 레코드와 비교하세요. 다음 사례를 시도해 보세요:

테스트 시나리오	예상 에이전트 동작
병합된 PR이 0개인 조용한 주	완전한 쿼리 후 0을 보고하며, 하이라이트를 만들어내거나 오래된 PR을 가져오지 않습니다.
기간에서 1분 벗어나 병합된 PR	병합 섹션에서 제외됩니다.
종료되었지만 병합되지 않은 PR	병합된 작업에서 제외됩니다.
설명이 없는 PR (예: “bump version”)	원시 변경 사항을 요약하고 영향을 미문서화로 명시적으로 표시합니다.
Notion에 대상 제목이 이미 존재	기존 섹션을 확인하고 승인된 작업을 따르며, 교체가 승인되지 않은 경우 어떻게 진행할지 질문합니다.
접근할 수 없는 저장소 또는 페이지	저장소가 비어 있는 척하지 않고 누락된 권한을 명확히 보고합니다.

에이전트가 두 번째 실행에서 이전 날짜를 반복하면 날짜 범위가 지침에 하드코딩되지 않았는지 확인하세요. 고객 영향을 환각하면 요약 규칙을 강화하세요.

팀과 공유 및 자동화

두 번째 실행을 확인한 후, 스킬 패키지의 설치 지침이나 에이전트 환경에서 지원하는 가져오기 메커니즘을 따르세요. 파일만 다운로드한다고 설치되지는 않습니다. 디렉터리 워크플로는 Leina와 함께 스킬 사용을 참조하세요.

대화형 사용: 팀원이 채팅에서 자연스럽게 호출할 수 있습니다: “@Leina가 America/Los_Angeles 시간대로 2026년 9월 28일부터 10월 4일까지 backend/api에 대한 weekly-pr-report를 실행해 줘. 여기에 초안을 반환해 줘.”
권한: 각 팀원은 GitHub 연결을 사용할 권한이 필요하며, 보고서를 저장할 때는 Notion 연결도 필요합니다. 연결에서 해당 계정을 확인하세요.
예약 실행: 시간대, 보고 기간, 전달 위치를 포함한 반복 작업을 요청하세요. Leina가 설정한 일정을 확인하고 첫 번째 예약 출력을 검토하세요. 스킬을 저장한다고 일정이 생성되지는 않습니다.

확인된 파일을 필요한 Apps, 샘플 보고서, 버전 또는 개정 날짜와 함께 공유하세요. 팀이 보고 규칙을 변경하면 해당 파일을 업데이트하고 다른 실행을 확인하세요.

변경되는 입력과 표준 규칙 분리

SKILL.md 파일 구조화

배포 전 엣지 케이스 테스트

팀과 공유 및 자동화

`SKILL.md` 파일 구조화