Doc sync
이 레포의 3개국어 문서(README.md / README_KO.md / README_JA.md)와 모든 shields.io 뱃지를 동기화한다. README(EN)를 수정했거나, "문서 동기화", "번역 맞춰줘", "KO/JA 업데이트", "뱃지 버전 맞춰줘", "README 3종 일치", "문서 다시 동기화" 요청 시 반드시 사용. 단, 코드/로직만 고치고 문서는 그대로일 때, 번역이 필요 없는 단순 오타 하나 교정, README 외 문서(CHANGELOG·docs/ 등)만 편집할 때는 트리거하지 않는다(near-miss). doc-syncer 에이전트가 이 스킬을 사용한다.From its SKILL.md
npx -y skills add cookyman74/my_harness --skill doc-syncAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
SKILL.md
2.5 KB, as published. Nobody here has run it
doc-sync — 3개국어 문서 동기화
EN(README.md)을 단일 출처로 KO/JA + 뱃지를 일치시킨다.
트리거
다음일 때 사용한다:
- README(EN)를 수정해 KO/JA·뱃지가 뒤처졌을 때.
- "문서 동기화", "번역 맞춰줘", "KO/JA 업데이트", "뱃지 버전 맞춰줘", "README 3종 일치", "문서 다시 동기화" 요청.
다음은 유사하지만 트리거가 아니다(near-miss):
- 코드·로직만 바꾸고 문서 변경이 없을 때.
- README 외 문서(CHANGELOG,
docs/등)만 손볼 때. - 번역이 필요 없는 단순 오타 하나 교정.
왜
이 레포의 단골 버그는 EN만 고치고 KO/JA가 뒤처지거나, 버전을 올렸는데 README 뱃지 3종이 안 맞는 것이다(CHANGELOG 1.2.1 항목 참조). 줄 수가 아니라 의미 단위 대응이 깨지면 사용자가 보는 문서가 거짓말을 한다.
절차
- 기준 로드 —
README.md를 읽고 섹션/표/항목 목록을 추출(목차 수준). - 대조 —
README_KO.md,README_JA.md를 같은 구조로 읽어 누락/추가/순서 차이를 표로 만든다. - 전파 — EN 변경을 KO/JA에 반영. 번역은 자연스럽게, 코드·경로·명령·URL은 변형 금지.
- 뱃지 동기 — 목표 버전(plugin.json 기준)으로 세 파일의
img.shields.io/badge/Version-x.y.z통일. 패턴 수 뱃지 등 다른 뱃지도 EN과 일치. - 상호 링크 확인 — 세 README 상단의 언어 전환 링크가 살아있는지.
- 검증 요청 —
repo-qa에 교차 검증 요청.
규칙
- KO/JA에만 있고 EN엔 없는 섹션은 삭제하지 말고 보고(의도된 현지화일 수 있음).
- EN 원문 의도가 모호하면 추측 번역 금지 → 질문.
- 변경 요약은
_workspace/{phase}_doc-syncer_sync.md에 기록.
후속 실행
이전 _workspace/*doc-syncer*가 있으면 읽고 차이분만 갱신한다. "다시 동기화"는 전체 재대조.