feat(skill): refine brand-claim copy diagnosis and impact-based render checks

Limit competitor substitution to brand-differentiation claims, add impact-scoped render measurement guidance to audit-gate, and correct motion, Range, and font-check wording found during review.
This commit is contained in:
Yun Chan 2026-09-24 08:07:18 +09:00
parent 2a7017717b
commit 79e79c120b
8 changed files with 114 additions and 26 deletions

View file

@ -0,0 +1,37 @@
# 조각달 교훈 반영 스킬 개선 · 2026-09-20
## 목적과 범위
목적은 정확한 카피 판단과 렌더 계측을 개선하는 것이다. 조각달 자체 수정, 새 JS 검사 엔진, 일괄 폰트 선정, 릴리스, 설치본 강제 덮기는 범위가 아니다.
## 완료 상태
| 단계 | 범위 | 상태 |
| --- | --- | --- |
| P1 | 카피와 체크리스트 교정 | DONE |
| P2 | 렌더 측정 절차와 타이포·레이아웃 참조 | DONE |
| P3 | Astra diff 리뷰 | DONE |
| P4 | lint·build·test·패키지 동봉 검증 | DONE |
| P5 | 최종 정리 | DONE |
수정한 소스 스킬 문서는 `SKILL.md`, `antipatterns.md`, `audit-gate.md`, `layout.md`, `preflight.md`, `typography.md` 6개다. changeset은 준비됐고 버전은 `0.12.1`을 유지한다. 릴리스와 전역 설치는 실행하지 않았다.
## 검증 증거
| 검증 명령 | 결과 | 원문 |
| --- | --- | --- |
| `node build/ci/lint-skill.mjs packages/skill` | 경고 0건 | [01-lint-skill.log](../outputs/skill-upgrade-verify/01-lint-skill.log) |
| `pnpm build` | 성공 | [02-build.log](../outputs/skill-upgrade-verify/02-build.log) |
| `pnpm -r --filter './packages/**' test` | Core 23건, CLI 11건 통과; fail 0, skip 0 | [03-package-tests.log](../outputs/skill-upgrade-verify/03-package-tests.log) |
| `node packages/cli/scripts/verify-package.mjs` | `v0.12.1` 통과 | [04-verify-package.log](../outputs/skill-upgrade-verify/04-verify-package.log) |
| `npm pack --dry-run --json` | 6개 문서 모두 포함 | [06-npm-pack-dry-run.log](../outputs/skill-upgrade-verify/06-npm-pack-dry-run.log) |
| source와 bundle의 LF SHA-256 비교 | 6/6 동일 | [07-six-document-hashes.csv](../outputs/skill-upgrade-verify/07-six-document-hashes.csv) |
## 검토 이력
- 2026-09-20: 경쟁사 치환은 브랜드 차별성 주장에만 쓰는 진단으로 제한했다. 안내 카피는 실제 질문, 검증 가능한 사실, 자연스러운 업종 표현으로 판단한다.
- 2026-09-20: preflight 반응형 범위 확대안은 1차 리뷰에서 반려했다. 기존 wide·split·padding 회귀 항목을 복원하고 영향 기반 검사 한 항목만 추가했다.
- 2026-09-20: 모션 70ms 강제 기준, `Range` 설명, 폰트 검사 과장 표현을 정확성 검토로 교정했다.
- 2026-09-20: Astra가 P1·P2·P3 diff와 P4 검증 증거를 수용했다.
남은 코드 작업은 없다. 출시가 필요해지면 저장소의 기존 release 절차를 사용한다.