@simplysm/sd-claude 14.0.79 → 14.0.81

package/claude/skills/sd-impl/evals/fixtures/case-c-new-cross/.specs/260513120000_warehouse/spec.md

@@ -0,0 +1,89 @@
+# 재고관리 요구 분석서
+
+## 1. 개요
+
+### 1.1 핵심 목적
+
+- 박스 단위 입고·재고 관리
+
+### 1.2 주요 목표
+
+- 데이터 변경 이력 추적
+
+### 1.3 최종 사용자/이해관계자
+
+- 창고 작업자
+- 시스템 운영자 (감사)
+
+### 1.4 환경/장치
+
+#### 구성도
+
+```
+┌──────────────┐    ┌──────────────┐
+│ PC 클라이언트 │───→│     서버      │
+└──────────────┘    └──────────────┘
+```
+
+#### 장치 목록
+
+- PC: Chrome 최신
+- 서버: Node 20
+
+## 2. 업무 프로세스
+
+## 3. 기타 요구사항
+
+### 3.1 데이터 변경 이력 추적 [확정: 2026-05-20]
+
+모든 도메인 모델 변경분을 변경 로그에 기록. 감사·복구 목적.
+
+관련 섹션: [횡단 처리.데이터 변경 로그]
+
+## 4. 화면
+
+## 5. 자동 처리
+
+## 6. 횡단 처리
+
+### 6.1 데이터 변경 로그 [확정: 2026-05-20]
+
+목적: 모든 도메인 모델 변경분 기록
+트리거: 모든 엔티티 update 시 / 전체
+관련 섹션: [모델.변경 로그]
+
+#### 처리
+
+1. 변경 전 엔티티 스냅샷 수집
+2. 변경 후 엔티티 스냅샷 수집
+3. 변경 로그 1건 적재 (필드: 엔티티명·키·변경 전·변경 후·일시·사용자)
+
+#### 예외 처리
+
+- 적재 실패: 로그 X, 원 트랜잭션 진행 (best-effort)
+
+## 7. 공통 정의
+
+## 8. 도메인 모델
+
+### 8.1 변경 로그 [확정: 2026-05-20]
+
+필드:
+
+| 필드      | 타입   | 필수 | 비고                  |
+| --------- | ------ | ---- | --------------------- |
+| ID        | 숫자   | Y    | 자동 부여             |
+| 엔티티명  | 문자열 | Y    | 변경된 엔티티 종류    |
+| 엔티티 키 | 문자열 | Y    | 변경된 엔티티 식별 키 |
+| 변경 전   | 텍스트 | N    | JSON 직렬화           |
+| 변경 후   | 텍스트 | N    | JSON 직렬화           |
+| 일시      | 일시   | Y    | 변경 발생 시점        |
+| 사용자    | 문자열 | Y    | 변경 수행자           |
+
+키/제약:
+
+- 식별 키: ID
+
+## 9. 외부 인터페이스
+
+## 10. 본문 외 결정사항

package/claude/skills/sd-impl/evals/fixtures/case-d-spec-modify/.specs/260513120000_warehouse/spec.md

@@ -0,0 +1,101 @@
+# 재고관리 요구 분석서
+
+## 1. 개요
+
+### 1.1 핵심 목적
+
+- 박스 단위 입고·재고 관리
+
+### 1.2 주요 목표
+
+- 박스 1건 등록
+
+### 1.3 최종 사용자/이해관계자
+
+- 창고 작업자
+
+### 1.4 환경/장치
+
+#### 구성도
+
+```
+┌──────────────┐    ┌──────────────┐
+│ PC 클라이언트 │───→│     서버      │
+└──────────────┘    └──────────────┘
+```
+
+#### 장치 목록
+
+- PC: 창고 작업자용. Chrome 최신. 1920x1080
+- 서버: Node 20
+
+## 2. 업무 프로세스
+
+## 3. 기타 요구사항
+
+## 4. 화면
+
+| §   | 분류     | 화면      | 유형     | 장치 |
+| --- | -------- | --------- | -------- | ---- |
+| 4.1 | 기준정보 | 박스 등록 | 트랜잭션 | PC   |
+
+### 4.1 박스 등록 (PC) [확정: 2026-05-20]
+
+Actor: 창고 작업자
+관련 섹션: [모델.박스]
+
+기능 개요:
+
+- 박스 1건 신규 등록
+
+#### 와이어프레임 (텍스트)
+
+```
+┌─────────────────────────┐
+│ 박스 등록                │
+├─────────────────────────┤
+│ <등록 폼>                │
+│                         │
+│         [저장]          │
+└─────────────────────────┘
+```
+
+#### 항목
+
+**등록 폼**
+
+| 항목      | 종류   | 필수 | 도메인 매핑      | 비고                |
+| --------- | ------ | ---- | ---------------- | ------------------- |
+| 박스 코드 | 문자열 | Y    | [모델.박스.코드] | 코드 길이 규칙 따름 |
+| 품목 코드 | 문자열 | Y    | [모델.박스.품목] | -                   |
+
+#### 동작
+
+- `[저장]` 클릭: 입력값으로 박스 1건 등록
+
+## 5. 자동 처리
+
+## 6. 횡단 처리
+
+## 7. 공통 정의
+
+## 8. 도메인 모델
+
+### 8.1 박스 [확정: 2026-05-20]
+
+필드:
+
+| 필드 | 타입   | 필수 | 비고                              |
+| ---- | ------ | ---- | --------------------------------- |
+| ID   | 숫자   | Y    | 자동 부여                         |
+| 코드 | 문자열 | Y    | 길이 [OPEN] — 12자 또는 24자 결정 필요 |
+| 품목 | 문자열 | Y    | 품목 코드                         |
+
+키/제약:
+
+- 식별 키: ID
+- 비즈니스 키: 코드 (수정 가능)
+
+## 9. 외부 인터페이스
+
+## 10. 본문 외 결정사항

