plugin-settings
YAML 프론트매터 패턴으로 플러그인 설정 구성
Auch verfügbar von: anthropics,davila7
플러그인 설정은 .claude/plugin-name.local.md 파일에 YAML 프론트매터와 마크다운을 사용하여 저장할 수 있습니다. 이 패턴은 복잡한 데이터베이스나 구성 파일 없이도 프로젝트별 플러그인 구성, 상태 유지 및 사용자 정의 동작을 가능하게 합니다.
Die Skill-ZIP herunterladen
In Claude hochladen
Gehe zu Einstellungen → Fähigkeiten → Skills → Skill hochladen
Einschalten und loslegen
Teste es
Verwendung von "plugin-settings". 엄격한 검증 모드로 내 플러그인을 활성화하는 설정 파일 생성
Erwartetes Ergebnis:
- .claude/my-plugin.local.md에 설정 파일 생성됨
- 구성: enabled=true, mode=strict, max_file_size=1000000
- 수정 방법: 파일 편집 후 Claude Code 재시작
- 파일은 자동으로 gitignore됨
Verwendung von "plugin-settings". JavaScript와 TypeScript 파일을 2MB 제한으로 허용하도록 내 플러그인 구성
Erwartetes Ergebnis:
- 새 설정으로 .claude/my-plugin.local.md 업데이트됨
- 허용 확장자: .js, .ts
- 최대 파일 크기: 2097152 바이트
- 변경사항 적용을 위해 Claude Code 재시작
Sicherheitsaudit
SicherOfficial Anthropic skill providing documentation on plugin settings pattern. Contains only educational content and utility scripts with safe bash practices including set -euo pipefail, file existence checks, and proper input validation. No network access, no dangerous operations, no external dependencies beyond standard POSIX tools.
Risikofaktoren
⚡ Enthält Skripte (3)
📁 Dateisystemzugriff (2)
⚙️ Externe Befehle (2)
Qualitätsbewertung
Was du bauen kannst
구성 가능한 동작 추가
하드코딩된 기본값 대신 설정 파일을 통해 사용자가 플러그인 동작을 커스터마이즈할 수 있게 함
에이전트 상태 추적
여러 세션에 걸쳐 에이전트 작업 할당, 반복 카운터, 코디네이터 세션 정보 저장
기능 플래그 생성
플러그인 코드 수정 없이 플러그인 기능 활성화 또는 비활성화
Probiere diese Prompts
표준 모드와 로깅이 활성화된 상태로 내 플러그인을 활성화하는 .claude/my-plugin.local.md 파일 생성
.claude/my-plugin.local.md 파일이 있는지 확인하고 프론트매터에서 enabled 및 mode 필드 읽기
.claude/ralph-loop.local.md 파일의 iteration 필드를 현재 값에서 1 증가하도록 업데이트
.claude/my-plugin.local.md가 enabled 필드가 true로 설정된 유효한 프론트매터를 가지고 있는지 검증
Bewährte Verfahren
- 설정 파일이 없을 때는 항상 합리적인 기본값 제공
- 플러그인이 구성되지 않았을 때 훅 처리를 건너뛰기 위해 빠른 종료 패턴 사용
- 사용자 설정 커밋을 방지하기 위해 .claude/*.local.md를 프로젝트 .gitignore에 추가
Vermeiden
- 설정 파일에 대한 절대 경로를 하드코딩하지 마세요 (예: .claude/plugin-name.local.md와 같은 상대 경로 사용)
- 설정 읽기 전에 파일 존재 여부 확인을 건너뛰지 마세요
- 중단 시 설정이 손상될 수 있는 비원자적 파일 업데이트를 사용하지 마세요
Häufig gestellte Fragen
어떤 도구에서 이 패턴을 지원하나요?
설정 파일의 크기 제한은 무엇인가요?
기존 플러그인과 어떻게 통합하나요?
설정 파일이 안전한가요?
변경사항이 적용되지 않는 이유는?
CLAUDE.md와 어떻게 비교되나요?
Entwicklerdetails
Autor
anthropicsLizenz
MIT
Repository
https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/plugin-settingsRef
main