Files
document-haness/korean-technical-blog-skills-bundle-v1/reducing-ai-like-korean-writing/references/pattern-catalog.md
T
DongHyeonkaandClaude Opus 5 1099834617 chore: snapshot working tree before harness removal
미추적 파일과 미커밋 수정을 전부 담아 pre-harness-removal 태그의 복구
범위를 확보한다. .agents/skills/writing-natural-korean 9개와
korean-technical-blog-skills-bundle-v1 61개가 여기 포함된다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 14:19:24 +09:00

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 — 이미 말한 내용을 다시 풀어 쓰기

신호

  • 용어를 정의한 직후 같은 정의를 다른 말로 반복함
  • 코드가 명확히 보여 주는 동작을 문장마다 재서술함
  • 독자가 이미 아는 전제를 매 절마다 다시 설명함

수정

독자의 이해에 필요한 설명만 남기고 반복을 삭제한다.

유지

초급 독자용 교육 자료에서 단계별 반복이 학습 목표일 때.

최소 대조 원칙

각 수정에는 다음 질문을 적용한다.

이 표현을 없애면 정보가 줄어드는가?
주체와 동작이 더 분명해지는가?
장르상 원래 필요한 구조인가?
원문에 없는 근거를 만들어야만 고칠 수 있는가?

마지막 질문이 이면 자동 재작성하지 않는다.