7.3 KiB
7.3 KiB
name, description, version, author, tags, dependencies
| name | description | version | author | tags | dependencies | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| self-improve-skill | 기존 스킬을 종합 분석하고 구체적인 개선안을 제시/수행합니다. Use for skill improvement, 스킬 개선, skill review, skill analysis, skill optimization, enhance skill, skill quality check, 스킬 품질 검사, skill refactor, 스킬 리팩토링. DO NOT USE FOR: 새로운 스킬 생성, 스킬 배포, 스킬이 아닌 파일 편집. | 1.0.0 | User |
|
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 | 부족 — 전면 개선 필요 |
출력 형식
분석 완료 후 다음 형식의 보고서를 생성합니다:
## Skill Improvement Report: [스킬명]
### 점수: [XX/100] ([등급])
### 강점
- [잘 된 점 나열]
### 개선 필요 사항
| # | 우선순위 | 차원 | 문제 | 현재 상태 | 개선안 |
|---|----------|------|------|-----------|--------|
| 1 | 높음 | Frontmatter | description에 USE FOR 누락 | ... | ... |
| 2 | 중간 | 워크플로우 | Phase 3 분기 없음 | ... | ... |
| 3 | 낮음 | 문서 | 에러 핸들링 테이블 없음 | ... | ... |
### 권장 조치
1. [즉시 개선 사항]
2. [선택적 개선 사항]
실행 규칙
- 대상 지정 필수 — 분석할 SKILL.md 경로를 사용자로부터 받습니다
- 백업 우선 — 수정 전 원본 백업을 생성합니다
- 점수 투명 — 각 차원별 점수를 공개합니다
- 구체적 개선안 — 추상적 조언이 아닌 수정 전/후 비교를 제시합니다
- 선택적 수정 — 사용자 확인 후 수정을 수행합니다
에러 처리
| 상황 | 대응 |
|---|---|
| 경로 없음 | 사용자에게 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 개선해줘