| name | review-style-continual |
| description | audit-log.jsonl의 finding.resolved 이력(확정/기각)을 읽어 프로젝트별 리뷰 스타일 프롬프트(10-review/review-style/style.md)를 승격/억제로 편집한다. 온디맨드·로컬 전용, 외부 SDK 없음. "리뷰 학습", "review style", "continual learning" 요청 시 사용. |
review-style-continual — 리뷰 자기개선 스킬 (CF-C1 · US11 · SS12)
근거: _recon/open-swe-analysis.md §3-2(continual-learning), service-layer-design-kr.md §1,
story-c1-review-continual-kr.md. 편집이지 재작성이 아니다(adr/D-0003) — 스타일 파일의
마커 블록만 갱신하고 사람이 쓴 나머지 내용은 절대 건드리지 않는다.
언제 쓰는가
사용자가 "리뷰 스타일을 학습/갱신해줘", "지난 리뷰 이력으로 리뷰 기준 업데이트해줘" 등을
요청하거나, 웨이브 종료 시 리뷰 확정/기각 이력이 쌓였는지 점검할 때 온디맨드로 호출한다.
크론 아님 — 상시 서비스로 등록하지 않는다(charter §3 카피금지, open-swe 야간 크론 배제).
절차 (에이전트가 수행)
- 계획 실행(dry-run, 기본):
python3 .claude/skills/review-style-continual/scripts/aggregate.py \
--audit-log .agent-team/_state/audit-log.jsonl \
--findings-index .agent-team/10-review/findings-index.jsonl \
--style-path .agent-team/10-review/review-style/style.md \
--history-dir .agent-team/10-review/review-style/history
출력은 diff 미리보기다(파일을 쓰지 않는다).
- diff를 사용자에게 그대로 보여주고 승인을 받는다(UX 규약 — AI가 리뷰 스타일을
몰래 바꾸지 않는다, User Sovereignty). 승인 없이 3단계로 넘어가지 않는다.
- 승인 시: 위 명령에
--apply를 추가해 재실행한다. 완료 요약([bathos review-learn] ✓ ...)을
그대로 사용자에게 보고한다.
- 거부/보류 시: 아무것도 쓰지 않는다. "다음 실행 시 재검토"라고 안내한다.
입력 계약 (읽기 전용)
.agent-team/_state/audit-log.jsonl — action=="finding.resolved", target="<finding_id>:<resolution>"
형식(schema-extensions-kr.md §2b, Phillip A1 스토리가 CLI로 확립). 손상된 라인은 관용적으로 스킵..agent-team/10-review/findings-index.jsonl(선택) — finding_id -> category 조인 뷰.
이 인덱스의 실 데이터는 Thomas(W5 코드 리뷰)가 채워야 한다(schema-extensions §2a
resolution 필드 실기록, risk-log C-3). 부재 시 전부 uncategorized로 정직하게 표시하며
크래시하지 않는다(날조 금지).
분류 규칙 (모두 "(추정, 구현 시 조정)" — 실 데이터로 튜닝 필요)
| 상태 | 조건 | 동작 |
|---|
insufficient(관측 부족) | 결정적 표본(fixed+dismissed) < 5 | 편집 보류, 기본 스타일 유지 |
conflict(판단 유보) | |확정률-기각률| < 0.2 | 세분류 필요 안내, 억지 승격 금지 |
promote(승격) | 확정률 ≥ 0.7 | style.md에 강조 반영 |
suppress(억제) | 기각률 ≥ 0.7 | style.md에 디강조/제외 권고 |
neutral | 그 외 | 변경 없음 |
콜드스타트(finding.resolved 이벤트 0건)는 에러가 아니라 "관측 부족" 안내로 처리한다(AC4).
출력 규약
- 접두
[bathos review-learn], 흑백 기호(✓/·)만 사용(design-handoff §7 계승).
- 완료:
[bathos review-learn] ✓ 스타일 v3 저장: +2 승격 / -1 억제
- 콜드스타트:
[bathos review-learn] · 관측 부족(콜드스타트) — 편집 보류
- 변경 없음:
[bathos review-learn] · 변경 없음(임계 미달 카테고리뿐)
Boundaries (스코프 밖)
audit-log.jsonl에 직접 쓰지 않는다(단일 writer는 bathos audit append 경유, 이 스킬은
소비자일 뿐).- 외부 SDK/네트워크(LangSmith 등) 의존 없음 — 전부 로컬 파일 집계(AC5).
style.md를 통째로 재작성하지 않는다 — 마커 블록만 편집(재작성 시도는 버그로 간주).findings-index.jsonl의 실데이터 채굴/기록은 이 스킬의 책임이 아니다(Thomas/Phillip 인계).- 표본 임계(5)·승격/억제 임계(0.7)·상충 마진(0.2)은 전부 추정치다. 실 데이터 누적 후
Matthias/Thomas와 함께 재조정할 것(구현 시 확정이 아니라 관측 기반 튜닝 대상).
테스트
bash .claude/skills/review-style-continual/tests/run_tests.sh
합성 audit-log 픽스처로 9개 결정성 테스트(승격/억제/보류/유보/콜드스타트/조인 실패/손상
라인/재실행 편집/이력 스냅샷)를 검증한다. 외부 의존 없음(python3 표준 라이브러리만).
