fix(scripts): 이력 검사가 앞말 없는 번호 목록·리뷰 영역·묶음 번호를 잡는다
문제: check-work-docs.py --history는 리뷰·라운드 낱말 바로 뒤의 NN-NN만
발견 번호로 본다. 그래서 앞말 없이 나열한 "(05-01, 04-01, 06-01)",
"리뷰 01 영역 5.2절", "sample P30 결정"을 놓친다. 2026-11-07 docs/manual
이력 걷어내기에서 검사가 찾은 16줄을 고친 뒤 docs-writing.md 9절대로
grep으로 다시 읽으니 이 꼴 3줄이 더 있었다.
고른 방법: 패턴 셋을 더한다.
- 쉼표+공백이나 가운뎃점으로 이은 NN-NN 둘 이상. 콜론 뒤 줄 범위
("Foo.java:10-12,20-24")와 공백 없는 쉼표 범위는 잡지 않는다
- "리뷰 NN 영역", "NN 영역 N.N절"
- 2026-09-25 리뷰 후속 묶음 번호 P10~P49와 "W3-P30" 꼴
버린 대안:
- 홀로 선 NN-NN 하나까지 잡기. 장 번호·범위 같은 보통 숫자가 걸린다
- P 뒤 두 자리를 모두 잡기. P95·P99 같은 백분위수가 걸린다
위험·한계: 검사는 여전히 아는 꼴만 잡는다. P1~P9 묶음 번호는 우선순위
P0~P3과 겹쳐 잡지 않는다. 문서가 자기 목록에 P10~P49 번호를 붙이면
이력이 아니어도 잡는다(docs/study/graphql-walkthrough.ko.md의 할 일
번호 P10·P11). 지금 검사 대상인 docs/work 본문과 docs/manual에는 그런
줄이 없다. 이 커밋만 있으면 --history docs/manual이 19줄, rc=1이다.
다음 커밋이 그 19줄을 걷어낸다. 기본 모드(docs/work 본문, 루트
CLAUDE.md)는 0줄 그대로다.
검증(desktop worktree, 다음 커밋까지 얹은 트리 8ff82a67과 같은 스크립트):
- 기준 커밋 73d39212의 docs/manual: 옛 스크립트 16줄, 새 스크립트 19줄.
더 잡은 3줄은 03-placement.md:40·:54, 05-idempotency.md:93이다
- 오탐 시험 14줄: 보통 문장 8줄(p95·P99, 콜론 뒤 줄 범위, 날짜 쌍,
홀로 선 번호, 장 번호)은 안 잡고 이력 6줄은 잡았다
- 노트북에서 docs/reviews 밖 *.md에 새 패턴을 돌려 걸린 65줄을 읽었다.
위 할 일 번호 4줄 말고는 모두 실제 이력 번호였다
- 기본 모드 rc=0, 본문 이력 0줄
This commit is contained in:
@@ -87,6 +87,15 @@ HISTORY_PATTERNS = [
|
||||
("finding number after a review or round word (리뷰 02-01)",
|
||||
re.compile(r"(?:리뷰|라운드|(?<![A-Za-z])[Rr]eview)[^|()\n]{0,20}?(?<![\w./-])\d{2}-\d{2}(?![\w-])",
|
||||
re.ASCII)),
|
||||
# Finding numbers listed with no word in front: "(05-01, 04-01, 06-01)", "01-01·07-09". One
|
||||
# bare NN-NN stays allowed, because a lone pair is often an ordinary range or chapter number.
|
||||
# Line ranges after a colon ("Foo.java:10-12,20-24") are not findings.
|
||||
("list of finding numbers (05-01, 04-01)",
|
||||
re.compile(r"(?<![\w./:,-])\d{2}-\d{2}(?:, |·)\d{2}-\d{2}(?![\w-])", re.ASCII)),
|
||||
("review area number (리뷰 01 영역, 01 영역 5.2절)",
|
||||
re.compile(r"리뷰 ?\d{2} ?영역|(?<![\w.])\d{2} ?영역 \d+(?:\.\d+)*절", re.ASCII)),
|
||||
# Review-followup fix bundles ran from P1 to P34. P50 and above are left to percentiles (P95).
|
||||
("review-followup fix bundle (P30, W3-P30)", re.compile(r"\b(?:W\d-)?P[1-4]\d\b", re.ASCII)),
|
||||
("round number in Korean (1라운드, 라운드6)",
|
||||
re.compile(r"(?<![\w.])\d{1,2} ?라운드|라운드 ?\d{1,2}(?![\w.])", re.ASCII)),
|
||||
("review README section number (리뷰 README 13절)", re.compile(r"리뷰 README \d", re.ASCII)),
|
||||
|
||||
Reference in New Issue
Block a user