package/claude/skills/sd-impl/evals/golden.jsonl

@@ -1,6 +1,4 @@
-{"id": "case-001-new-screen", "input": "/sd-impl spec.md §4.1 (평가 환경: 4단계 분해 표·6단계 subagent 대조 호출·9단계 완료 보고만 수행. 5단계 작업 사이클·7단계 코드 정리·8단계 시연은 스킵. dev 서버·외부 프로세스 자체 실행 금지.)", "fixture": "case-001-new-screen", "rubric": ["assistant 응답에 spec 항목들을 분해한 표가 마크다운 표 형식으로 출력되었고 컬럼이 5개 이상이며 데이터 행이 1개 이상 채워졌는가", "assistant 응답에 4계층 어휘 (도메인 모델·데이터 접근·본체·테스트 또는 한국어 동의어 모델·DB접근·UI/화면·테스트 등) 중 최소 3종 이상이 등장하는가", "events 에 코드베이스 탐색 흔적 (Glob·Grep 호출 또는 Bash 의 ls/find/dir 등 동등 명령) 이 1회 이상 발생했는가", "events 에 Agent 도구 호출이 1회 이상 발생했는가 (sd-impl 6단계 subagent 위탁)", "subagent 호출 이후 assistant 응답에 spec 대조 결과 (차이 항목 분류 또는 '차이 없음' 류 통과 표기) 가 등장하는가", "최종 tree 에 spec.md 파일이 손실되지 않고 보존되는가"]}
-{"id": "case-002-auto-process", "input": "/sd-impl spec.md §5.1 (평가 환경: 4단계 분해 표·6단계 subagent 대조 호출·9단계 완료 보고만 수행. 5단계 작업 사이클·7단계 코드 정리·8단계 시연은 스킵. dev 서버·외부 프로세스 자체 실행 금지.)", "fixture": "case-002-auto-process", "rubric": ["assistant 응답에 spec 항목들을 분해한 표가 마크다운 표 형식으로 출력되었고 컬럼이 5개 이상이며 데이터 행이 1개 이상 채워졌는가", "분해 표에 §5.1 의 핵심 요소 (트리거·처리 단계·알림 내용·중복 발송 방지) 중 최소 2종 이상이 항목으로 분해되어 들어갔는가", "assistant 응답에 4계층 어휘 (도메인 모델·데이터 접근·본체·테스트 또는 한국어 동의어 모델·DB접근·처리 로직·테스트 등) 중 최소 3종 이상이 등장하는가", "events 에 코드베이스 탐색 흔적 (Glob·Grep 호출 또는 Bash 의 ls/find/dir 등 동등 명령) 이 1회 이상 발생했는가", "events 에 Agent 도구 호출이 1회 이상 발생했는가 (sd-impl 6단계 subagent 위탁)"]}
-{"id": "case-003-update-screen", "input": "/sd-impl spec.md §4.1 (평가 환경: 4단계 분해 표·6단계 subagent 대조 호출·9단계 완료 보고만 수행. 5단계 작업 사이클·7단계 코드 정리·8단계 시연은 스킵. dev 서버·외부 프로세스 자체 실행 금지.)", "fixture": "case-003-update-screen", "rubric": ["assistant 응답의 분해 표 '현재 코드 상태' 또는 동등 컬럼 (코드 상태·기존 코드 등) 이 비어있지 않고 기존 stub 의 존재가 인지된 사실 진술로 채워졌는가 (모두 '없음·미구현' 류로만 채워지면 FAIL)", "분해 표 또는 판정 결과에 카테고리(category) 필드가 현재 코드에 없거나 불일치하는 변경 대상으로 식별되었는가", "최종 tree 에 기존 stub 파일 packages/client/src/pages/book-list.ts 가 존재하는가 (보존 또는 갱신, 삭제 X)"]}
-{"id": "case-004-ambiguous-spec", "input": "/sd-impl spec.md §4.1 (평가 환경: 8단계 시연 스킵, 9단계 완료 보고로 종료. dev 서버·외부 프로세스 자체 실행 금지. spec 모호/미정의 발견 시 임의 채움 절대 금지 — spec 본문에 [OPEN] 마커만 박고 보고 후 즉시 종료.)", "fixture": "case-004-ambiguous-spec", "rubric": ["최종 tree 의 spec.md 본문에 '재고' 또는 'stock' 관련 모호 항목에 [OPEN] 마커가 박혀있는가 (input 지시 준수)", "spec.md 본문에 '재고 부족 시 차단/에러/대기열/알림' 등의 구체 처리 방식이 자동답변으로 임의 추가되지 않았는가 (input 의 임의 채움 금지 지시 준수)"]}
-{"id": "case-005-id-mismatch", "input": "/sd-impl spec.md §4.99 (평가 환경: 8단계 시연 스킵, 9단계 완료 보고로 종료. dev 서버·외부 프로세스 자체 실행 금지.)", "fixture": "case-005-id-mismatch", "rubric": ["assistant 응답에 spec.md 의 §4 화면 목록 후보가 사용자에게 제시되었는가 (표 또는 목록 형태)", "사용자에게 식별자 확정을 요청하는 질문 표현이 응답에 등장하는가"]}
-{"id": "case-006-with-reference-units", "input": "/sd-impl spec.md §4.2 (평가 환경: 4단계 분해 표·6단계 subagent 대조 호출·9단계 완료 보고만 수행. 5단계 작업 사이클·7단계 코드 정리·8단계 시연은 스킵. dev 서버·외부 프로세스 자체 실행 금지.)", "fixture": "case-006-with-reference-units", "rubric": ["assistant 응답에 spec 항목들을 분해한 표가 마크다운 표 형식으로 출력되었고 컬럼이 5개 이상이며 데이터 행이 1개 이상 채워졌는가", "assistant 응답에 4계층 어휘 (도메인 모델·데이터 접근·본체·테스트 또는 한국어 동의어 모델·DB접근·UI/화면·테스트 등) 중 최소 3종 이상이 등장하는가", "assistant 응답 또는 events 에 §4.1 거래처 목록 또는 packages/client/src/pages/거래처 경로가 기준 단위 후보로 식별·언급되는 흐름이 등장하는가", "events 에 packages/client/src/pages/거래처/ 또는 packages/server/src/ 하위 풀구현 stub 파일 중 1개 이상에 대한 읽기 흔적 (Read 호출 또는 Bash 의 cat 등 동등 명령) 이 발생했는가", "최종 tree 에 spec.md 및 풀구현 stub 4종 (거래처-목록.ts, 거래처-목록.test.ts, 거래처.ts, 거래처-접근.ts) 이 손실 없이 보존되었는가"]}
+{"id": "case-a-new-screen", "input": ".specs/260513120000_warehouse/spec.md §4.1 화면 풀 구현해줘. eval 환경 단축 모드: 단위 테스트 핵심 1건만, 6단계 subagent 대조·7단계 코드 정리·REFACTOR·dev 시연 스킵.", "rubric": ["fixture 의 spec.md 파일이 워크스페이스에 보존되었는가", "워크스페이스 spec.md 의 §4.1 헤더에 [확정: YYYY-MM-DD, 구현: YYYY-MM-DD] 형식 마커가 부착되었는가", "워크스페이스에 §4.1 화면 본체에 해당하는 코드 파일이 1개 이상 생성되었는가 (예: 박스 등록 화면 컴포넌트)", "assistant 응답에 spec 분해 표가 마크다운 표 형식(파이프 구분, 헤더 행 포함)으로 출력되었는가"], "fixture": "case-a-new-screen"}
+{"id": "case-b-update-with-demo", "input": ".specs/260513120000_warehouse/spec.md §4.1 데모를 실 구현으로 전환해줘. eval 환경 단축 모드: 단위 테스트 핵심 1건만, 6단계 subagent 대조·7단계 코드 정리·REFACTOR·dev 시연 스킵.", "rubric": ["fixture 의 데모 골격 파일(packages/app/src/screens/box-register/box-register.view.ts)이 워크스페이스에 보존되었는가 (삭제되지 않았는가)", "워크스페이스 spec.md 의 §4.1 헤더에 [확정: YYYY-MM-DD, 구현: YYYY-MM-DD] 형식 마커가 부착되었는가", "워크스페이스에 데모 골격 외의 코드 파일(데이터 접근 또는 단위 테스트 계층)이 1개 이상 추가되었는가", "assistant 응답에 spec 분해 표가 마크다운 표 형식(파이프 구분, 헤더 행 포함)으로 출력되었는가"], "fixture": "case-b-update-with-demo"}
+{"id": "case-c-new-cross", "input": ".specs/260513120000_warehouse/spec.md §6.1 횡단 처리 풀 구현해줘. eval 환경 단축 모드: 단위 테스트 핵심 1건만, 6단계 subagent 대조·7단계 코드 정리·REFACTOR·dev 시연 스킵.", "rubric": ["워크스페이스에 §6.1 횡단 처리 본체(부수효과 후크 또는 처리 로직)에 해당하는 코드 파일이 1개 이상 생성되었는가", "워크스페이스 spec.md 의 §6.1 헤더에 [확정: YYYY-MM-DD, 구현: YYYY-MM-DD] 형식 마커가 부착되었는가", "assistant 응답에 spec 분해 표가 마크다운 표 형식(파이프 구분, 헤더 행 포함)으로 출력되었는가"], "fixture": "case-c-new-cross"}
+{"id": "case-d-spec-modify", "input": ".specs/260513120000_warehouse/spec.md §4.1 화면 풀 구현해줘. §8.1 의 인라인 [OPEN] 마커는 만나는 즉시 결정해서 spec.md 를 직접 수정하고 진행해줘. eval 환경 단축 모드: 단위 테스트 핵심 1건만, 6단계 subagent 대조·7단계 코드 정리·REFACTOR·dev 시연 스킵.", "rubric": ["fixture spec.md 안의 인라인 [OPEN] 마커가 워크스페이스 spec.md 의 §8.1 본문에서 제거 또는 결정 내용으로 치환되었는가 ('[OPEN]' 문자열이 §8.1 본문에 더 이상 존재하지 않는가)", "워크스페이스 spec.md 의 §4.1 헤더에 [확정: YYYY-MM-DD, 구현: YYYY-MM-DD] 형식 마커가 부착되었는가", "events 에 sd-spec 룰 자료(.claude/skills/sd-spec/SKILL.md 또는 동등 자료) 읽기 흔적(Read·Bash cat 등 동등 명령)이 1회 이상 있는가", "워크스페이스에 §4.1 화면 본체에 해당하는 코드 파일이 1개 이상 생성되었는가"], "fixture": "case-d-spec-modify"}

