AI 생성 일본어의 부자연스러움을 교정하는 스킬 'yomiyasu'

『yomiyasu（よみやす）』는 AI가 생성한 일본어 텍스트에서 발생하는 부자연스러운 문체적 오류를 개선하고, 사람이 읽기 쉽고 정보 밀도가 높은 전문적인 일본어로 다듬기 위한 스킬입니다. 이 스킬은 주로 기술 기사, 설계서/사양서, PR 설명문, 사내 보고서 등 실무적인 문서 작성을 대상으로 합니다. AI가 생성한 글은 독특한 습관(クセ)이 남아 있어 그대로 사용하기 어려운 경우가 많았으며, 본 스킬은 이러한 'AI 특유의 가독성 문제'를 해결하는 데 초점을 맞추고 있습니다.

본 스킬은 단순한 금지어 대체 수준을 넘어, 글의 뼈대가 되는 통사 구조(統語構造)를 7가지 변환 원칙으로 체계화하여 자연스러운 일본어로 다듬도록 설계되었습니다. 주요 개선점으로는 동작 주체(動作主)를 명확히 복원하고 모호한 지시 대명사를 구체적인 명사로 대체하는 것, 개념이나 도구가 마치 의지를 가진 것처럼 표현되는 비생물 주어(非生物主語)를 해체하여 객관적 동작으로 재작성하는 것이 포함됩니다.

사용자는 Codex, Claude Code, Cursor와 같은 AI 코딩 환경에 이 스킬을 로드하여 사용할 수 있습니다. 또한, 별도의 Python 스크립트인 `yomiyasu_lint.py`를 통해 문서 내의 'AI스러움' 정도(예: 과도한 강조, 잦은 목록화 등)를 수치적으로 검사할 수 있는 기능을 제공합니다. 이 스크립트는 외부 라이브러리 의존 없이 Python 표준 라이브러리로 동작하며, 기술 문서를 정량적으로 점검하는 데 활용됩니다.

이 스킬을 효과적으로 사용하기 위해서는 주의사항이 있습니다. 만약 여러 개의 문체 조정 또는 교정 에이전트 스킬을 동시에 활성화할 경우, 각 지시 간의 충돌로 인해 의도하지 않은 출력이 발생할 수 있으므로, 본 스킬을 사용할 때는 유사한 기능을 가진 다른 교정 스킬들을 일시적으로 비활성화하는 것이 권장됩니다.