Self Checker (자가 점검 스킬)

목적

코미의 지시서를 실행한 후, 누락 없이 완료했는지 스스로 검증하고 개선 가능한 부분을 조언한다.

실행 시점

• 모든 작업 완료 직전
• "완료 보고" 전에 반드시 실행

점검 항목

1. 지시서 완료 검증

2. 파일 존재 검증

# 실행할 검증 명령
ls -la [지시서에서 추출한 파일 경로]

검증 항목:

• 지시서에서 언급된 모든 파일 경로 추출
• 각 경로에 파일이 실제로 존재하는지 확인
• 없으면 누락 목록에 추가
• 빈 파일인지 확인 (0 bytes 경고)

3. 내용 검증

추가 검증:

• 빈 파일이 아닌가? (최소 100자 이상)
• YAML frontmatter가 유효한가?
• MASTER-INDEX.md가 업데이트되었는가?

4. 보완 조언 생성

완료 후 다음을 고려하여 조언:

• 추가하면 좋을 관련 기능
• 개선할 수 있는 부분
• 연결하면 좋을 다른 구성요소
• 다음 단계 추천

출력 형식

## 자가 점검 결과

### 1. 지시서 완료 현황

| Phase | 상태 | 비고 |
|-------|------|------|
| Phase 1: [이름] | O | 완료 |
| Phase 2: [이름] | O | 완료 |
| Phase 3: [이름] | X | [누락 사유] |

**완료율: X/Y (Z%)**

### 2. 파일 검증

| 파일 | 존재 | 내용 | 비고 |
|------|------|------|------|
| path/to/file1.md | O | O | 정상 |
| path/to/file2.md | O | X | 빈 파일 |
| path/to/file3.md | X | - | 미생성 |

**파일 완료율: X/Y (Z%)**

### 3. 누락 항목

- [ ] [누락된 작업 1]
- [ ] [누락된 작업 2]

### 4. 보완 조언

1. **[조언 제목 1]**
   - 현재: [현재 상태]
   - 제안: [개선 제안]
   - 이유: [왜 좋은지]

2. **[조언 제목 2]**
   - 현재: [현재 상태]
   - 제안: [개선 제안]
   - 이유: [왜 좋은지]

### 5. 최종 판정

| 항목 | 결과 |
|------|------|
| 지시서 완료 | O / X |
| 파일 생성 | O / X |
| 내용 검증 | O / X |
| **종합** | **PASS / FAIL** |

[PASS인 경우]
> 모든 작업이 완료되었습니다. 완료 보고를 진행합니다.

[FAIL인 경우]
> 누락된 항목이 있습니다. 위 누락 항목을 처리한 후 다시 점검합니다.

실행 흐름

1. 작업 완료 직전
      ↓
2. 지시서에서 Phase/파일 목록 추출
      ↓
3. 각 Phase 완료 여부 확인
      ↓
4. 각 파일 존재/내용 검증
      ↓
5. 누락 항목 목록 생성
      ↓
6. 보완 조언 생성
      ↓
7. 최종 판정 (PASS/FAIL)
      ↓
8-A. PASS → 완료 보고 진행
8-B. FAIL → 누락 항목 처리 후 재점검

사용 예시

자동 실행 (작업 완료 시)

[작업 완료 후 자동으로 self-checker 실행]

## 자가 점검 결과

### 1. 지시서 완료 현황
| Phase | 상태 | 비고 |
|-------|------|------|
| Phase 1: 폴더 생성 | O | 완료 |
| Phase 2: 파일 생성 | O | 완료 |

**완료율: 2/2 (100%)**

...

### 5. 최종 판정
| 항목 | 결과 |
|------|------|
| **종합** | **PASS** |

> 모든 작업이 완료되었습니다. 완료 보고를 진행합니다.

수동 실행

/self-checker 방금 작업 점검해줘

/self-checker 오늘 한 작업 전체 검증해줘

검증 실패 시 행동

1. 누락 파일 발견

   • 즉시 해당 파일 생성
   • 재점검 실행

2. 빈 파일 발견

   • 내용 채우기
   • 재점검 실행

3. 필수 섹션 누락

   • 해당 섹션 추가
   • 재점검 실행

4. MASTER-INDEX 미업데이트

   • MASTER-INDEX.md 업데이트
   • 재점검 실행

5. 3회 연속 FAIL

   • 상세 오류 보고
   • 사용자에게 확인 요청

관련 구성요소

버전 히스토리