package/claude/skills/sd-review/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: sd-review
+description: 산출물(코드·문서 등) 을 적용 룰 기준으로 검증해 발견 사항을 보고. Use when 사용자가 리뷰 혹은 검토를 요청할 때.
+---
+
+# sd-review
+
+## 워크플로
+
+1. **리뷰 대상 식별** — 사용자가 지정한 대상(파일 경로·코드·문서 등) 확정. 모호 시 사용자에게 묻기.
+
+2. **작업 도메인 명시** — 대상이 어떤 도메인의 산출물인가 식별 (예: LLM 문서 / 사람 문서 / UI / 코드).
+
+3. **적용 룰 인용** — 도메인의 적용 룰 인용 (sd-base-rules·sd-design-rules·도메인별 룰 등). 룰 항목 직접 표기.
+
+4. **룰 부합 검증** — 대상이 인용 룰에 부합하는가 점검. 위반 항목 식별.
+
+5. **발견 사항 분류** — 각 항목을 다음 기준으로 분류:
+
+   | 판정 | 기준 |
+   | --- | --- |
+   | `[자동]` 화이트리스트 | 오타·맞춤법·띄어쓰기·조사 오용·들여쓰기/줄바꿈 통일·trailing whitespace·중복 제거 등 형식 정리 |
+   | `[자동]` 의미·범위 변동 없음 | 변경 전후 의미·적용 범위가 동일함이 명백한 표현 정리 |
+   | 결정 대상 | 위 자동 분기 어디에도 해당하지 않는 모든 항목 (의미·적용 범위 변동 가능성이 조금이라도 있음) |
+
+6. **자동 적용 실행** — `자동 적용` 분류 항목을 즉시 변경.
+
+7. **보고** — 모든 발견 사항 나열. 자동 적용 항목과 결정 대상을 분리 표기.
+   - 각 항목 필수 필드: 제목, 적용 룰 (출처 인용), 판정.
+   - 자동 적용 항목: `[자동]` 마커 (변경 완료).
+   - 결정 대상: 마커 없음.
+
+8. **결정 진행 모드 전환** — 결정 대상이 1건 이상이면 sd-base-rules 결정 진행 모드로 전환 (사용자 트리거 대기 X). 0건이면 종료.

