--- name: self-improve-skill description: "기존 스킬을 종합 분석하고 구체적인 개선안을 제시/수행합니다. Use for skill improvement, 스킬 개선, skill review, skill analysis, skill optimization, enhance skill, skill quality check, 스킬 품질 검사, skill refactor, 스킬 리팩토링. DO NOT USE FOR: 새로운 스킬 생성, 스킬 배포, 스킬이 아닌 파일 편집." version: 1.0.0 author: User tags: [skill, improvement, analysis, optimization, review, self-improve] dependencies: [] --- # Self-Improve Skill 기존 스킬을 7개 차원에서 종합 분석하고, 구체적인 개선안을 보고서로 제시한 후 선택적으로 수정을 수행합니다. ## 전체 흐름 ``` ┌─────────────────────────────────────────────────────────────────────────┐ │ SELF-IMPROVE PIPELINE │ ├─────────────────────────────────────────────────────────────────────────┤ │ │ │ [Phase 1: 대상 수집] │ │ │ │ │ ▼ │ │ 경로 수신 → 파일 확인 → 백업 생성 │ │ │ │ [Phase 2: 구조 분석] │ │ │ │ │ ▼ │ │ 디렉토리 스캔 → 리소스 점검 → naming 검사 │ │ │ │ [Phase 3: 문서 분석] │ │ │ │ │ ▼ │ │ Frontmatter 검증 → 섹션 완성도 → 가독성 평가 │ │ │ │ [Phase 4: 워크플로우 분석] │ │ │ │ │ ▼ │ │ 단계 명확성 → 분기 처리 → 실행 가능성 평가 │ │ │ │ [Phase 5: 완전성 분석] │ │ │ │ │ ▼ │ │ 에러 핸들링 → 교차참조 → 메타데이터 → 스크립트 경로 │ │ │ │ [Phase 6: 종합 및 보고] │ │ │ │ │ ▼ │ │ 점수 산출 → 보고서 생성 → 개선안 제시 → 선택적 수정 │ │ │ └─────────────────────────────────────────────────────────────────────────┘ ``` ## 분석 단계 | 단계 | 파일 | 설명 | |------|------|------| | 1 | `analysis/structure-analysis.md` | 디렉토리 구조, 리소스 존재 여부, 파일 naming 분석 | | 2 | `analysis/documentation-analysis.md` | Frontmatter, 섹션 완성도, 가독성 분석 | | 3 | `analysis/workflow-analysis.md` | 워크플로우 단계 명확성, 분기 처리, 실행 가능성 분석 | | 4 | `analysis/completeness-analysis.md` | 에러 핸들링, 교차참조, 메타데이터, 스크립트 경로 분석 | ## 분석 차원 (7개) | # | 차원 | 가중치 | 검사 항목 | |---|------|--------|----------| | 1 | **Frontmatter** | 15% | 필수 필드 존재, SemVer 형식, description 패턴 (USE FOR/DO NOT USE FOR) | | 2 | **문서 구조** | 20% | 헤딩 계층, 섹션 완성도, 가독성, 일관성 | | 3 | **워크플로우** | 25% | 단계 명확성, 분기 처리, 실행 가능성, 테스트 시나리오 | | 4 | **에러 핸들링** | 15% | 테이블 존재, 시나리오 커버리지, 해결책 명시 | | 5 | **리소스** | 10% | 스크립트/템플릿/참조 파일 존재, 경로 유효성 | | 6 | **교차참조** | 10% | 다른 스킬과의 연결, 링크 유효성 | | 7 | **메타데이터** | 5% | 버전, 작성자, 라이센스, 의존성 명시 | ## 점수 체계 | 점수 범위 | 등급 | 설명 | |-----------|------|------| | 90-100 | S | 우수 — 개선 불필요 | | 80-89 | A | 양호 — 선택적 개선 | | 70-79 | B | 보통 — 권장 개선 | | 60-69 | C | 미흡 — 적극적 개선 필요 | | 60 미만 | D | 부족 — 전면 개선 필요 | ## 출력 형식 분석 완료 후 다음 형식의 보고서를 생성합니다: ```markdown ## Skill Improvement Report: [스킬명] ### 점수: [XX/100] ([등급]) ### 강점 - [잘 된 점 나열] ### 개선 필요 사항 | # | 우선순위 | 차원 | 문제 | 현재 상태 | 개선안 | |---|----------|------|------|-----------|--------| | 1 | 높음 | Frontmatter | description에 USE FOR 누락 | ... | ... | | 2 | 중간 | 워크플로우 | Phase 3 분기 없음 | ... | ... | | 3 | 낮음 | 문서 | 에러 핸들링 테이블 없음 | ... | ... | ### 권장 조치 1. [즉시 개선 사항] 2. [선택적 개선 사항] ``` ## 실행 규칙 1. **대상 지정 필수** — 분석할 SKILL.md 경로를 사용자로부터 받습니다 2. **백업 우선** — 수정 전 원본 백업을 생성합니다 3. **점수 투명** — 각 차원별 점수를 공개합니다 4. **구체적 개선안** — 추상적 조언이 아닌 수정 전/후 비교를 제시합니다 5. **선택적 수정** — 사용자 확인 후 수정을 수행합니다 ## 에러 처리 | 상황 | 대응 | |------|------| | 경로 없음 | 사용자에게 SKILL.md 경로 요청 | | 파일 없음 | 해당 경로에 SKILL.md가 없음 안내 | | 읽기 실패 | 파일 권한 확인, 대체 경로 제안 | | 백업 실패 | 수정 전 사용자에게 경고, 수동 백업 요청 | | 분석 불가 | 스킬 형식이 비표준인 경우 분석 범위 제한 안내 | ## 사용 예시 ``` # 스킬 분석 요청 self-improve-skill: /home/hana/sources/@SKILLS/study/skills/self-study-agent/SKILL.md # 분석 후 수정 요청 self-improve-skill: ./skills/setting-collapse-detector/SKILL.md 개선해줘 ```