Skill Index Snippets (AGENTS.md / CLAUDE.md) 유지 관리
이 스킬을 사용해야 할 때
다음 상황에서 이 스킬을 사용하십시오:
- 이 저장소에서 스킬이나 에이전트를 추가, 제거 또는 이름 변경할 때
.claude-plugin/plugin.json을 업데이트할 때- 다운스트림 저장소(OpenCode, Claude Code 등)용 복사/붙여넣기 스니펫을 만들 때
- 항상 활성화되어 스킬 활용도를 높이는 간결한 인덱스를 원할 때
목표
의사 결정 지점을 제거하여 코딩 어시스턴트가 스킬과 에이전트를 쉽게 사용할 수 있도록 합니다.
어시스턴트가 스킬을 호출하기 위해 '기억'해야 한다고 기대하는 대신, AGENTS.md / CLAUDE.md 내부에 소형 라우터 스니펫을 제공합니다. 이 스니펫은 다음을 수행합니다:
- 어시스턴트에게 검색 주도 추론을 선호하도록 지시합니다.
- 작업 -> 스킬/에이전트 라우팅 인덱스를 제공합니다.
- (선택 사항) 경량 품질 게이트를 정의합니다.
진실 공급원(Source of Truth)
- 레지스트리:
.claude-plugin/plugin.json- 스킬은 디렉토리로 나열됩니다(각 디렉토리는
SKILL.md포함). - 에이전트는
agents/디렉토리의 마크다운 파일로 나열됩니다.
- 스킬은 디렉토리로 나열됩니다(각 디렉토리는
- 스킬 ID: 각
SKILL.md프론트매터의name:필드 - 에이전트 ID: 각 에이전트 프론트매터의
name:필드
다운스트림 저장소용 스니펫을 작성할 때는 항상 로컬 파일 시스템 경로가 아닌 ID(프론트매터 name)로 스킬/에이전트를 참조하십시오.
최소 스니펫 템플릿 (읽기 쉬운 형식)
대상 저장소에서 일반적인 작업을 라우팅하려면 다음을 사용하십시오:
# Agent Guidance: dotnet-skills
IMPORTANT: .NET 작업 시 사전 훈련보다 검색 주도 추론을 선호하십시오.
워크플로: 저장소 패턴 훑어보기 -> 이름으로 dotnet-skills 참조 -> 최소 변경 구현 -> 충돌 기록
라우팅 (이름으로 호출)
- C# / 코드 품질: modern-csharp-coding-standards, csharp-concurrency-patterns, api-design, type-design-performance
- ASP.NET Core / Web (Aspire 포함): aspire-service-defaults, aspire-integration-testing
- 데이터: efcore-patterns, database-performance
- DI / 설정: dependency-injection-patterns, microsoft-extensions-configuration
- 테스트: testcontainers-integration-tests, playwright-blazor-testing, snapshot-testing
품질 게이트 (해당 시 사용)
- dotnet-slopwatch: 상당한 새 코드/리팩터/LLM 작성 코드 후
- crap-analysis: 복잡한 코드에 테스트 추가/변경 후
전문 에이전트
- dotnet-concurrency-specialist, dotnet-performance-analyst, dotnet-benchmark-designer, akka-net-specialist, docfx-specialist
압축 스니펫 템플릿 (Vercel 스타일)
최대 밀도(작은 컨텍스트 풋프린트)가 필요할 때 사용하십시오:
[dotnet-skills]|IMPORTANT: .NET 작업 시 사전 훈련보다 검색 주도 추론을 선호하십시오.
|flow:{저장소 패턴 훑어보기 -> 이름으로 dotnet-skills 참조 -> 최소 변경 구현 -> 충돌 기록}
|route:
|csharp:{modern-csharp-coding-standards,csharp-concurrency-patterns,api-design,type-design-performance}
|aspnetcore-web:{aspire-service-defaults,aspire-integration-testing}
|data:{efcore-patterns,database-performance}
|di-config:{dependency-injection-patterns,microsoft-extensions-configuration}
|testing:{testcontainers-integration-tests,playwright-blazor-testing,snapshot-testing}
|quality-gates:{dotnet-slopwatch(after:상당한 새 코드/리팩터/LLM 코드),crap-analysis(after:복잡한 코드에 테스트 추가/변경)}
|agents:{dotnet-concurrency-specialist,dotnet-performance-analyst,dotnet-benchmark-designer,akka-net-specialist,docfx-specialist}
README 블록 재생성
README에 아래 마커가 포함된 경우, 생성기가 자동으로 업데이트할 수 있습니다:
<!-- BEGIN DOTNET-SKILLS COMPRESSED INDEX -->
...압축 스니펫...
<!-- END DOTNET-SKILLS COMPRESSED INDEX -->
실행:
./scripts/generate-skill-index-snippets.sh --update-readme
스킬 변경 후 스니펫 업데이트 방법
.claude-plugin/plugin.json을 업데이트하여 스킬 및 에이전트를 포함/제거합니다.- 각 스킬에 올바른 프론트매터
name:이 있는지 확인하십시오(OpenCode 등에서 사용됨). ./scripts/validate-marketplace.sh를 실행합니다.- 스니펫 라우팅 목록을 업데이트합니다:
- 새 스킬을 올바른 카테고리에 추가
- 삭제된 스킬 제거
- 이름이 프론트매터 ID와 정확히 일치하는지 확인
- 다운스트림
AGENTS.md/CLAUDE.md스니펫을 유지 관리하는 경우 재생성한 후 종속 저장소에 다시 복사하십시오.
권장 카테고리
다음은 스니펫 카테고리입니다(반드시 저장소 폴더 구조와 일치하지는 않음):
- C# / 코드 품질
- ASP.NET Core / Web (Aspire 포함)
- 데이터
- DI / 설정
- 테스트
- 품질 게이트
- 전문 에이전트
스니펫을 작게 유지하십시오. 라우터 역할이지 문서가 아닙니다.