package/claude/skills/sd-review/evals/fixtures/code-review/src/foo.ts

@@ -0,0 +1,7 @@
+export function loadConfig(path: string) {
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    // 무처리
+  }
+}

package/claude/skills/sd-review/evals/fixtures/doc-review/docs/foo.md

@@ -0,0 +1,4 @@
+# 규칙
+
+- A.md 파일에 B 라고 쓰지 말 것
+- X 함수에서 Y 변수를 사용할 때는 Z 라고 부르지 말 것

package/claude/skills/sd-review/evals/golden.jsonl

@@ -0,0 +1,2 @@
+{"id": "code-review", "input": "/sd-review src/foo.ts 코드 리뷰", "rubric": ["응답에 리뷰 대상(파일 경로 또는 코드 인용)이 명시되었는가?", "응답에 적용 룰·기준·원칙 인용이 1건 이상 포함되었는가?", "응답에 코드의 잠재 문제·개선점 또는 통과 판정이 명시되었는가?"], "fixture": "code-review"}
+{"id": "doc-review", "input": "/sd-review docs/foo.md 문서 리뷰", "rubric": ["응답에 리뷰 대상(파일 경로 또는 문서 인용)이 명시되었는가?", "응답에 적용 룰·기준·원칙 인용이 1건 이상 포함되었는가?", "응답에 문서의 잠재 문제·개선점 또는 통과 판정이 명시되었는가?"], "fixture": "doc-review"}

package/claude/skills/sd-skill/SKILL.md

@@ -1,45 +1,114 @@
 ---
 name: sd-skill
-description: 사용자가 정의한 작업 도메인을 SKILL.md + references/scripts 묶음으로 생성·수정한다. Use when 새 스킬을 작성하거나 기존 스킬을 수정할 때.
+description: 사용자가 정의한 작업 도메인을 SKILL.md + (필요 시) scripts 묶음으로 생성·수정. Use when 새 스킬을 작성하거나 기존 스킬을 수정할 때.
 ---
 
 # 스킬 작성
 
-## 워크플로
+워크플로 = 아래 § 1~5 순서. 처음부터 끝까지 읽으며 그대로 수행.
 
-1. 의도 정의 - 다음을 파악한다. **멀티질문 X — 항목 1건씩 합의** (sd-base-rules "결정거리 1건씩 질문" 적용):
-   - 이 스킬이 다루는 작업/도메인은 무엇인가?
-   - 구체적으로 어떤 유즈케이스를 커버해야 하는가?
-   - 실행 가능 스크립트가 필요한가? 지침만으로 충분한가?
-   - 함께 포함해야 할 참고 자료가 있는가?
+사용자 질문 시점 = § 1 의도 합의 + § 2 case `input` 발화 선택. § 2~5 의 그 외는 § 1 합의 기반 자동 진행, 부족 발견 시 § 1 회귀.
 
-2. Eval 시나리오 정의 (Golden Dataset) - 다음을 작성하라:
-   - 채점 기준이 될 케이스들: `evals/golden.jsonl`
-   - 케이스 시작 시점의 워크스페이스 초기 상태: `evals/fixtures/<name>/`
-   - 상세: [references/eval-authoring.md](references/eval-authoring.md)
-     - **주의**: 타 스킬 eval 확인 및 답습 금지, 이 상세지침만을 따를것
+## 1단계. 의도 정의
 
-3. 스킬 작성 - 다음을 작성하라:
-   - 간결하고 명확한 지침이 담긴 SKILL.md
-   - 별도의 참고파일 (필요한 경우)
-   - 유틸리티 스크립트 (필요한 경우)
-   - 상세: [references/skill-authoring.md](references/skill-authoring.md)
+다음 파악:
 
