메뉴
cc-initializer 자동 복구 및 문제 해결. Hook 실패, 문서 손상, 설정 오류를 진단하고 수정합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Synchronize all agile development artifacts in one command. Updates CHANGELOG, README stats, progress tracking, and validates documentation completeness.
Optimize context loading for efficient token usage. Use when working with large codebases, context limits, or when the user mentions "context", "token", "optimize", "summarize", or asks to reduce context size.
Complete sprint lifecycle management. Start sprints, track velocity, generate burndown charts, and automate retrospectives.
Phase, Sprint, 문서 간 동기화 문제 해결. 불일치 감지 및 자동 수정.
cc-initializer 설정 및 구성 검증. settings.json, hooks, agents, skills, documents 무결성 확인.
BIM 데이터 조회 및 분석 쿼리 작성 스킬
| name | repair |
| description | cc-initializer 자동 복구 및 문제 해결. Hook 실패, 문서 손상, 설정 오류를 진단하고 수정합니다. |
/repair [mode] [options]
| Mode | Description |
|---|---|
--diagnose | 문제 진단만 수행 (기본) |
--auto | 자동 복구 실행 |
--hooks | Hook 관련 문제만 수정 |
--docs | 문서 구조만 수정 |
--config | 설정 파일만 수정 |
--full | 전체 복구 (모든 항목) |
--report | 복구 보고서 생성 |
┌────────────────────────────────────────────────────────────────────┐
│ /repair WORKFLOW │
├────────────────────────────────────────────────────────────────────┤
│ │
│ 1. 시스템 진단 │
│ ├── Hook 상태 확인 │
│ ├── 문서 구조 확인 │
│ ├── 설정 유효성 확인 │
│ └── 로그 분석 │
│ │
│ 2. 문제 분류 │
│ ├── CRITICAL: 즉시 수정 필요 │
│ ├── WARNING: 수정 권장 │
│ └── INFO: 참고사항 │
│ │
│ 3. 자동 복구 │
│ ├── Hook 권한 복구 │
│ ├── 누락 디렉토리 생성 │
│ ├── 설정 기본값 복원 │
│ └── 캐시/로그 정리 │
│ │
│ 4. 수동 복구 안내 │
│ └── 자동 복구 불가 항목 안내 │
│ │
│ 5. 복구 보고서 │
│ └── 결과 요약 및 후속 조치 │
│ │
└────────────────────────────────────────────────────────────────────┘
Hook Problems:
- permission_denied: Hook 실행 권한 없음
- file_missing: Hook 파일 누락
- syntax_error: 스크립트 문법 오류
- dependency_missing: 의존성 누락
Auto-Fix:
- chmod +x: 실행 권한 부여
- restore_template: 기본 템플릿 복원
Document Problems:
- missing_directory: docs/, phases/, sprints/ 누락
- missing_required: PROGRESS.md, CONTEXT.md 누락
- broken_links: 내부 링크 손상
- invalid_format: 마크다운 형식 오류
Auto-Fix:
- mkdir -p: 디렉토리 생성
- create_template: 기본 문서 생성
- fix_links: 링크 수정
Config Problems:
- invalid_json: settings.json 문법 오류
- missing_section: 필수 섹션 누락
- invalid_reference: 존재하지 않는 파일 참조
- deprecated_setting: 지원 종료 설정
Auto-Fix:
- restore_defaults: 기본값 복원
- migrate_settings: 설정 마이그레이션
- add_missing: 누락 섹션 추가
🔍 REPAIR: System Diagnosis
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Category Status Issues
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Hooks ⚠️ WARN 2
Documents ❌ ERROR 1
Configuration ✅ OK 0
Logs ✅ OK 0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 Detailed Issues
[WARN] Hook: auto-doc-sync.sh
Not executable (chmod +x needed)
Auto-fixable: Yes
[WARN] Hook: notification-handler.sh
Not executable (chmod +x needed)
Auto-fixable: Yes
[ERROR] Document: docs/PROGRESS.md
File missing
Auto-fixable: Yes (run /init --docs-only)
💡 Recommendation: Run `/repair --auto` to fix 3 issues
🔧 REPAIR: Auto Recovery
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Starting automatic repair...
[1/4] Fixing hook permissions...
✅ chmod +x .claude/hooks/auto-doc-sync.sh
✅ chmod +x .claude/hooks/notification-handler.sh
[2/4] Creating missing directories...
✅ mkdir -p docs/phases
✅ mkdir -p docs/sprints
[3/4] Restoring missing files...
⚠️ docs/PROGRESS.md requires /init (skipped)
[4/4] Cleaning up...
✅ Cleared old log files
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Repair Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Fixed automatically: 4
Requires manual action: 1
Total issues: 5
📝 Manual Action Required:
1. Run `/init --docs-only` to create PROGRESS.md
📊 REPAIR: Recovery Report
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Generated: 2025-01-09 15:30:00
## Error History (Last 7 Days)
| Date | Hook | Error | Recovery |
|------------|-------------------|-----------------|---------------|
| 2025-01-09 | auto-doc-sync.sh | syntax error | Fixed regex |
| 2025-01-08 | phase-progress.sh | permission | chmod +x |
## Recovery Actions Taken
- Total recoveries: 5
- Auto-fixed: 4
- Manual: 1
## System Health Score: 95/100
Recommendations:
1. Review auto-doc-sync.sh for edge cases
2. Consider enabling auto_check_on_start
Full logs: .claude/logs/recovery.log
# Hook 권한 일괄 수정
/repair --hooks
# 문서 구조 복구
/repair --docs
# 설정 검증 및 수정
/repair --config
# 전체 진단 및 자동 복구
/repair --full
# 진단만 수행
/repair --diagnose
# 복구 후 검증
/repair --auto && /validate --full
# validate 실패 시 repair 연계
/validate --full
# If fails:
/repair --auto
/validate --full
# Hook 실패 시 자동 복구 트리거
# settings.json에서 활성화:
{
"recovery": {
"auto_recover_on_hook_failure": true,
"max_retry_count": 3
}
}
# Pre-commit 실패 시 복구 시도
quality-gate pre-commit || /repair --auto
// settings.json
{
"recovery": {
"enabled": true,
"auto_recover_on_hook_failure": true,
"max_retry_count": 3,
"log_retention_days": 7,
"critical_hooks": ["pre-tool-use-safety.sh"],
"auto_fixable": {
"hook_permissions": true,
"missing_directories": true,
"log_rotation": true
},
"manual_required": {
"missing_docs": ["PROGRESS.md", "CONTEXT.md"],
"config_validation": true
}
}
}
| Code | Meaning |
|---|---|
| 0 | All repairs successful |
| 1 | Some repairs needed manual action |
| 2 | Critical errors (repair failed) |
| 3 | System in unrecoverable state |
| Command | Purpose |
|---|---|
/validate | System validation |
/init | Initialize/restore configuration |
/agile-sync | Sync documentation |
error-recovery.sh | Recovery hook |