git:20260914.8ad5d56 to git:20261104.5dfc34d

18 added, 144 removed. Audit A to A.

---
name: kr-patent-skill-updater
- description: 한국 특허 명세서 작업의 회고(retrospective)를 수행하여 발견된 패턴·실수·개선점을 다른 kr-patent-* 스킬들의 "누적 학습 항목" 섹션에 자동 반영하는 메타 스킬. 컴파운딩 루프(스킬이 사용할수록 똑똑해지는 메커니즘)를 실제로 작동시키는 도구. "회고", "회고해줘", "이번 작업 정리", "스킬 업데이트", "스킬에 반영", "lessons learned", "배운 점 정리", "다음에 더 잘하려면", "작업 마무리" 같은 표현이 보이거나, 명세서 작업이 끝나고 검토자 피드백을 받은 직후 사용. 명시적 요청 없이도 긴 명세서 작업이 종료되는 시점에 "회고하실래요?"라고 제안 가능.
+ description: 사용자가 한국 특허 스킬 개선을 요청했을 때 실제 작업의 교훈을 기존 지침에 통합한다. 중복 추가보다 수정·병합·삭제를 우선한다.
---
- # 한국 특허 스킬 업데이터 (메타 스킬)
-
- ## 무엇을 하는가
-
- 방금 끝낸 한국 특허 작업(명세서 작성, 점검, 미팅 질문 생성 등)을 회고하여 **다른 kr-patent-* 스킬에 누적시켜야 할 학습 항목**을 식별하고, 사용자 승인 후 해당 SKILL.md 파일을 자동 업데이트한다.
-
- 이 스킬이 없으면 컴파운딩 루프는 이론적 개념에 머문다. 이 스킬을 주기적으로 호출해야 다른 5개 스킬이 사용할수록 똑똑해진다.
-
- ## 입력
-
- - 방금 끝낸 작업의 컨텍스트 (대화 히스토리)
- - (선택) 검토자/발명자 피드백
- - (선택) 작업 중 발견한 실수·놀라움·예상 못 한 패턴
-
- ## 출력
-
- 1. **회고 보고서**: 어느 스킬에 어떤 학습 항목을 추가할지 분류한 제안 리스트
- 2. **사용자 승인**: 항목별 OK/NO/수정 받기
- 3. **SKILL.md 자동 업데이트**: 승인된 항목을 해당 SKILL.md의 "누적 학습 항목" 섹션 끝에 append
-
- ## 분류 카테고리 (5개 스킬 매핑)
-
- 작업에서 발견된 학습 항목을 다음 카테고리 중 어디에 속하는지 판단한다:
-
- | 카테고리 | 어떤 종류의 학습 항목? | 대상 스킬 |
- |---|---|---|
- | **A. 발명자 정보 누락** | "이번엔 X를 미리 물어봤어야 했다", IDS의 새로운 구멍 유형 | `kr-patent-inventor-meeting` |
- | **B. 부호 설계 실수** | "처음부터 X 부호 범위를 예약했어야 했다", 충돌·재설계 사례 | `kr-patent-symbol-design` |
- | **C. 명세서 본문 가이드라인** | 새로운 금지 표현, 위험 패턴, 좋은 표현 양식, 검토자 지적 | `kr-patent-spec-drafting` (+ references/ko-patent-style-rules.md) |
- | **D. 새로운 점검 항목** | 마스터 체크리스트에 없던 위반 유형, 정합성 오류의 새 패턴 | `kr-patent-consistency-check` |
- | **E. docx 양식 버그·개선** | 폰트/들여쓰기/페이지 양식 이슈, 검토자가 지적한 표지 양식 | `kr-patent-docx-builder/scripts/build_kr_patent.js` (스크립트 직접 수정) |
-
- 분류가 모호하면 사용자에게 묻는다. "이 항목은 A로 가야 하나요, C로 가야 하나요?"
-
- ## 작업 순서
-
- ### Step 1. 회고 트리거 확인
-
- 다음 중 하나면 진행:
- - 사용자가 명시적으로 "회고해줘", "스킬 업데이트해줘" 요청
- - 명세서 작업이 명확히 종료됨 (deliverable 전달 완료)
- - 검토자 피드백이 들어옴
-
- 명세서 작업이 진행 중이면 회고하지 않음. 흐름을 끊지 말 것.
-
- ### Step 2. 대화 컨텍스트 회상
-
- 방금 끝낸 작업의 핵심 사건들을 회상한다. 우선적으로 다음에 주목:
-
- - **수정·재작성·되돌리기 사례**: "이거 다시 해줘", "이 부분 빼고", "지난 버전이 나았다" → 첫 시도가 틀렸다는 신호. 왜 틀렸는지 분석.
- - **사용자가 직접 보완한 부분**: Claude가 놓쳤는데 사용자가 짚어준 항목들.
- - **반복 질문**: 사용자가 같은 종류의 질문을 두 번 이상 했다면, 첫 답이 부족했음.
- - **놀라움 (surprise)**: "이걸 깜빡할 줄 몰랐다" 종류의 일.
- - **검토자/발명자 피드백**: 외부 인풋이 있었다면 그 내용.
-
- ### Step 3. 학습 항목 추출
-
- 각 사건에 대해 다음 형식으로 추출:
-
- ```
- [학습 항목]
- - 사건: <무엇이 일어났나, 1문장>
- - 일반화: <개별 사건을 일반 규칙으로>
- - 대상 카테고리: A/B/C/D/E 중 하나
- - 새 누적 항목 문구: <SKILL.md에 그대로 들어갈 한 줄>
- ```
-
- **좋은 항목 vs 나쁜 항목**:
-
- | 좋음 (일반화·재사용 가능) | 나쁨 (너무 특수) |
- |---|---|
- | 회로 발명에서 V_REF 정전위 조건은 시스템 효과로 명시 | 빔진단 시스템에서 V_REF=1.65V 사용 |
- | 알고리즘 발명은 윈도우 크기·오버랩·업데이트 주기를 변형예에 명시 | 특정 모델의 LSTM 윈도우 32 사용 |
- | 청구항 한정 수치가 도면 박스 라벨에 노출되면 위험 | 도 4의 10mV 표기 위험 |
-
- 너무 특수한 항목은 일반화한 뒤 등록. 일반화 불가능하면 등록 안 함.
-
- ### Step 4. 사용자에게 제안 표시
-
- 추출된 항목들을 카테고리별로 묶어 사용자에게 표시:
-
- ```markdown
- ## 회고 결과 — 학습 항목 N개 후보
+ # 한국 특허 스킬 개선
- ### A. 발명자 미팅 (kr-patent-inventor-meeting)
- 1. [후보] <문구>
- - 근거: <어떤 사건에서 도출됐는지>
- - 승인? Y/N/수정
+ 사용자가 스킬 개선·회고 반영을 요청했을 때 실제 실패나 피드백으로 입증되는 변경만 반영한다. 명세서 작업이 끝났다는 이유로 스킬을 자동 수정하거나 매번 회고를 제안하지 않는다.
- ### C. 명세서 본문 (kr-patent-spec-drafting)
- 2. [후보] <문구>
- ...
- ```
+ ## 개선 절차
- 사용자가 항목별로 Y/N/수정 응답.
+ 1. 관찰된 문제, 재현 입력, 원하는 결과를 짧게 정리한다. 단일 사건의 고객 선호·문체·수치를 보편 규칙으로 만들지 않는다.
+ 2. 대상 스킬과 참조자료·스크립트의 기존 지침을 읽고 원인을 찾는다. 고정된 '5개 스킬' 분류 대신 실제 책임에 따라 배치한다.
+ 3. 기존 규칙의 수정·병합·삭제로 해결할 수 있는지 먼저 확인한다. 선택적인 도메인 사례는 필요한 참고자료에 둔다. 변경 이력은 Git에 남기고 SKILL.md에 끝없이 쌓지 않는다.
+ 4. 사용자가 반영을 요청한 범위는 바로 수정한다. 제안·회고만 요청받았으면 변경안까지만 제공한다. 범위를 넓히는 변경은 따로 구분한다.
+ 5. 호출 조건과 상대 링크를 검증하고, 스크립트를 바꿨으면 실행한다. 실제 실패 사례와 인접한 정상 사례를 재확인한다. 근거 없는 성능 향상 수치는 쓰지 않는다.
- ### Step 5. SKILL.md 자동 업데이트
+ 개선 내용에는 사건 식별정보·고객명·비공개 발명 내용을 넣지 않는다. 일반화할 수 없는 사실은 사건별 자료에만 남긴다.
- 승인된 항목을 해당 SKILL.md의 "누적 학습 항목" 섹션 끝에 append한다.
+ ## 기존 누적 섹션 호환 도구
- 스크립트: `scripts/append_learning.py`
+ 이미 누적 섹션을 사용하는 문서에 짧은 항목을 명시적으로 추가할 때만 [append_learning.py](scripts/append_learning.py)를 쓴다. 기본 개선 방식은 기존 지침 직접 편집이다.
```bash
- python3 /path/to/kr-patent-skill-updater/scripts/append_learning.py \
- --skill-path /path/to/kr-patent-spec-drafting/SKILL.md \
- --item "회로 발명에서 V_REF 정전위 조건은 시스템 효과로도 명시해야 함"
- ```
-
- 스크립트는:
- - 대상 SKILL.md 백업 (`.bak.YYYYMMDD-HHMMSS`)
- - "### 누적 학습 항목" 섹션을 찾아서 끝에 새 줄 추가
- - 항목 추가 후 통계 출력 (총 N개 항목)
-
- ### Step 6. 결과 보고
-
- 업데이트가 완료된 후:
-
- ```
- ✓ kr-patent-spec-drafting/SKILL.md: 1개 항목 추가 (총 3개)
- ✓ kr-patent-consistency-check/SKILL.md: 2개 항목 추가 (총 4개)
- 백업 파일: SKILL.md.bak.20260523-180000
+ python scripts/append_learning.py --skill-path /path/to/SKILL.md --list
+ python scripts/append_learning.py --skill-path /path/to/SKILL.md --item "검증된 개선 항목" --dry-run
+ python scripts/append_learning.py --skill-path /path/to/SKILL.md --item "검증된 개선 항목"
```
- ## 회고 작성 가이드
-
- ### 좋은 회고 항목 작성법
-
- 1. **특정 사건을 일반화하라**: "이번 회로 발명 건에서 V_REF가 빠졌다" → "회로 발명의 정전위 조건은 시스템 효과로도 명시"
- 2. **재현 가능하게 써라**: 누가 읽어도 "이걸 어떻게 검사할 수 있겠다" 이해되도록
- 3. **한 줄로 압축**: 너무 길면 SKILL.md가 부풀어 오른다. 한 줄로 안 되면 두 줄까지.
- 4. **이유보다 룰**: "~인 이유는 ~이다" 보다 "~할 것" 명령형. SKILL.md는 실행 가이드.
-
- ### 적절한 회고 빈도
-
- - **매 명세서 작성 후**: 최소 한 번 회고. 1-3개 항목 추가가 일반적.
- - **검토자 피드백 받은 후**: 즉시 회고. 가장 가치 있는 정보가 외부에서 옴.
- - **분기/반기 정리**: 누적된 학습 항목들 중 비슷한 것 합치기, 일반화 수준 재조정.
-
- ## 절대 하지 말 것
-
- - **무차별 추가**: 모든 작업 디테일을 다 누적하지 말 것. 일반화·재사용 가능한 것만.
- - **추측으로 추가**: 실제 사건이 없는데 "이런 게 있을 법하다"로 추가하지 말 것. 실증 기반만.
- - **사용자 승인 없이 수정**: 반드시 사용자가 OK 한 항목만 append. 자동 추론으로 수정 금지.
- - **백업 누락**: 항상 .bak 파일 만든 뒤 수정.
-
- ## 컴파운딩의 컴파운딩
+ 스킬 디렉터리에서 실행하거나 스크립트의 실제 경로를 사용한다. 섹션이 없으면 자동 생성하지 않는다. 도구는 중복 항목을 건너뛰고 변경이 있을 때만 백업한다. 새 원칙의 타당성은 도구가 판단하지 않으므로 변경 전 검토가 필요하다.
- 이 메타 스킬 자체도 사용할수록 똑똑해진다. 회고 패턴을 발견하면 본 SKILL.md 끝의 "회고 노하우 누적" 섹션에 추가.
+ ## 결과
- ### 회고 노하우 누적
- - (예시) 검토자 피드백이 있는 회고는 점검 항목(D 카테고리)으로 갈 가능성이 높음
- - (예시) "이걸 깜빡했다" 사건은 90% 이상 A 또는 C 카테고리
- - (2026-05-28) 도면-명세서 정합성 문제는 D 카테고리(consistency-check 점검)와 B 카테고리(symbol-design 설계) 양쪽에 동시 등록되는 경우가 흔함. 점검은 사후 검출, 설계는 사전 회피 — 같은 결함도 두 시점에서 다르게 막을 수 있음.
- - (2026-05-28) AI 생성 흔적류 항목(em-dash·가운뎃점·'이해될 수 있다' 다발)은 일관되게 C 카테고리(spec-drafting)에 누적. 명세서 한 건에서 발견된 패턴은 다른 명세서에도 거의 항상 동일 적용.
- - (2026-05-28) '옛 버전 자료 보고 잘못 진단함' 같은 메타 사건은 E 카테고리(docx-builder/인프라)에 등록 가능. 본질은 검토 인프라 보강 — '어떤 버전이 정본인지' 자동 판정 도구 누적.
+ 수정 파일과 이유, 제거·통합한 지침, 검증 결과와 한계를 보고한다. 저장소 변경 요청에 대한 브랜치/PR 생성은 해당 요청 범위에서 처리하며 배포·병합을 암묵적으로 추가하지 않는다.