From 1b3eee41e3ff48b5614b7ee8c71d22854e2a9c0d Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 10:49:20 +0900 Subject: [PATCH] =?UTF-8?q?test(claude):=20=EC=8A=A4=ED=82=AC=EC=9D=B4=20?= =?UTF-8?q?=EC=9D=B8=EC=9A=A9=ED=95=98=EB=8A=94=20=EC=A0=88=20=EC=9D=B4?= =?UTF-8?q?=EB=A6=84=EC=9D=84=20=EB=AC=B8=EC=84=9C=20=EC=A0=9C=EB=AA=A9?= =?UTF-8?q?=EA=B3=BC=20=EB=8C=80=EC=A1=B0=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 스킬은 정본 문서의 절을 「이름」이나 「N절」로 가리킨다. 문서 검사 (verify:documentation)는 경로만 보므로, 문서를 번역하거나 절을 바꾸면 인용한 절이 사라져도 통과한다. 지금 9곳이 그렇다. - fe-structure: 「Decision rule」(지금 「판단 규칙」), 「The adapter kernel」(지금 「adapter kernel」) - fe-a11y: 「What the automated run scans」, 「Included primitives」 - fe-design-system: 「Arbitrary-value policy」 - fe-performance: 「Service Worker steps」 - fe-ux: 「routing 6.4절」이 앞 인용(typescript 설계서)의 6.4절로 읽힌다. 그 설계서에는 6.4절이 없다. - desktop-gates: 경로 없이 `gates.md`·`operate.md`라고만 쓴다. 고른 방법: scripts/tests/test_claude_setup.py의 SkillTest에 시험을 더한다. - 모든 repo 스킬에서 읽는 인용 꼴: `경로.md` 「이름」, `경로.md` N절 (3·4절, 6.1·11절), `경로.md` N절 「이름」, 같은 문서 N절, `fe-x` 「이름」(다른 스킬의 절). - 인용마다 대상 파일에 그 제목이 있는지 본다. 제목은 앞 번호와 끝 괄호를 뗀 꼴도 받는다. 「이름:」만 있는 소제목 줄도 받는다. 코드 블록 안 제목은 보지 않는다. - 파서와 제목 읽기를 따로 고정하는 시험 둘을 함께 둔다. - 9곳은 지금 제목으로 고치고, 짧게 쓴 경로는 전체 경로로 쓴다. 버린 대안: 문서 검사(scripts/lib/docs-system.ts)에 넣는 방법. 스킬 구성의 다른 규칙이 이미 이 시험 파일에 있고, `scripts/verify.sh hooks`로 노트북에서 바로 돈다. 위험: 「 」 안의 말이 절 이름이 아닌데 경로 바로 뒤에 붙으면 거짓 실패가 난다. 경로 뒤의 —, 괄호, 문장 끝에서 읽기를 멈춰 지금 196개 인용에는 그런 경우가 없다. 「N절」이 다른 문서를 줄여 부르면(「routing 6.4절」) 앞 경로로 읽으니 전체 경로로 쓴다. 이 시험은 게이트가 아니라 hooks 단계에서 돈다. 검증: python3 -m unittest scripts.tests.test_claude_setup. - 고치기 전: 새 시험이 9곳(과 처음 판에서 거짓 실패 2곳)을 냈다(RED). - 고친 뒤: 24개 모두 통과했다. 인용 196개를 확인했다. --- .claude/skills/desktop-gates/SKILL.md | 4 +- .claude/skills/fe-a11y/SKILL.md | 4 +- .claude/skills/fe-design-system/SKILL.md | 2 +- .claude/skills/fe-performance/SKILL.md | 2 +- .claude/skills/fe-structure/SKILL.md | 4 +- .claude/skills/fe-ux/SKILL.md | 2 +- scripts/tests/test_claude_setup.py | 112 +++++++++++++++++++++++ 7 files changed, 121 insertions(+), 9 deletions(-) diff --git a/.claude/skills/desktop-gates/SKILL.md b/.claude/skills/desktop-gates/SKILL.md index 9a9ca150..34359fc9 100644 --- a/.claude/skills/desktop-gates/SKILL.md +++ b/.claude/skills/desktop-gates/SKILL.md @@ -7,7 +7,7 @@ description: 이 프론트 repo에서 pnpm·게이트·테스트·빌드·브라 정본은 `docs/work/operate.md` 4.1절(실행 위치)·4.2절(기록)과 `docs/work/reference/gates.md`(무엇을 돌릴지)다. 이 스킬은 실행 순서표다. 둘이 다르면 정본이 맞다. -1. 무엇을 돌릴지 고른다(`gates.md` 2절). merge 가능을 말하려면 `merge` 단계 전부다. 고른 스크립트 목록으로 merge 가능을 말하지 않는다. +1. 무엇을 돌릴지 고른다(`docs/work/reference/gates.md` 2절). merge 가능을 말하려면 `merge` 단계 전부다. 고른 스크립트 목록으로 merge 가능을 말하지 않는다. 2. `ssh desktop uptime`으로 부하를 적는다. 3. 돌린다. 오래 걸리면 background로 띄우고 끝나기를 한 번 기다린다. - 단계: `scripts/verify.sh merge --log <작업 이름>` @@ -21,4 +21,4 @@ description: 이 프론트 repo에서 pnpm·게이트·테스트·빌드·브라 5. 결과를 읽는다: desktop `/tmp/claude-gates/<작업 이름>/summary.txt`(첫 줄이 트리 해시), 게이트별 로그, `gate-artifacts/`, `status-after.txt`(비어 있어야 한다). 6. FE-GATE-013은 desktop에서 호스트 제약(user namespace)으로 실패한다. "호스트 제약 실패"로 적고 `parts`로 뒤 명령 결과를 함께 적는다. 7. 실패하면 기준 커밋에서도 돌려 이번 변경 몫인지 가린다. 다시 돌려 통과한 결과를 "통과"로 쓰지 않는다. -8. 보고에는 단계·게이트, rc, 시간, 핵심 숫자, 직전 부하, 트리 해시, 로그 경로를 적는다(`operate.md` 8절 표). +8. 보고에는 단계·게이트, rc, 시간, 핵심 숫자, 직전 부하, 트리 해시, 로그 경로를 적는다(`docs/work/operate.md` 8절 표). diff --git a/.claude/skills/fe-a11y/SKILL.md b/.claude/skills/fe-a11y/SKILL.md index eb28c838..eb80cea5 100644 --- a/.claude/skills/fe-a11y/SKILL.md +++ b/.claude/skills/fe-a11y/SKILL.md @@ -24,7 +24,7 @@ paths: ## 함정 1. axe 통과를 접근성 완료로 적는다. e2e 스캔의 태그는 `wcag2a`·`wcag2aa`·`wcag21a`·`wcag21aa`뿐이다. WCAG 2.2에서 더해진 기준(포커스가 가려지지 않음, 목표 크기 최소, 드래그 대안 등)은 자동으로 보지 않는다. 그리고 critical·serious 위반만 막는다. — `tests/e2e/accessibility.spec.ts`, `docs/accessibility/manual-checklist.md`, `docs/design/2026-07-26-design-system-platform-design.md` 13절 -2. 자동 스캔이 본 상태를 넘겨 짐작한다. 보호 라우트는 데모 로그인 뒤, 목록은 빈 상태, 단건 읽기 상세는 실패 상태에서 스캔하고 `notChecked`로 남긴다. 데이터가 찬 목록·상세는 기능 시험과 수동 검토 몫이다. — `docs/accessibility/manual-checklist.md` 「What the automated run scans」 +2. 자동 스캔이 본 상태를 넘겨 짐작한다. 보호 라우트는 데모 로그인 뒤, 목록은 빈 상태, 단건 읽기 상세는 실패 상태에서 스캔하고 `notChecked`로 남긴다. 데이터가 찬 목록·상세는 기능 시험과 수동 검토 몫이다. — `docs/accessibility/manual-checklist.md` 「자동 실행이 검사하는 것」 3. 린트가 의미를 잡아 줄 거라 믿는다. `eslint.config.ts`에 접근성 규칙 플러그인이 없다. `div` + 키 핸들러로 만든 버튼, 이름 없는 아이콘 버튼은 component 시험·axe·리뷰가 잡는다. — `eslint.config.ts`, `docs/design/2026-07-26-design-system-platform-design.md` 13절 4. 저장 중 버튼을 `disabled`로 바꿔 키보드 포커스를 잃게 한다. `pending`을 쓴다. — `docs/manual/02-decision-tables.md` 6절 5. 실패·복구 전이 뒤 포커스와 안내를 잃는다. 한 전이에서만 고치고 복구 성공·확인·진행 중 전이에는 없어 버튼이 무반응으로 남았다. — `docs/work/reference/structure.md` 7절, `docs/work/reference/defect-patterns.md` C11 @@ -33,7 +33,7 @@ paths: 8. modal의 포커스 가두기·배경 비활성·복원을 페이지마다 만든다. 공통 `Dialog`·`Drawer`·`ConfirmationDialog`를 쓴다. 닫으면 trigger나 안전한 위치로 포커스를 돌린다. — `docs/design/2026-07-26-design-system-platform-design.md` 8.2절 9. 같은 변경을 여러 번 읽어 준다. live region은 필요한 변경만 한 번, 라우트 제목 발표도 중복 없이. — 같은 문서 8.1절, routing 6.3절 10. 수동 검토 기록을 not-applicable로 채운다. 폼이나 dialog가 있는 라우트는 M4·M5를 not-applicable로 둘 수 없다. 새 라우트에 pending 기록이 없으면 `verify:documentation`이 실패한다. merge 게이트는 형식만 보고, 서명은 release 게이트 FE-GATE-028이 본다. — `docs/accessibility/manual-checklist.md` -11. 상태를 색만으로 전하거나 필요한 정보를 tooltip에만 둔다. — `docs/design/2026-07-26-design-system-platform-design.md` 6.1절 10번, `docs/styling/design-tokens.md` 「Included primitives」 +11. 상태를 색만으로 전하거나 필요한 정보를 tooltip에만 둔다. — `docs/design/2026-07-26-design-system-platform-design.md` 6.1절 10번, `docs/styling/design-tokens.md` 「들어 있는 primitive」 ## 이 분야에서 실패는 이렇게 보인다 diff --git a/.claude/skills/fe-design-system/SKILL.md b/.claude/skills/fe-design-system/SKILL.md index be64597b..e849c645 100644 --- a/.claude/skills/fe-design-system/SKILL.md +++ b/.claude/skills/fe-design-system/SKILL.md @@ -35,7 +35,7 @@ paths: 3. 포커스 대비 토큰을 `color-mix()`·알파·키워드로 만든다. 3:1 계산은 불투명한 `oklch()`로 끝나는 토큰만 하고 나머지는 실패한다. `color-mix()`는 `in oklab`만 쓴다. — `docs/styling/design-tokens.md` UI-01·UI-02 4. 다크 테마 재정의를 빠뜨리거나 light 전용 패널·글자색을 박는다. 핵심 역할 토큰은 `:root[data-theme="dark"]`에 모두 있어야 하고, `component.css`에 forced-colors 대체가 있어야 한다. — `docs/styling/design-tokens.md`, `scripts/check-design-system.ts` 5. 디자인 시스템 하위 파일, `lucide-react`, headless 라이브러리를 직접 import한다. `src/presentation/design-system/index.ts`와 vendor facade로만 들어간다. — `docs/architecture/layers.md` 규칙 `design-system-is-reached-through-its-index`·`icon-vendor-is-facade-only`, `docs/design/2026-07-26-design-system-platform-design.md` 6.1절 -6. 사용자 값이나 실행 중에 조립한 class 문자열을 쓰고, 같은 bracket 값을 여러 곳에 쓴다. variant는 닫힌 정적 표에서 고르고, 반복되는 bracket 값은 `@theme`로 올린다. — `docs/styling/design-tokens.md` 「Arbitrary-value policy」 +6. 사용자 값이나 실행 중에 조립한 class 문자열을 쓰고, 같은 bracket 값을 여러 곳에 쓴다. variant는 닫힌 정적 표에서 고르고, 반복되는 bracket 값은 `@theme`로 올린다. — `docs/styling/design-tokens.md` 「임의 값(arbitrary value) 정책」 7. 컴포넌트 API를 열어 둔다: 날 색 prop, vendor 타입 노출, 무제한 `as`, 범위 없는 `className`. — `docs/design/2026-07-26-design-system-platform-design.md` 11절 4단계, 13절 8. primitive가 API·query·인증·저장소를 직접 부른다. pattern·template도 use case를 고르지 않고 상태와 callback을 props로 받는다. — 같은 문서 2절 9. 세 번째 사용 사례가 나오기 전에 제품 전용 조합을 primitive로 올린다. — 같은 문서 2절 diff --git a/.claude/skills/fe-performance/SKILL.md b/.claude/skills/fe-performance/SKILL.md index ead44617..db1a0547 100644 --- a/.claude/skills/fe-performance/SKILL.md +++ b/.claude/skills/fe-performance/SKILL.md @@ -39,7 +39,7 @@ paths: 7. 의존성 하나를 올리고 번들을 안 본다. 갱신 하나가 초기 JS를 약 7 KB 늘려 예산을 넘긴 예가 있다. — `docs/work/reference/performance.md` 2절 8. 조건 없이 숫자를 비교한다. 노트북 측정, 지난 측정을 대조군으로 쓰기, 표본 하나는 비교에 쓰지 않는다. — 같은 문서 3절 9. lab이 재는 범위를 넘겨 짐작한다. `/` 밖 화면의 layout shift, 스크롤바가 보이는 환경은 어느 게이트도 재지 않는다. 기능 라우트 로딩을 바꾸면 그 라우트 첫 진입을 lab과 같은 조건으로 따로 잰다(제안). — 같은 문서 6절, 결함 패턴 B2 -10. Service Worker를 페이지 코드처럼 다룬다. install에서 `skipWaiting()`을 부르지 않는다. 모든 탭이 닫히거나 `requestActivation()`까지 기다린다. 캐시 이름은 자산 묶음 digest이고, 기다리는 동안 release마다 precache가 하나씩 남는다. worker는 HTML·자산과 같은 빌드에서 나온다. 지우는 데 release 셋이 든다. — `docs/operations/release-cache-rollback.md` 「Service Worker steps」 +10. Service Worker를 페이지 코드처럼 다룬다. install에서 `skipWaiting()`을 부르지 않는다. 모든 탭이 닫히거나 `requestActivation()`까지 기다린다. 캐시 이름은 자산 묶음 digest이고, 기다리는 동안 release마다 precache가 하나씩 남는다. worker는 HTML·자산과 같은 빌드에서 나온다. 지우는 데 release 셋이 든다. — `docs/operations/release-cache-rollback.md` 「Service Worker 절차」 11. 청크 로드 실패에 제한 없이 `location.reload`한다. 새 manifest가 확인되고 같은 build에서 한 번만 reload한다. — `docs/design/2026-07-26-routing-pages-and-patterns-design.md` 6.2·11절 12. 런타임 설정·release manifest를 캐시하게 둔다. `config.json`·`release-manifest.json`은 `no-store`, HTML은 `no-cache`, 해시 자산만 1년 `immutable`이다. — `config/hosting/cache-policy.json` diff --git a/.claude/skills/fe-structure/SKILL.md b/.claude/skills/fe-structure/SKILL.md index a81af21e..77a755a4 100644 --- a/.claude/skills/fe-structure/SKILL.md +++ b/.claude/skills/fe-structure/SKILL.md @@ -31,7 +31,7 @@ paths: ## 함정 1. 배럴을 건너뛰어 그룹 내부 파일을 import한다. 2단계 `index.ts`(예: `http/internals/index.ts`)도 공개 배럴이 아니다. 예외는 `storage/indexeddb`·`storage/opfs` 서브배럴뿐이다. — 루트 `AGENTS.md` 꼭 지킬 것 1, `docs/architecture/layers.md` 「어댑터 그룹의 공개 경계」 -2. adapter끼리 import가 필요해 파일 하나를 `pathNot`에 더한다. 예외는 kernel 셋뿐이다. 새 공유 프리미티브는 `src/adapters/platform/`에 둔다. 폴더 전체가 예외라 규칙을 바꿀 필요가 없다. kernel 파일은 메커니즘만 갖고 이름·스키마·실패 code·관측 모양을 갖지 않는다. — 꼭 지킬 것 2, `docs/architecture/layers.md` 「The adapter kernel」, `docs/work/reference/defect-patterns.md` S5 +2. adapter끼리 import가 필요해 파일 하나를 `pathNot`에 더한다. 예외는 kernel 셋뿐이다. 새 공유 프리미티브는 `src/adapters/platform/`에 둔다. 폴더 전체가 예외라 규칙을 바꿀 필요가 없다. kernel 파일은 메커니즘만 갖고 이름·스키마·실패 code·관측 모양을 갖지 않는다. — 꼭 지킬 것 2, `docs/architecture/layers.md` 「adapter kernel」, `docs/work/reference/defect-patterns.md` S5 3. `depcruise`를 돌려 통과로 본다. dependency-cruiser CLI는 TypeScript 7을 못 읽어 0개 모듈을 보고 통과한 일이 있다. 판정은 `check:architecture`다. — 꼭 지킬 것 3, `docs/architecture/layers.md` 끝 절 4. 규칙이 edge 하나씩만 본다는 것을 잊는다. 기능 루트 파일·`src/contexts`·`src/apps`에서 adapter를 re-export하면 다른 규칙이 다 통과해도 adapter가 presentation으로 실려 간다. 그래서 `feature-and-app-roots-do-not-reach-adapters`가 있다. — `docs/architecture/layers.md` 5. `import.meta.glob`으로 모듈을 불러온다. 이름 없이 모듈을 실어 그래프가 edge를 못 보므로 parse failure로 실패한다. — 같은 문서 끝 절 @@ -49,7 +49,7 @@ paths: - [ ] presentation은 adapter·bootstrap을 모르고(예외 `src/presentation/adapters/query`), 직접 fetch하지 않는다. application은 React·TanStack·adapter를 모른다. — `docs/architecture/layers.md` 규칙 표 - [ ] 기능끼리, context끼리 import하지 않는다. 공용이 필요하면 `src/contracts/`나 kernel로 옮기는 일을 따로 묻는다. — `src/features/AGENTS.md`, `src/contexts/AGENTS.md` - [ ] zod는 `src/contracts/zod.ts`로만, 아이콘은 lucide facade로만, 관측 vendor는 adapter 뒤에서만 쓴다. — `docs/architecture/layers.md` -- [ ] 공유 타입의 위치는 `docs/architecture/contract-ownership.md` 「Decision rule」로 정한다. contracts는 application·features·presentation·bootstrap을 모른다. — `src/contracts/AGENTS.md` +- [ ] 공유 타입의 위치는 `docs/architecture/contract-ownership.md` 「판단 규칙」로 정한다. contracts는 application·features·presentation·bootstrap을 모른다. — `src/contracts/AGENTS.md` - [ ] 규칙 예외에는 `pathNot`과 `comment`(이유·담당·재검토 조건)가 함께 있다. 예외가 실제 쓰임보다 넓지 않다. — `docs/work/reference/structure.md` 3절·10절 - [ ] 선택하지 않은 realtime·web-push runtime을 조립하지 않는다. 기능 runtime은 `src/features/loaded-feature-runtimes.ts`만 불러온다. — `src/bootstrap/AGENTS.md` - [ ] 소비자 없는 확장 지점과 빈 레지스트리를 지우자고 하지 않는다. 다운스트림용이다. — 루트 `AGENTS.md` 첫 문단, `docs/work/reference/review-criteria.md` 2절 diff --git a/.claude/skills/fe-ux/SKILL.md b/.claude/skills/fe-ux/SKILL.md index c7ee38b4..3cb18f56 100644 --- a/.claude/skills/fe-ux/SKILL.md +++ b/.claude/skills/fe-ux/SKILL.md @@ -59,7 +59,7 @@ paths: 폼 - [ ] label·설명·오류가 연결되고, 제출 실패 시 오류 요약으로 포커스가 가며, 요약 항목은 그 필드로 간다. — `docs/design/2026-07-26-design-system-platform-design.md` 8.3절 -- [ ] 409를 검증 오류로 위장하지 않는다. 이탈 확인(`useDirtyNavigationGuard`)은 성공 저장 뒤 풀고 이동한다. — `docs/design/2026-07-26-typescript-state-and-data-flow-design.md` 8절, routing 6.4절 +- [ ] 409를 검증 오류로 위장하지 않는다. 이탈 확인(`useDirtyNavigationGuard`)은 성공 저장 뒤 풀고 이동한다. — `docs/design/2026-07-26-typescript-state-and-data-flow-design.md` 8절, `docs/design/2026-07-26-routing-pages-and-patterns-design.md` 6.4절 - [ ] 자동 완성·IME·붙여넣기·비밀번호 관리자를 막지 않는다. 입력을 loading skeleton으로 덮지 않는다. — data-flow 8절 반응형 diff --git a/scripts/tests/test_claude_setup.py b/scripts/tests/test_claude_setup.py index e30b2994..3ed0aeaa 100644 --- a/scripts/tests/test_claude_setup.py +++ b/scripts/tests/test_claude_setup.py @@ -29,6 +29,72 @@ KNOWLEDGE_SECTIONS = ["언제 쓰나 · 넘기는 곳", "함정", "이 분야에 BANNED_IN_DESCRIPTION = ("PROACTIVELY", "MUST", "CRITICAL", "IMPORTANT", "") +# A skill points at a section as `path.md` 「name」, `path.md` 3.1절 (or 3·4절), `path.md` 4.1절 「name」, +# 같은 문서 6절 (the path cited last), or `fe-x` 「name」 (another skill's section). +CITED_TARGET = re.compile(r"`([^`\s]+\.md)`|`((?:fe-[a-z0-9-]+|new-feature|desktop-gates))`|(같은 문서)") +SECTION_NUMBERS = re.compile(r"(\d+(?:\.\d+)*(?:·\d+(?:\.\d+)*)*)절") +SECTION_NAME = re.compile(r"「([^」]+)」") +# What follows a citation up to the first of these is about that citation; past it is the sentence's own text. +CITATION_END = re.compile(r"—|`|\(|\)|;|\. |。") +HEADING_NUMBER = re.compile(r"^(\d+(?:\.\d+)*)\.?(?=\s)") + + +# A paragraph label on its own line ("자동 실행이 검사하는 것:") names a part of a section the same way a heading does. +LABEL_LINE = re.compile(r"^\*{0,2}([^\s*#|>`-][^:|]*?)\*{0,2}:\s*$") + + +def headings(path: Path) -> tuple[set[str], set[str]]: + """The section names of a markdown file and the numbers of its numbered headings. + + A name is a heading's text, with and without its leading number and a trailing "(…)", or a label line.""" + names, numbers, fenced = set(), set(), False + for line in path.read_text(encoding="utf-8").splitlines(): + if line.startswith("```"): + fenced = not fenced + if fenced: + continue + label = LABEL_LINE.match(line) + if label: + names.add(label.group(1).strip()) + if not re.match(r"#{1,6} ", line): + continue + text = line.lstrip("#").strip() + number = HEADING_NUMBER.match(text) + if number: + numbers.add(number.group(1)) + for name in (text, text[number.end():].strip() if number else text): + names.add(name) + names.add(re.sub(r"\s*\([^()]*\)$", "", name)) + return names, numbers + + +def cited_sections(text: str) -> list[tuple[int, str, str]]: + """(line, target file, 「name」 or N절) for every section a skill names after a path or another skill.""" + found, last_path = [], None + for number, line in enumerate(text.splitlines(), 1): + matches = list(CITED_TARGET.finditer(line)) + for index, match in enumerate(matches): + path, skill, same = match.groups() + if path: + target = last_path = path + elif skill: + target = f".claude/skills/{skill}/SKILL.md" + elif last_path: + target = last_path + else: + continue + rest = line[match.end(): matches[index + 1].start() if index + 1 < len(matches) else len(line)] + end = CITATION_END.search(rest) + segment = rest[: end.start()] if end else rest + if skill or same: + # Only a section named right after it: `fe-x`의 「검증」, 같은 문서 12절. + segment = re.match(r"(?:의)?\s*(?:\d[\d.·]*절\s*)?(?:「[^」]+」)?", segment).group(0) + for numbers in SECTION_NUMBERS.findall(segment): + found.extend((number, target, f"{value}절") for value in numbers.split("·")) + found.extend((number, target, f"「{name}」") for name in SECTION_NAME.findall(segment)) + return found + + def front_matter(path: Path) -> tuple[dict[str, str], list[str]]: """The scalar fields and the list items of a document's YAML front matter.""" match = re.match(r"^---\n(.*?)\n---\n", path.read_text(encoding="utf-8"), re.S) @@ -185,6 +251,52 @@ class SkillTest(unittest.TestCase): self.assertIn("쓴다", description, f"{name}: say when to use it") self.assertIn("부른다", description, f"{name}: say what the user says that calls it") + def test_every_section_a_skill_cites_is_a_heading_of_that_document(self) -> None: + # The path check (verify:documentation) passes when a cited document is translated or renumbered + # and the section the skill names is gone: 「Decision rule」 outlived its heading this way. + missing = [] + for path in sorted((CLAUDE / "skills").glob("*/SKILL.md")): + for line, target, section in cited_sections(path.read_text(encoding="utf-8")): + document = REPO / target + if not document.is_file(): + missing.append(f"{path.parent.name}:{line}: {target} does not exist") + continue + names, numbers = headings(document) + known = numbers if section.endswith("절") and not section.startswith("「") else names + if section.strip("「」").removesuffix("절") not in known: + missing.append(f"{path.parent.name}:{line}: {target} has no section {section}") + self.assertEqual(missing, [], "\n" + "\n".join(missing)) + + def test_the_section_check_reads_each_citation_form(self) -> None: + text = "\n".join([ + "- 배럴 — `docs/a.md` 「공개 경계」, `docs/b.md` 3·4.1절", + "- 토큰 — `docs/c.md` 6절 「검사 규칙」, 같은 문서 12절", + "- 원칙 — `PRODUCT.md` 원칙 1, 「Constraints」", + "- 골든을 본다(`fe-design-system` 「검증」). 예제가 없으면 「없음」", + "- `docs/d.md` — 설명. 아래 「함정」", + ]) + self.assertEqual(cited_sections(text), [ + (1, "docs/a.md", "「공개 경계」"), (1, "docs/b.md", "3절"), (1, "docs/b.md", "4.1절"), + (2, "docs/c.md", "6절"), (2, "docs/c.md", "「검사 규칙」"), (2, "docs/c.md", "12절"), + (3, "PRODUCT.md", "「Constraints」"), + (4, ".claude/skills/fe-design-system/SKILL.md", "「검증」"), + ]) + + def test_the_section_check_reads_headings_numbers_and_labels(self) -> None: + import tempfile + with tempfile.TemporaryDirectory() as folder: + document = Path(folder) / "doc.md" + document.write_text("\n".join([ + "# 제목", "## 3. merge 가능 판정", "### 3.1 열린 결정", "#### 토큰 CSS 검사 규칙 (`check:design-system`)", + "임의 값(arbitrary value) 정책:", "- 목록 줄: 이름이 아니다", "```text", "## 9. 코드 안 제목", "```", + ]), encoding="utf-8") + names, numbers = headings(document) + self.assertEqual(numbers, {"3", "3.1"}) + for name in ("merge 가능 판정", "열린 결정", "토큰 CSS 검사 규칙", "임의 값(arbitrary value) 정책"): + self.assertIn(name, names) + self.assertNotIn("코드 안 제목", names) + self.assertFalse(any(name.startswith("목록 줄") for name in names)) + def test_each_skill_points_at_its_canonical_playbook_instead_of_copying_it(self) -> None: for name, canon in self.CANON.items(): body = (CLAUDE / "skills" / name / "SKILL.md").read_text(encoding="utf-8")