[to main] feat: Codex 번역 검증 스킬과 마켓플레이스 추가

[gusdn3477]

• Claude Code와 같은 사고 흐름을 하는 Codex Skill을 만들어 봤습니다.
• 다만 특정 파일을 통해 스킬 테스트를 해봤는데요. 결과는 댓글에 첨부드리겠습니다.
• Claude Code 기존 Skill과 비슷한 결과가 나오는 게 목표였어서 한번 스킬 통해서 테스트 해주시면 감사하겠습니다.

[gusdn3477]

원문 주소 첨부드립니다. 해당 파일 기준으로 스킬 사용했습니다.

문서 구조 문제 (4개)

줄	규칙 ID	심각도	위반 내용	수정 제안
12	PRECHECK-MERGE-CONFLICT	🔴 필수	12~16행에 병합 충돌 블록이 남아 있음	한국어 번역을 선택하고 충돌 표식과 영문 원문을 제거
15	PRECHECK-UNTRANSLATED	🔴 필수	JavaScript programs can be inserted almost anywhere...	기존 13행의 한국어 번역으로 확정
80	PRECHECK-MERGE-CONFLICT	🔴 필수	80~84행에 병합 충돌 블록이 남아 있음	최신 의미를 반영한 한국어 번역을 선택하고 충돌 표식과 영문 원문을 제거
83	PRECHECK-UNTRANSLATED	🔴 필수	Here, /path/to/script.js is an absolute path...	src="./script.js"와 src="script.js"가 같은 의미라는 내용을 포함해 번역

번역 규칙 위반 (43개)

줄	규칙 ID	심각도	위반 내용	수정 제안
1	WIKI-15	🔴 필수	Hello, world!	Hello, world
3	CUSTOM-금지표현	🟡 권고	독립적인	관계없는
3	CUSTOM-병기	🔴 필수	실행 환경	실행 환경(runtime environment)
3	WIKI-5	🔴 필수	여러분이 읽고 있는 이 파트는	이 파트는
5	KIGO-맞춤법	🔴 필수	실행환경	실행 환경
5	KIGO-수동형	🔴 필수	본 튜토리얼은 온라인으로 제공되기 때문에	온라인 튜토리얼이기 때문에
5	KIGO-시제	🔴 필수	브라우저 한정 명령어(alert 등)는 최소한으로 사용하도록 하겠습니다	브라우저 한정 명령어(alert 등)는 최소한으로 사용합니다
5	KIGO-시제	🔴 필수	브라우저를 사용하도록 하겠습니다	브라우저를 사용합니다
5	KIGO-시제	🔴 필수	에서 다루도록 하겠습니다	에서 다룹니다
5	WIKI-12	🔴 필수	alert 등	alert 함수 등
5	WIKI-3	🔴 필수	있긴 하지만,	있긴 하지만
5	WIKI-3	🔴 필수	학습자를 위해,	학습자를 위해
7	WIKI-3	🔴 필수	먼저,	먼저
42	KIGO-수동형	🔴 필수	예제가 실행됩니다	예제를 실행합니다
50	WIKI-14	🔴 필수	이 속성을	이런 속성을
50	WIKI-3	🔴 필수	사용하진 않지만,	사용하진 않지만
53	CUSTOM-병기	🔴 필수	자바스크립트 모듈	자바스크립트 모듈(JavaScript module)
53	KIGO-시제	🔴 필수	다른 파트에서 다시 이야기하도록 하겠습니다	다른 파트에서 다시 이야기합니다
58	CUSTOM-병기	🔴 필수	주석	주석(comment)
67	WIKI-3	🔴 필수	수 있으므로,	수 있으므로
70	CUSTOM-병기	🔴 필수	외부 스크립트	외부 스크립트(external script)
72	WIKI-3	🔴 필수	경우엔,	경우엔
81	CUSTOM-병기	🔴 필수	상대 경로	상대 경로(relative path)
81	CUSTOM-병기	🔴 필수	절대 경로	절대 경로(absolute path)
101	KIGO-수동형	🔴 필수	스크립트가 길어지면 별개의 분리된 파일로 만들어 저장하는 것이 좋습니다	스크립트가 길어지면 별도 파일로 나누어 저장하는 것이 좋습니다
103	WIKI-3	🔴 필수	때문에,	때문에
103	WIKI-4	🔴 필수	다운받아	다운로드하여
105	WIKI-3	🔴 필수	경우,	경우
105	WIKI-4	🔴 필수	다운받으면	다운로드하면
105	WIKI-4	🔴 필수	다운받지	다운로드하지
105	WIKI-7	🟡 권고	‘스크립트’가 한 문단에서 반복되어 문장이 단조롭습니다.	두 번째 이후의 ‘스크립트’를 ‘파일’ 등 문맥에 맞는 표현으로 바꿔 반복을 줄이세요.
107	KIGO-수동형	🔴 필수	이를 통해 트래픽이 절약되고 웹 페이지의 실제 속도가 빨라집니다	이를 통해 트래픽을 절약하고 웹 페이지의 실제 속도를 높일 수 있습니다
107	WIKI-6	🔴 필수	이를 통해 트래픽이 절약되고 웹 페이지의 실제 속도가 빨라집니다.	이를 통해 트래픽을 절약하고 웹 페이지의 실제 속도를 높일 수 있습니다.
110	KIGO-제목	🔴 필수	src 속성이 있으면 태그 내부의 코드는 무시됩니다.	태그 내부 코드를 무시하는 src 속성
113	KIGO-수동형	🔴 필수	다음 코드는 실행되지 않습니다	브라우저는 다음 코드를 실행하지 않습니다
123	CUSTOM-금지표현	🟡 권고	정상적으로	문제없이
123	KIGO-수동형	🔴 필수	위의 예시는 스크립트 두 개로 분리하면 정상적으로 실행됩니다	위의 예시를 스크립트 두 개로 분리하면 브라우저가 두 스크립트를 정상적으로 실행합니다
135	SPELL	🔴 필수	type 과	type과
136	KIGO-맞춤법	🔴 필수	type 과 language	type과 language
140	KIGO-수동형	🔴 필수	브라우저에서만 사용하는 코드에 주의를 뺏기지 않도록 하겠습니다	브라우저에서만 사용하는 코드에 신경 쓰지 않습니다
140	KIGO-시제	🔴 필수	수단으로만 사용하도록 하겠습니다	수단으로만 사용합니다
140	WIKI-3	🔴 필수	때문에,	때문에
140	WIKI-6	🟡 권고	브라우저에서만 사용하는 코드에 주의를 뺏기지 않도록 하겠습니다	브라우저에서만 사용하는 코드에 지나치게 신경 쓰지 않겠습니다

