foreign-matter-car
This skill should be used when the user asks to "이물 분석해줘", "이물 대책서 만들어줘", "이물 원인 파악", "혼입 사고 보고서", "SEM-EDX 분석 결과 있어", "이물 DB 대조해줘", "foreign matter report", "corrective action report", "재발방지 대책서", or
SKILL.md.claude/skills/foreign-matter-car/SKILL.md
GitHub이물 혼입 재발방지 대책서 자동 생성
이물 초기보고 → SEM-EDX 해석 → DB 대조 → 작업지시서 교차검증 → 대책서(md/docx/pptx) 일괄 생성
WHEN TRIGGERED - EXECUTE IMMEDIATELY
이물 관련 파일이 제공되면 즉시 Phase 1부터 실행한다. 파일 없이 구두 요청만 있으면 필요한 파일을 질문한다.
Workflow
Phase 1: 자료 수집 및 파싱
Type: prompt
- 사용자가 제공한 파일 확인 (초기보고서, SEM-EDX 결과)
- 필수 정보 추출:
- 초기보고서: 발생 일시, 라인, 제품, LOT, 검출 방식, 이물 육안 소견(크기, 색상, 질감, 냄새)
- SEM-EDX: 원소별 wt% 수치, 분석 조건, 샘플 ID
- 누락 정보가 있으면 사용자에게 한 번에 질문 (최소화)
초기보고서와 SEM-EDX 파싱은 독립적 — 병렬 실행 가능.
Phase 2: 이물 DB 대조
Type: prompt + script
이물 DB 파일 탐색:
Glob: **/sem_edx_database.csv기본 경로:
references/sem_edx_database.csv또는data/sem_edx_database.csv2단계 매칭 알고리즘 실행:
Step A — Hard Filter (시그니처 패턴):
- 검체의 주요 원소 존재/부재로 카테고리 축소
- 예: Zn+S 동시 검출 + N 부재 → 가황 천연고무 계열
- 예: Fe+Cr+Ni → 스테인리스 계열
- 예: Cl 고농도 → PVC 계열
Step B — Soft Score (wt% 유사도):
- 후보군 내에서 원소별 오차 비교
- 허용 오차: 주요 원소(>5%) ±5wt%, 미량 원소(<5%) ±2wt%
- 각 후보별 일치 원소 수 / 전체 원소 수로 매칭 점수 산출
결과 제시 규칙:
- 유일 매칭 (점수 > 0.8, 2위와 격차 > 0.15) → 후보 1건 + 비교표 제시
- 복수 매칭 → 상위 3건 비교표 제시 + "다음 정보로 구분 가능" 안내
- 매칭 없음 →
UNMATCHED플래그. 추측하지 않는다. "DB에 등록되지 않은 이물입니다. 전문가 확인이 필요합니다." 출력
사용자에게 매칭 결과 보고 후 확인 요청 (이물 정체 확정은 반드시 사용자 승인)
Phase 3: 작업지시서 교차 검증
Type: prompt + rag
- 작업지시서 파일 탐색:
Glob: **/작업지시서* OR **/work-instruction* - 이물 정체 확정 결과를 기반으로 관련 조항 검색:
- Grep으로 키워드 탐색 (예: "장갑", "보호구", "위생", 해당 공정명)
- 규정 vs 현장 실태 불일치 테이블 작성: | 항목 | 작업지시서 규정 | 현장 실태 | 위반 여부 |
- 규정 미비 사항 식별 (교체 주기, 점검 절차, 변경 승인 등)
- 사용자에게 추가 정보 확인 (작업자 확인 결과, 장갑 재고 상황 등)
작업지시서가 없으면: "작업지시서 미확인 — 수동 첨부 필요" 크로스체크 포인트로 분리. 나머지 분석은 계속 진행.
Phase 4: 원인 경로 종합
Type: prompt
Phase 1~3 결과를 종합하여 원인 경로 정리:
근본 원인 → 관리 원인 → 직접 원인 → 혼입 경로 → 검출
반드시 사용자에게 원인 경로를 제시하고 승인받는다. 승인 없이 대책서를 생성하지 않는다.
Phase 5: 재발방지 대책서 생성
Type: generate
사용자 승인된 원인 분석을 기반으로 대책서 생성.
대책서 구조 (7섹션):
- 사고 개요 — 발생 일시/라인/LOT/이물 정체
- 이물 동정 결과 — SEM-EDX 수치 + DB 대조 비교표
- 원인 분석 — 원인 경로(근본→직접) + 규정 불일치 + 규정 미비
- 영향 범위 — Hold 현황 + 납기 영향
- 재발방지 대책 — 즉시/단기/중장기 계층화, 담당+기한 명시
- 유효성 검증 계획 — 대책별 검증 방법/시기/판정 기준
- 첨부 자료 + 결재란
대책 설계 원칙:
- 즉시 조치: 원상 복귀 + 긴급 점검 (1~3일)
- 단기 대책: 규정 보완 + 절차 추가 (1~2주)
- 중장기 대책: 소재/설비 전환 검토 + 제도화 (1개월)
- 각 대책에 No./담당/기한 필수 명시
출력:
reports/YYYY-MM-DD_이물대책서.md— Write로 생성- 사용자에게 "워드/PPT도 생성할까요?" 확인
Phase 6: 문서 변환 (선택)
Type: generate
사용자 요청 시 docx/pptx 생성.
- docx:
docx스킬 호출 (Skill: docx) - pptx:
pptx스킬 호출 (Skill: pptx)
docx/pptx 모두 Phase 5의 마크다운을 단일 소스로 사용 → 숫자 불일치 방지.
Edge Cases
| 상황 | 처리 |
|---|---|
| DB 매칭 없음 | UNMATCHED 플래그, 추측 금지, 전문가 확인 권고 |
| 복수 매칭 | 상위 3건 비교표 + 구분 가능한 추가 확인 항목 안내 |
| 작업지시서 없음 | 크로스체크 포인트로 분리, 나머지 진행 |
| 초기보고서 필수 필드 누락 | 누락 항목 명시 후 사용자에게 질문 |
| SEM-EDX에 N 미포함 | "검출 한계 이하"와 "미측정"을 구분하여 처리 |
| DB CSV 컬럼 불일치 | 컬럼명 기반 파싱, 인덱스 기반 금지 |
절대 자동화 금지 항목
- 이물 원인 최종 확정 (사용자 승인 필수)
- 출하 중단/재개 판단
- 고객사/기관 제출 결정
- 보고서 결재
Integration Points
docx스킬: 워드 문서 생성pptx스킬: 보고용 PPT 생성cross-check스킬: 생성된 보고서 검증 시 활용 가능data-analyst스킬: DB 데이터 심층 분석 필요 시