.agents/skills의 technical-document-author, revising-korean-technical-prose, writing-natural-korean을 korean-technical-blog-skills-bundle-v1의 세 스킬로 교체한다. - writing-korean-technical-blogs: 문제·제약·선택·구현·결과·한계 구조화 - reducing-ai-like-korean-writing: 상투성·추상화·반복 제거 - editing-korean-grammar-and-expression: 맞춤법·띄어쓰기·호응 검수 상류를 수정하지 않고 복사했다. diff -r 0건, MANIFEST.sha256 검증 통과, 번들 validate_skill.py 3/3 PASS. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
7.7 KiB
AI 유사 한국어 문체 패턴 카탈로그
사용 원칙
이 카탈로그는 작성 주체를 판정하는 목록이 아니다. 패턴은 문맥에서 정보 전달을 방해하거나 반복될 때만 수정 근거가 된다. 같은 표현도 장르와 문맥에 따라 정상일 수 있다.
패턴 목록
AIK-META-001 — 내용 없는 메타 문장
신호
본 글에서는 ... 살펴보고자 합니다.다음과 같은 내용을 확인할 수 있습니다.이에 대해 알아보겠습니다.
수정
목적을 직접 말하거나, 다음 문장이 이미 목적을 수행하면 삭제한다.
본 문서에서는 배포 절차에 대해 살펴보겠습니다.
→ 이 문서는 배포 절차를 설명합니다.
유지
긴 보고서에서 독자에게 범위와 탐색 경로를 실제로 안내할 때.
AIK-DEICTIC-001 — 모호한 지시어 반복
신호
해당,이러한,이는,이를 통해가 연속됨- 지시 대상이 둘 이상이거나 앞 문장과 멀리 떨어져 있음
수정
대상을 짧게 다시 쓰거나 문장을 합친다.
해당 설정을 변경합니다.
→ 캐시 만료 시간을 변경합니다. # 대상이 원문에 명시된 경우에만
유지
법률·규정 문서에서 이미 정의된 대상을 정확히 가리키거나, 반복을 줄이기 위해 대명사가 필요한 경우.
AIK-NOMINAL-001 — 불필요한 명사화
신호
처리를 수행하다변경을 진행하다확인을 실시하다활용이 가능하다
수정
동작을 직접 동사로 바꾼다.
설정에 대한 변경을 수행합니다.
→ 설정을 변경합니다.
유지
장애 처리, 접근 제어, 부하 분산처럼 도메인에서 고정된 개념일 때.
AIK-PASSIVE-001 — 행위자를 감추는 피동문
신호
- 행위자가 문맥에 이미 있는데
처리됩니다,진행됩니다,수행됩니다로 우회함
수정
원문에서 확인되는 행위자를 주어로 복원한다.
요청에 대한 검증이 서버에서 수행됩니다.
→ 서버가 요청을 검증합니다.
유지
처리 결과가 중심이거나, 행위자가 중요하지 않거나, 보안상 행위자를 특정하지 않는 문서일 때.
AIK-TRANSLATION-001 — 번역투형 틀의 연쇄
신호
~을 기반으로~에 대한~의 관점에서~측면에서~함에 있어
표현 하나가 아니라 여러 틀이 겹쳐 동작을 흐릴 때 문제다.
이 구조를 기반으로 요청에 대한 처리가 수행됩니다.
→ 이 구조가 요청을 처리합니다.
AIK-GENERIC-001 — 근거 없는 일반 효용
신호
효율성을 향상할 수 있습니다.유연한 대응이 가능합니다.확장성 측면에서 유리합니다.사용자 경험을 개선합니다.
수정
원문에 메커니즘이나 측정 결과가 있으면 그 내용을 직접 쓴다. 없으면 구체화하지 말고 suggest/review로 남긴다.
이를 통해 효율성을 높일 수 있습니다.
→ 근거가 없으면 자동 재작성하지 않는다.
금지
그럴듯한 지표·원인·결과를 새로 만들어 구체화하지 않는다.
AIK-HEDGE-001 — 불필요하게 긴 가능 표현
신호
~하는 것이 가능합니다.~할 수 있게 됩니다.~이 가능하다고 볼 수 있습니다.
수정
가능성의 강도는 그대로 두고 표현만 줄인다.
로그를 확인하는 것이 가능합니다.
→ 로그를 확인할 수 있습니다.
금지
확인할 수 있습니다를 확인합니다로 바꿔 가능성을 확정으로 강화하지 않는다.
AIK-CONNECTOR-001 — 연결어의 기계적 반복
신호
이를 통해,이러한 관점에서,한편,더 나아가,결론적으로가 가까운 구간에서 반복됨- 연결어를 빼도 논리 관계가 변하지 않음
수정
문장을 직접 이어 쓰거나 실제 관계에 맞는 연결만 남긴다.
유지
인과·대조·전환을 오해 없이 표시하는 데 필요할 때.
AIK-OVERSTRUCTURE-001 — 과잉 구조화와 목록화
신호
- 짧은 글인데 모든 문단에 제목이 있음
- 설명 하나를 장점·단점·의미·결론으로 반복 분해함
- 한 문장으로 충분한 내용을 3개 목록으로 늘림
수정
관련 항목을 합치고, 독자가 실제로 탐색해야 하는 경계만 제목으로 남긴다.
유지
README, 런북, 체크리스트, API 참조처럼 탐색성과 실행 순서가 핵심인 문서.
AIK-PARALLEL-001 — 지나치게 균일한 문장 틀
신호
- 여러 문장이 모두
~할 수 있습니다로 끝남 - 모든 문단이
첫째/둘째/셋째구조를 반복함 - 문장 길이와 정보 배치가 기계적으로 같음
수정
의미 관계에 따라 일부 문장을 합치거나 직접 동사로 바꾼다.
금지
사람처럼 보이게 하려고 문장 길이와 어미를 무작위로 바꾸지 않는다.
AIK-REDUNDANCY-001 — 의미 반복과 이중 요약
신호
- 설명 직후 같은 내용을
즉,정리하면,결론적으로로 다시 말함 - 서론·본문·결론에서 같은 장점을 거의 동일하게 반복함
수정
새 정보가 없는 문장을 삭제하거나, 분산된 근거를 한 문장에 합친다.
유지
독자층이 바뀌는 요약, 장문의 절별 요약, 발표에서 기억을 돕는 핵심 반복.
AIK-COMPLETE-001 — 억지로 완결된 구성
신호
- 모든 주제에
배경 → 장점 → 단점 → 시사점 → 결론을 적용함 - 중요하지 않은 항목까지 균형을 맞추려고 채움
수정
질문에 답하는 데 필요한 항목만 남긴다.
유지
비교 보고서나 의사결정 문서처럼 정해진 평가 축이 필요한 경우.
AIK-EMPTY-EVAL-001 — 근거 없는 평가와 강조
신호
매우 중요합니다.핵심적인 역할을 합니다.효과적인 방법입니다.의미 있는 결과를 제공합니다.
평가 근거가 같은 문장이나 주변 문단에 없을 때 문제다.
수정
근거가 있으면 평가 대신 결과를 쓴다. 근거가 없으면 자동으로 더 구체적인 평가를 만들지 않는다.
AIK-AUTHORLESS-001 — 판단 주체와 근거가 없는 결정문
신호
이 방식을 선택하는 것이 바람직합니다.일반적으로 이 구조가 더 적합합니다.
누가 어떤 조건에서 판단했는지 없음.
수정
원문에 조건과 근거가 있으면 바로 연결한다.
쓰기 트래픽이 적으므로 단일 리더 구조를 선택합니다.
금지
작성자의 경험이나 조직 상황을 새로 만들어 판단 근거로 넣지 않는다.
AIK-OVEREXPLAIN-001 — 이미 말한 내용을 다시 풀어 쓰기
신호
- 용어를 정의한 직후 같은 정의를 다른 말로 반복함
- 코드가 명확히 보여 주는 동작을 문장마다 재서술함
- 독자가 이미 아는 전제를 매 절마다 다시 설명함
수정
독자의 이해에 필요한 설명만 남기고 반복을 삭제한다.
유지
초급 독자용 교육 자료에서 단계별 반복이 학습 목표일 때.
최소 대조 원칙
각 수정에는 다음 질문을 적용한다.
이 표현을 없애면 정보가 줄어드는가?
주체와 동작이 더 분명해지는가?
장르상 원래 필요한 구조인가?
원문에 없는 근거를 만들어야만 고칠 수 있는가?
마지막 질문이 예이면 자동 재작성하지 않는다.