통과·생략 항목

• WIKI: WIKI-1, 2, 8, 9, 10, 11, 13, 16, 17 통과
• KIGO: 콜론, 괄호, 조사, 약어, 외래어, 경어, 조사 남용, 복수형, 제품명, 저작권 통과
• CUSTOM: 옮긴이 표기 통과
• SPELL: 띄어쓰기 1건 발견

총평

필수 39건, 권고 4건입니다. 규칙 위반과 별도로 병합 충돌 블록 2개와 미번역 영문 2개가 있어 먼저 충돌을 해결해야 합니다. 이후 필수 항목을 적용하고 재검증하는 순서가 안전합니다.

[BHyeonKim]

이 마크다운 파일만 영어로 작성된 이유가 있을까요?

llm에게 영어로 입력을 넣었을 시 출력결과가 더 낫긴하지만, 해당 프로젝트에서 언어 통일을 하는 것도 좋을 것 같습니다.

영어 혹은 한글로 통일하는 것을 어떻게 생각하시나요?

[gusdn3477]

@BHyeonKim 네 사실 마켓플레이스에 올라간다 해서 영어로 작성하는 게 더 좋지 않을까 생각했었는데, 해당 프로젝트는 어차피 한국어 번역 스킬이라 사용자 대다수가 한국인일 것 같네요. 그런 의미에서 저희가 읽기 더 쉬운 한국어로 통일하겠습니다. 수정 후에 디스코드로 멘션 드리겠습니다. 의견 감사합니다.

[gusdn3477]

@BHyeonKim md 파일 한글로 번역했습니다!

[BHyeonKim]

이름이 유니코드로 되어있는데 의도하신걸까요?

[gusdn3477]

@BHyeonKim 아뇨. 지적해 주셔서 감사합니다. 보현님이 이미 쓰신 방식대로 영어로 수정했습니다.

[BHyeonKim]

버전뒤에 codex문자열이 붙는게 맞는건지 궁금합니다!
공식문서의 예시에는 찾아볼 수 없어서 여쭤봅니다.

[gusdn3477]

@BHyeonKim 이 부분도 수정했습니다. 버전을 코덱스 관련 플러그인이라 1.0.0 으로 했습니다.