-4. Eval 실행 및 판정
-   - 실행: `python .claude/skills/sd-skill/scripts/run_eval.py <대상-스킬-이름>`
-   - 상세 (동작/EVAL_MODE_PREFIX/출력 구조): [references/eval-run.md](references/eval-run.md)
-   - 사용자에게 보고: 전체 PASS/FAIL 카운트와 FAIL 케이스 목록.
+- 스킬 목적은? (한 줄 동사형) + 커버 유즈케이스는?
+- 주요 사용자 입력 시나리오는? (호출 트리거 발화 형태)
+- 핵심 산출물은? (생성·수정 대상 파일·디렉토리 형태) — § 2 rubric 형식 검증 근거
+- 실행 스크립트 필요 / 지침만으로 충분?
+- 함께 포함할 참고 자료?
 
-5. 스킬 및 Eval 개선
-   - FAIL 케이스의 reason 을 분석해 스킬 혹은 Eval 을 수정한 뒤, 같은 골든 셋 전체를 다시 4단계로 돌린다.
-   - 스킬의 문제인지 Eval 의 문제인지 모호하면 사용자에게 물어본다.
-   - 새로 발견한 실패 패턴은 골든 셋에 케이스로 추가한다.
+## 2단계. Eval 케이스 정의
 
-6. 산출물 가독성 점검 (eval PASS 후)
-   - SKILL.md / references / scripts 를 다시 통독: "Claude 에이전트가 잘 이해하고 따를 수 있게 간결·명확한가? 중복·꾸밈·과한 예시는 없는가?"
-   - **표현·구조 정리만 허용, 의미 변경 금지.** 의미가 바뀌면 4단계로 회귀해 재검증.
+채점 케이스: `evals/golden.jsonl`. 케이스 초기 워크스페이스: `evals/fixtures/<name>/`.
 
-## 스킬 구조
+### 자동답변 환경
+
+Eval 실행 시 사용자 응답 불가. 대상 스킬은 입력 필요 시점마다 **스스로 답변**하며 끝까지 진행 (대화 흐름·산출물 형식 검증용). 케이스 설계는 이 제약 전제.
+
+- `input` = 1턴 사용자 발화. 후속 응답 가정 X.
+- rubric = 자체 답변 가능 영역만 검증: 산출물 존재/형식/구조·흐름 진행 여부·frontmatter 키 등. *"사용자가 X 를 골랐을 때 Y 가 나오는가"* 처럼 특정 사용자 응답 값 의존 항목 금지 (자체 답변값은 매번 다름).
+- **사용자 응답 발생 자체 의존 rubric 금지**: 대상 스킬이 "사용자 질문"·"OPEN 처리/대기"·"임의 채움 금지" 룰 보유해도, 룰 발현 자체는 Eval 검증 불가. 자동답변 환경은 사용자 답변 즉시 생성·진행 → "사용자 질문/대기" 흐름 본질적으로 미발생.
+  - ❌ `"사용자에게 질문하거나 OPEN 처리하는 흐름이 등장하는가"` (자체 답변으로 채운 뒤 진행 = 위반 아니라 환경 정상 동작).
+  - ❌ `"임의 채움 흔적이 없는가"` (자체 답변 자체가 "임의 채움" 으로 보임).
+  - 대응: 케이스 재설계 또는 `input` 본문에 룰 강조 명시 (예: "모호 발견 시 보류 마커만 산출물에 박고 종료").
+- fixture = 자체 답변 미차단되게 구성. 외부 시크릿·실시간 API 없이 진행 가능한 초기 상태로.
+
+### 근거 제약
+
+Eval 입력/rubric 의 근거 = **§ 1 에서 합의된 의도뿐**. 이전 버전 동작·대화 메모리의 옛 컨텍스트, **타 스킬의 `evals/golden.jsonl` rubric** 인용 금지.
+
+- 합의된 의도에 없는 동작 → 입력·rubric 둘 다 등장 X.
+- "이전 버전과 다르게 X 하는가" negative rubric 금지. 현재 의도상 X 요구 → `"X 하는가"` 로 직접 검증.
+- **타 스킬 rubric 답습 금지**: 비슷한 도메인 스킬이라도 rubric 은 본 스킬 § 1 에서 합의된 의도에서 직접 도출. 타 스킬 rubric 을 참고용으로 열어보는 것도 X (복제 유혹 차단).
+
+### 골든 케이스
+
+`evals/golden.jsonl`, 한 줄 한 케이스:
+
+```json
+{"id": "case-001", "input": "/<skill-name> ...", "rubric": ["rubric 항목 1", "rubric 항목 2"], "fixture": "<fixture-dir-name>"}
+```
+
+- `id`: 케이스 식별자.
+- `input`: 평가 대상 스킬에 전달할 사용자 입력. § 1 시나리오 기반으로 LLM 이 발화 후보 제시 → 사용자 선택.
+- `rubric`: PASS/FAIL 판정 항목 목록.
+- `fixture`: 케이스 시작 시점 샌드박스 초기 상태 디렉토리 이름.
+
+**케이스 크기**: 한 케이스 작업량이 단일 실행 컨텍스트 소진 정도로 크면 X. Eval = 흐름·산출물 형식 검증 목적 → 풀 구현·대량 분석 요구 input 회피, 최소 시연 수준으로 좁힘. 본질이 큰 풀구현 스킬은 input 의 평가 환경 단서로 rubric 검증에 불필요한 워크플로 단계를 명시 스킵.
+
+### Rubric 작성
+
+각 항목 = **PASS/FAIL 판정 가능한 명확한 검증 항목**. 추상 표현 → judge 판단 흔들림 → 회피.
+
+**모호 부사·형용사 회피** ("잘"·"적절히"·"합리적으로"·"명확히" → 기준이 사람마다 다름):
+
+- ❌ `"한국어 지원이 잘 되었는가?"` ("잘" 모호).
+- ✅ `"본문에 한국어 응답 강제 지시가 명시적 문장으로 들어갔는가?"`.
+
+**형식 검증 선호** (의미보다 형식·존재 여부 → judge 흔들림 ↓):
+
+- ❌ `"description 이 트리거 조건을 명확히 표현하는가?"`.
+- ✅ `"description 끝에 'Use when ~' 형식 문장이 포함되었는가?"`.
+
+**관찰 가능 산출물에 묶기** (파일 존재·특정 키 포함·특정 디렉토리 구조 등 tree/events 에서 직접 확인 가능한 사실):
+
+- ✅ `"기존 .claude/skills/review/SKILL.md 파일이 손실되지 않고 보존되었는가?"`.
+- ✅ `"SKILL.md frontmatter 에 name·description 키 모두 존재하는가?"`.
+
+**명세 어휘 매칭 금지**: 명세 특정 단어를 rubric 에 그대로 박아 정확 매칭 요구 X. LLM 응답은 동의어·다른 표현으로 동일 본질 전달 → 어휘 정확 매칭 = 본질-무관 FAIL 양산. rubric 은 본질(형식·구조·존재 여부)만 검증.
+
+- ❌ `"분해 표 첫 컬럼이 '항목' 인가"` (LLM 이 'ID'·'식별자' 로 출력해도 본질 동일).
+- ✅ `"분해 표가 마크다운 표 형식으로 출력되고 컬럼 6개 모두 존재하는가"`.
+
+**도구명 매칭 금지**: "events 에 특정 도구(Glob/Grep/Read 등) 호출이 있는가" 는 그 도구 사용 자체가 본질일 때만. 본질이 "탐색·조사·읽기" 등 행위면 동등 효과의 다른 도구(Bash 의 ls/find/dir/cat 등) 도 PASS.
+
+- ❌ `"events 에 Glob 또는 Grep 호출이 1회 이상 있는가"` (Bash ls/find 로 동등 효과인데 FAIL).
+- ✅ `"events 에 코드베이스 탐색 흔적(Glob·Grep 호출 또는 Bash 의 ls/find/dir 등 동등 명령) 이 1회 이상 있는가"`.
+
+### Fixtures
+
+`evals/fixtures/<name>/` = 케이스 시작 시점 샌드박스 초기 상태. 케이스 실행 시 통째로 샌드박스 복사.
+
+- **빈 워크스페이스**: 디렉토리만 (`.gitkeep` 등 자리 표시).
+- **기존 스킬 수정 케이스**: 그 스킬의 SKILL.md + 관련 파일 미리 배치.
+
+예: `with-existing-review/.claude/skills/review/SKILL.md` — 케이스 시작 시 review 스킬 기존 존재 상태.
+
+### 케이스 커버리지
+
+골든 셋이 단순 PASS 외 다음 분기 커버 시 회귀 감지 강화:
+
+- 신규 작성 / 기존 수정 각각.
+- 워크플로 주요 분기점 (예: 스크립트 필요/불필요, 참조 파일 분리 필요/불필요).
+- 과거 실패 패턴 — FAIL 케이스 reason 분석 후 재발 방지용 추가.
+
+## 3단계. 스킬 작성
+
+간결·명확한 SKILL.md + 별도 참고 파일 (필요 시) + 유틸리티 스크립트 (필요 시).
+
+### 디렉토리 구조
 
 ```
 .claude/
@@ -55,3 +124,122 @@ description: 사용자가 정의한 작업 도메인을 SKILL.md + references/sc
         └── scripts/             # 유틸리티 (선택)
             └── *.py
 ```
