136 lines
7.3 KiB
Markdown
136 lines
7.3 KiB
Markdown
|
---
|
||
|
|
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 개선해줘
|
||
|
|
```
|