Claude의 일본어 교정 스킬 yomiyasu를 포함한 3가지 유형 선택 방법

이 글의 요점

• yomiyasu는 Claude로 일본어 문장을 읽기 쉽게 다듬기(推敲)하기 위해 화제가 된 새로운 스킬입니다. 자세한 내용은 참고 기사(https://qiita.com/inoyu-qiita/items/0ffe6e74ecaf3aaa8b14)에서 소개되었습니다.
• Claude의 일본어 교정 스킬은 '규칙 나열형', '교정 도구 연계형', '인격/문체 지정형'의 3가지 유형으로 나누면 용도에 맞는 선택이 쉬워집니다.
• 스킬의 좋고 나쁨은 평판만으로는 결정할 수 없으므로, 같은 원고를 동일한 조건으로 통과시켜 차이를 비교하는 절차가 확실합니다.

Claude의 일본어 교정 스킬로서 yomiyasu가 화제입니다. 계기는 Qiita의 비교 기사(https://qiita.com/inoyu-qiita/items/0ffe6e74ecaf3aaa8b14)였습니다.

먼저 말씀드립니다. 본고 작성 시점에는 참고 기사의 본문을 가져올 수 없었습니다. yomiyasu의 내용이나 비교된 3가지 스킬의 구체적인 결과는 여기에서 쓰지 않습니다. 수치나 순위도 제시하지 않습니다.

대신 다음 3가지를 정리합니다.

• 스킬이란 무엇인가
• 일본어 교정 스킬을 어떻게 분류하고 선택할 것인가
• 자신의 원고로 비교하는 절차

구체적인 비교 결과는 꼭 원문 기사에서 확인해 주십시오.

스킬(Skills)은 Claude에게 특정 작업 절차를 학습시키는 메커니즘입니다. 기본적으로 SKILL.md라는 파일에 설명과 절차를 작성합니다. 공식 문서는 여기입니다.

• Claude Code의 스킬: https://docs.claude.com/en/docs/claude-code/skills

설명문(description)을 단서 삼아, Claude가 필요한 상황에서 불러오도록 설계된 것 같습니다. 즉 교정 스킬이란 '교정할 때의 관점과 절차'를 매번 붙일 필요가 없게 해주는 도구입니다.

개별 스킬 이름을 나열하기 전에 유형으로 정리합니다. 이름이 바뀌어도 유형은 사용할 수 있기 때문입니다.

평판보다 손안의 원고에서의 차이가 확실합니다. 다음 절차를 추천합니다.

이런 종류를 하나씩 선택합니다.

• 기술 블로그(코드나 전문 용어가 많음)
• 사내 문서(경체와 상체가 섞임)
• 긴 설명문(한 문장이 길어지기 쉬움)

같은 모델, 같은 원고, 같은 지시로 실행합니다. '교정해 달라'라고만 쓰고 스킬의 차이를 봅니다.

출력을 통째로 읽으면 피곤합니다. 차이점 표시(diff)로 확인합시다.

diff -u original.md skill_a.md
diff -u original.md skill_b.md

다음 관점을 미리 정해두면 헤매지 않습니다.

• 의미가 바뀌었는지
• 사실이나 고유명사를 멋대로 바꾸지는 않았는지
• 읽기 쉬움이 올라갔는지
• 자신의 문체가 남아있는지
• 수정 이유가 설명되었는지

가장 중요한 것은 첫 번째입니다. 의미가 변하는 교정은, 읽기 쉬워도 실패입니다.

교정 스킬은 만능이 아닙니다.

의미 변경 리스크가 있습니다. LLM은 문장을 부드럽게 하기 위해 내용을 더하거나 빼는 경우가 있습니다. 수치, 버전, 고유명사는 사람이 반드시 확인해야 합니다.

문체가 균일해집니다. 형식대로 고치면 작성자의 개성이 옅어집니다. 개인 블로그에서 개성을 남기고 싶은 사람에게는 규칙형을 강하게 적용하는 운영은 맞지 않을 수 있습니다.

코드 혼재 문장은 무너지기 쉽습니다. 코드 블록이나 커맨드를 설명문으로 고쳐버리는 사고가 있습니다. '코드는 변경하지 않는다'고 명시해야 합니다.

적합하지 않은 사람도 있습니다. 원고가 몇 줄로 끝나는 사람은 스킬을 넣는 것보다 그때그때 지시하는 것이 가볍습니다. 반대로, 팀에서 문서 기준을 통일하고 싶은 사람에게는 스킬의 공유가 효과적입니다.

저는 이번에 yomiyasu를 직접 구동하여 검증하지 않았습니다. 따라서 정확도나 사용감에 대한 소감은 쓸 수 없습니다. 여기까지는 공식 문서 내용과 일반적인 운영상의 주의에 근거한 정리입니다.

어떤 스킬을 넣든, 다음을 확인해 주십시오.

• 공개 리포지토리의 라이선스는 무엇인지
• SKILL.md

무엇이 쓰여 있는지(자신의 원고에 불필요한 지시는 없는지) - 외부 명령을 실행하는 기술적 설명이 없는지

• 업데이트가 지속되고 있는지

스킬은 Claude에게 절차를 전달하는 파일입니다. 다른 사람이 만든 것은 내용을 읽어본 후에 사용하는 것이 안전합니다.

먼저 원 기사를 읽고, 3가지 스킬이 어떤 유형에 속하는지 자신의 말로 분류해 보세요. 그 후, 가지고 있는 원고 한 편을 두 가지 스킬에 통과시켜 봅시다.

남은 질문은 하나입니다. 당신의 원고에게 '읽기 쉽다'는 것은 무엇을 의미할까요? 그 답이 스킬 선택의 기준이 됩니다.

Claude에서 일본어 문장을 교정하는 스킬로 화제가 된 것입니다. 자세한 내용은 참고 기사(https://qiita.com/inoyu-qiita/items/0ffe6e74ecaf3aaa8b14)에서 소개하고 있습니다.

특정 작업 절차를 SKILL.md와 같은 파일에 정리하여 Claude가 사용하도록 하는 시스템입니다. 사양은 공식 문서(https://docs.claude.com/en/docs/claude-code/skills)에서 확인할 수 있습니다.

용도에 따라 선택합니다. 오탈자나 표기 변화를 확실하게 잡고 싶다면 교정 도구 연계형, 가독성 전체를 다듬고 싶다면 규칙 나열형이나 문체 지정형이 후보입니다.

있습니다. LLM은 문장을 부드럽게 만드는 과정에서 내용을 추가하거나 삭제하는 경우가 있습니다. 수치나 고유명사는 사람이 차이점을 확인해야 합니다.

같은 모델, 같은 원고, 같은 지시로 실행하여 차이점을 봅니다. 의미의 유지, 사실의 유지, 가독성, 문체의 남겨짐과 같은 채점 축을 미리 정해두면 비교하기 쉽습니다.

내용을 읽어본 후에 사용하는 것이 안전합니다. 외부 명령의 실행이나 불필요한 지시가 포함되어 있지 않은지 확인해야 합니다.

적합할 때도 있지만, 문체가 균일해진다는 점에 주의가 필요합니다. 개성을 남기고 싶다면, 수정 범위를 좁히는 지시를 추가하는 것이 좋을 것입니다.