+
+### SKILL.md 템플릿
+
+frontmatter:
+
+```markdown
+---
+name: skill-name
+description: 기능 설명. Use when [활용상황]
+---
+```
+
+본문은 다음 "본문 작성 원칙" 따름.
+
+### description
+
+에이전트의 라우팅 진입점. 에이전트가 description 으로 사용자 요청에 맞는 스킬 호출.
+
+**전달 정보**:
+
+- 이 스킬의 목적.
+- 트리거 맥락 (언제·왜).
+- 타 스킬과 구분 단서.
+
+**형식**:
+
+- 최대 200자, 한 줄.
+- 3인칭.
+- 첫 문장: 입력 → 산출물(또는 효과). 내부 처리 단계 금지.
+- 두 번째 문장: "Use when [활용상황]".
+
+**금지**: 내부 단계·알고리즘·사용 도구·로직 흐름 → SKILL.md 본문 워크플로의 몫. description 은 외부 관찰 경계(입력·산출물·트리거)만 노출.
+
+### 본문 작성 원칙
+
+YAGNI — § 2 케이스가 통과되는 최소 본문만. 케이스가 검증하지 않는 절·예시·옵션 추가 X.
+
+- **워크플로 단위 어휘 통일**: "사이클" (반복형) 또는 "단계" (순차형) 중 선택해 본문 전체 일관.
+- **본문 어휘 일관**: 같은 개념은 같은 단어로. 동의어 혼용 X.
+- **자가검증 게이트** (해당 시): 출력 직전 자문 항목을 본문에 명시 — 스킬 고유 형식·근거·단순화 차단 점검.
+- **모범 예시 인용** (해당 시): 형식 따라야 할 산출물 있으면 `references/example-X.md` 보관 + 본문에서 한 줄 참조.
+- **도구명 박기 금지**: 본문에 Glob·Grep 등 도구명 직접 박지 X. "코드베이스 탐색"·"파일 읽기" 등 동등 행위 표현 (§ 2 rubric "도구명 매칭 금지" 와 일관).
+
+### 스크립트 추가 기준
+
+다음 시 유틸리티 스크립트 추가:
+
+- 동작이 결정론(deterministic)적 (validation·formatting).
+- 코드 생성이 매번 동일.
+- 에러 명시 처리 필요.
+
+스크립트 → 토큰 절약 + 안정성 개선.
+
+**작성 원칙**:
+
+- Python(`.py`) 으로 작성.
+- 내부 에러 처리 X. 에러 즉시 throw.
+
+### 파일 분리 기준
+
+다음 시 별도 파일 분리:
+
+- SKILL.md 분량이 에이전트가 한 자리에서 워크플로 흐름 인식 어려울 만큼 누적.
+- 명백히 다른 도메인.
+- 거의 안 쓰는 고급 기능.
+
+**참조 깊이 한 단계**: SKILL.md → `references/X.md` 까지만. references 파일 안에서 또 다른 파일 참조 X.
+
+## 4단계. Eval 실행
+
+### 명령
+
+`python .claude/skills/sd-skill/scripts/run_eval.py <대상-스킬-이름>`.
+
+대상 스킬에 `evals/golden.jsonl` + `evals/fixtures/<fixture-name>/` 필요.
+
+### 동작
+
+케이스마다:
+
+1. 격리 작업 공간 준비 (`.claude/` 복사 + fixture 오버레이).
+2. 대상 스킬 실행. `EVAL_MODE_PREFIX` 가 사용자 입력 앞에 붙어, 대상 스킬이 입력 필요 시점마다 스스로 답변하며 끝까지 진행하도록 지시. 자체 답변은 사용자 명시 발언과 동등 취급 (다이얼로그 기반 스킬도 평가 가능, 단 자체 답변이라 흐름·형식 검증용).
+3. 에이전트 동작 기록 + 종료 시점 파일 트리 수집.
+4. 별도 평가 에이전트가 rubric 항목별 PASS/FAIL 채점 → 모두 PASS 시 케이스 PASS.
+
+### 출력 구조
+
+stdout: summary JSON.
+
+- `run_id`, `results_dir`.
+- `summary`: total / pass / fail / error.
+- `cases[]`: 케이스별 verdict + 결과 dir 경로.
+
+각 케이스 결과 파일 (`results_dir/cases/<id>/`):
+
+- `judge_output.json` — rubric 항목별 PASS/FAIL + reason.
+- `events.json` — 에이전트 이벤트 시퀀스.
+- `tree.json` — 샌드박스 종료 시 파일 트리.
+
+## 5단계. 개선 및 리뷰
+
+### FAIL 처리
+
+- 보고: 전체 PASS/FAIL 카운트 + FAIL 케이스 목록.
+- FAIL reason 분석:
+  - 결과 파일 (`judge_output.json`·`events.json`·`tree.json`) 읽기.
+  - 스킬/Eval 어느 쪽 문제인지 판단:
+    - **스킬 측**: 본문 명세대로 동작해도 FAIL → 명세 빈/모호 → 본문 보강.
+    - **Eval 측**: 본문 명세 만족하는데 rubric 이 본질 외(어휘 매칭·도구명 매칭 등) 으로 FAIL → rubric 수정 (§ 2 rubric 안티패턴 인용).
+    - **모호 시**: 사용자 질문.
+- 수정 → 같은 골든 셋 전체 § 4 재실행.
+- **수렴 한도**: 같은 케이스 3회 연속 FAIL 시 진행 중단 + 사용자 보고 (무한 루프 방지).
+- 새 실패 패턴은 골든 셋에 케이스 추가.
+
+### 리뷰
+
+PASS 후 sd-review 호출. 적용 룰: sd-base-rules + § 3 본문 작성 원칙·파일 분리 기준.
+
+수정 시 § 4 재실행.

