활성화 계약
이 스킬은 기존 SKILL.md 파일을 감사, 리팩터링, 정규화 또는 개선할 때 사용합니다. 재사용 가능한 패턴에서 완전히 새로운 스킬을 만들 때는 gentle-ai-skill-creator를 사용하세요.
하드 규칙
- 먼저
docs/skill-style-guide.md를 읽고 이를 규범적 스타일 계약으로 취급합니다. SKILL.md를 진실 공급원으로 취급하며, 작성자의 의도, 중요한 규칙, 활성화 의미론 및 출력 요구 사항을 보존합니다.- 사용 가능한 경우
.atl/skill-registry.md를 스킬 이름, 트리거, 범위 및 정확한 경로의 인덱스로 사용합니다. - 기본값은 감사 전용입니다. 사용자가 명시적으로 개선 사항을 적용하도록 요청한 경우에만 파일을 수정합니다.
- 의미 있는 내용을 조용히 삭제하지 않습니다. 긴 설명, 예제, 템플릿 또는 스키마는 로컬
references/또는assets/로 이동합니다. - 트리거, 정책 또는 도메인 규칙을 임의로 만들지 않습니다. 모호한 경우는 인간의 검토를 위해 표시합니다.
의사 결정 게이트
| 상황 | 조치 |
|---|---|
| 프론트매터 누락 또는 잘못됨 | name, 인용된 한 줄 description, license 및 metadata 수정 |
| 스킬이 튜토리얼 문서처럼 읽힘 | 런타임 지침으로 변환하고 배경 내용은 references/로 이동 |
| 본문 크기 초과 | 규칙을 보존하고 예제/배경은 지원 파일로 이동 |
| 분기 로직이 산문에 숨겨져 있음 | 간결한 의사 결정 테이블로 변환 |
| 규칙 충돌 또는 의도가 불명확함 | 문제 보고; 해당 규칙을 자동으로 다시 작성하지 않음 |
실행 단계
docs/skill-style-guide.md를 읽습니다..atl/skill-registry.md를 읽습니다. 나열된 경로를 사용하여 스킬을 선택합니다. 누락된 경우 알려진 스킬 디렉터리에서*/SKILL.md를 검색합니다.- 선택한 각 스킬에 대해 메타데이터, 트리거 명확성, 섹션 순서, 본문 크기, 실행 가능성, 의사 결정 게이트, 출력 계약 및 로컬 참조를 감사합니다.
- 스킬별로 그룹화된 심각도와 정확한 제안 변경 사항이 포함된 감사 보고서를 반환합니다.
- 적용 모드에서는 안전한 문제만 편집하고, 내용을 보존하며, 필요할 때 지원 파일을 만든 다음,
/skill-registry:refresh를 새로 고치거나 요청합니다.
출력 계약
다음을 반환합니다:
- 감사된 스킬 및 사용된 경로.
- 심각도별로 그룹화된 발견된 문제.
- 적용 모드가 요청된 경우 변경된 파일.
- 스킬 메타데이터 또는 경로가 변경된 경우 레지스트리 새로 고침 권장 사항.
- 인간의 검토가 필요한 모호한 부분.
참조
docs/skill-style-guide.md— 규범적 LLM 우선 스킬 스타일 가이드.skills/skill-registry/SKILL.md— 레지스트리 새로 고침 및 인덱싱 계약.