번역 파일 변경 뒤 키 누락과 치환 문자 손상을 사람이 따로 확인하는 상황을 가정해 봅시다. 긴 요청을 매번 복사하면 검사 단계가 빠질 수 있으므로 반복 판정만 스킬로 고정할 수 있습니다.
핵심 항상 적용할 규칙은 프로젝트 지침에, 특정 작업의 절차와 스크립트는 스킬에 둡니다. 좋은 스킬은 발동 조건과 실패 출력이 분명합니다.
긴 공통 지침은 엉뚱한 작업에도 따라왔습니다. 키 수만 보는 사람과 화면만 읽는 사람이 생겼고 번역과 무관한 작업도 검사 절차를 읽었습니다. 그래서 작업 범위를 번역 파일 변경 뒤 검사로 좁혔습니다.
스킬이 약속할 결과. 설명은 선택 시점, 본문은 실행과 중단 조건만 담았습니다.
name: locale-gate
description: 번역 파일 변경 뒤 키·치환 문자·형식을 검사한다.
1. 기준 언어와 키를 비교한다.
2. 치환 문자 집합을 검사한다.
3. 실패 파일을 보고한다.
4. 자동 수정하지 않는다.발견 시험이 설명을 고쳤습니다. 발견 시험의 예시는 번역 파일 변경 요청에는 스킬이 선택되고 단순 화면 문구 추천에는 선택되지 않는 것입니다. 고의로 치환 문자를 뺀 고정 입력은 실패하고 정상 입력은 성공 종료해야 하며, 실제 종료 코드는 검사 스크립트 계약에 맞춰 확인합니다.
자동화하지 않는 경계. 한 번뿐인 절차와 운영 배포는 스킬로 감싸지 않습니다. 스크립트가 파일을 고치거나 네트워크로 전송하려 하면 읽기 단계에서 중단합니다.
스킬의 발동 조건을 찾는 명령. 이 시작 예시는 기존 번역 검사와 프로젝트 지침의 역할을 나누는 조사입니다. Claude Code에는 스킬을 바로 만들게 하지 않고 선택돼야 할 요청, 제외할 요청과 읽기 전용 검사 스크립트의 출력을 먼저 설계하게 합니다.
cd /path/to/project
claude --permission-mode plan
첫 프롬프트: 번역 검사 절차를 읽고 스킬에 둘 내용과 프로젝트 지침에 남길 내용을 구분하세요. 파일은 수정하지 마세요.
읽을 대상: i18n/, scripts/, .claude/skills/, CLAUDE.md
허용 도구: Read, Glob, Grep
Edit와 Bash는 검토 전 승인하지 않습니다.
반환 형식: 발동 요청 / 제외 요청 / 검사 스크립트 / 실패 출력 / 수정 파일스킬의 발동과 제외 조건을 맞춥니다. 사람은 발동·제외 요청이 겹치지 않는지와 검사 스크립트가 파일을 수정하지 않는지 확인합니다. 후속 프롬프트는 “승인한 번역 검사 스킬과 로컬 검사만 작성하세요. 정상·누락 치환 문자 고정 입력을 실행하고 임시 파일은 제거하되 번역 본문은 자동 수정하지 마세요”로 제한합니다.
테스트와 변경 차이를 따로 확인합니다. 번역 검사 결과와 함께 스킬·스크립트 변경만 남았는지 확인합니다.
scripts/check-locales.sh\ngit diff -- .claude/skills scripts/\ngit status --short스킬이 자동 수정을 시도하면 중단합니다. 검사 스크립트가 번역 파일을 고치거나 네트워크로 내용을 보내면 즉시 중단합니다. 같은 발동 조건과 읽기 전용 판정을 다듬을 때만 재개하고, 배포나 번역 생성까지 요구가 넓어지면 검사 결과와 발견 시험을 남긴 뒤 별도 스킬 작업으로 나눕니다.