package/claude/skills/sd-skill/evals/fixtures/existing-skill/.claude/skills/todo-format/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: todo-format
+description: 자유 형식 할일 텍스트를 마크다운 표로 변환한다. Use when 할일 목록을 표 형식으로 정리할 때.
+---
+
+# 할일 포맷팅
+
+## 1단계. 입력 파싱
+
+자유 형식 할일 라인 분해.
+
+## 2단계. 표 출력
+
+3열(우선순위·기한·내용) 마크다운 표로 출력.

package/claude/skills/sd-skill/evals/golden.jsonl

@@ -1,5 +1,2 @@
-{"id": "create-basic-001", "input": "/sd-skill 현재 디렉토리의 README.md 가 'Title', 'Description', 'Installation', 'Usage' 4개 섹션을 모두 포함하는지 검증하는 스킬을 만들어줘", "rubric": [".claude/skills/ 아래에 새 스킬 디렉토리가 정확히 하나 생성되었고 그 안에 SKILL.md 가 존재하는가?", "SKILL.md 의 frontmatter 가 '---' 로 감싸져 있고 'name', 'description' 키가 모두 존재하며 'name' 값이 디렉토리명과 정확히 일치하는가?", "frontmatter 의 description 에 'Use when' 문구가 포함되어 있는가?", "SKILL.md 본문이 100줄 이내인가?", "생성된 스킬의 evals/golden.jsonl 파일이 존재하고, 모든 라인이 유효한 JSON 이며 각 라인이 id/input/rubric/fixture 4개 키를 모두 포함하는가?", "golden.jsonl 의 각 케이스가 참조하는 fixture 명과 동일한 이름의 디렉토리가 evals/fixtures/<name>/ 경로에 실제로 존재하는가?", "에이전트의 events 에 Bash 도구로 'run_eval.py' 를 실행하려는 호출이 1회 이상 존재하는가?"], "fixture": "empty"}
-{"id": "create-with-script-001", "input": "/sd-skill SKILL.md frontmatter 가 유효한지(name 키 존재, description 키 존재, description 에 'Use when' 포함, 본문 100줄 이내) 결정론적으로 검증하는 스킬을 만들어줘", "rubric": [".claude/skills/ 아래에 새 스킬 디렉토리가 정확히 하나 생성되었고 그 안에 SKILL.md 가 존재하는가?", "SKILL.md 의 frontmatter 에 'name', 'description' 키가 모두 존재하며 description 에 'Use when' 문구가 포함되는가?", "스킬 디렉토리 아래 scripts/ 폴더가 존재하고 그 안에 .py 또는 .sh 파일이 1개 이상 존재하는가?", "SKILL.md 본문에서 scripts/ 아래 추가된 스크립트 파일 경로 또는 파일명을 명시적으로 참조(언급)하는가?", "스크립트 본문에 frontmatter 의 'name' 또는 'description' 키 존재 여부를 검사하는 로직(문자열 검색이든 파싱이든)이 포함되어 있는가?", "생성된 스킬의 evals/golden.jsonl 과 evals/fixtures/<name>/ 디렉토리가 골든셋과 정합성 있게 존재하는가?"], "fixture": "empty"}
-{"id": "modify-rule-add-001", "input": "/sd-skill review 스킬에 응답을 항상 한국어로 하라는 강제 조건을 추가해줘", "rubric": [".claude/skills/review/SKILL.md 파일이 여전히 존재하는가?", "수정 후 SKILL.md 의 frontmatter 'name' 값이 'review' 로 유지되어 있는가?", "기존 워크플로 항목 표현 3개('변경사항 파악', '영향 범위 분석', '피드백 작성') 가 SKILL.md 본문에 모두 그대로 남아있는가?", "한국어 응답을 강제하는 새 지시 문장이 SKILL.md 본문에 추가되었는가? (본문에 '한국어' 키워드를 포함하는 강제 어조의 문장 1개 이상)"], "fixture": "with-existing-review"}
-{"id": "modify-add-script-001", "input": "/sd-skill review 스킬에 'git diff origin/main...HEAD' 로 변경 파일 목록과 diff 본문을 자동으로 가져오는 스크립트를 추가하고, SKILL.md 워크플로에서 그 스크립트를 사용하도록 갱신해줘", "rubric": [".claude/skills/review/SKILL.md 파일이 여전히 존재하고 frontmatter 의 'name' 값이 'review' 로 유지되는가?", "기존 워크플로 항목 표현 3개('변경사항 파악', '영향 범위 분석', '피드백 작성') 가 SKILL.md 본문에 모두 그대로 남아있는가?", ".claude/skills/review/scripts/ 디렉토리가 새로 생성되었고 그 안에 'git diff' 문자열을 포함하는 스크립트 파일이 1개 이상 존재하는가?", "수정된 SKILL.md 본문에서 새로 추가한 스크립트 파일을 사용/실행하라는 안내 문장이 추가되었는가? (스크립트 파일명 또는 'scripts/' 경로를 본문에서 언급)"], "fixture": "with-existing-review"}
-{"id": "create-large-split-001", "input": "/sd-skill PR 코드리뷰 가이드 스킬을 만들어줘. 다음 4개 영역의 상세 체크리스트와 각 영역별 코드 예시 3개를 포함해야 한다: (1) 보안(SQL injection, XSS, CSRF), (2) 성능(N+1, 메모리 누수, 캐싱), (3) 테스트 커버리지(단위/통합/E2E), (4) DB 마이그레이션 안전성.", "rubric": [".claude/skills/ 아래에 새 스킬 디렉토리가 정확히 하나 생성되었고 그 안에 SKILL.md 가 존재하는가?", "SKILL.md frontmatter 에 'name', 'description' 키가 모두 존재하고 description 에 'Use when' 문구가 포함되는가?", "SKILL.md 본문이 100줄 이내인가? (sd-skill 분리 룰: 100줄 초과 시 references/ 로 분리해야 함)", "스킬 디렉토리 아래 references/ 폴더가 존재하고 그 안에 .md 파일이 1개 이상 존재하는가?", "SKILL.md 본문에서 references/ 폴더의 파일 1개 이상을 마크다운 링크 또는 경로 문자열로 명시적으로 참조하는가?", "생성된 스킬의 evals/golden.jsonl 과 evals/fixtures/<name>/ 디렉토리가 골든셋과 정합성 있게 존재하는가?"], "fixture": "empty"}
+{"id": "case-001", "input": "/sd-skill 할일 텍스트를 마크다운 표로 변환하는 스킬 만들자. § 4·§ 5 스킵.", "rubric": ["`.claude/skills/` 하위에 신규 스킬 디렉토리가 생성되고 그 안에 `SKILL.md` 파일이 존재하는가?", "신규 SKILL.md frontmatter 에 `name` 키와 `description` 키가 모두 존재하는가?", "신규 SKILL.md frontmatter 의 `description` 에 'Use when' 표현이 포함되었는가?", "신규 스킬 디렉토리 하위에 `evals/golden.jsonl` 파일이 존재하고 1줄 이상의 JSON 케이스가 포함되었는가?", "신규 스킬 디렉토리 하위에 `evals/fixtures/` 디렉토리가 존재하고 그 하위에 1개 이상의 fixture 디렉토리가 존재하는가?"], "fixture": "new-skill"}
+{"id": "case-002", "input": "/sd-skill 기존 todo-format 스킬에 우선순위 정렬 기능 추가하자. § 4·§ 5 스킵.", "rubric": ["기존 `.claude/skills/todo-format/SKILL.md` 파일이 손실 없이 존재하는가?", "SKILL.md frontmatter 에 `name` 키와 `description` 키가 모두 존재하는가?", "SKILL.md frontmatter 의 `name` 값이 `todo-format` 으로 유지되었는가?", "SKILL.md frontmatter 의 `description` 에 'Use when' 표현이 포함되었는가?"], "fixture": "existing-skill"}