feat: install korean technical blog skill bundle

.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>
2026-08-07 14:20:42 +09:00
parent 1099834617
commit 25644cc4d9
81 changed files with 5261 additions and 1484 deletions
@@ -0,0 +1,319 @@
+# AI 유사 한국어 문체 패턴 카탈로그
+
+## 사용 원칙
+
+이 카탈로그는 작성 주체를 판정하는 목록이 아니다. 패턴은 **문맥에서 정보 전달을 방해하거나 반복될 때**만 수정 근거가 된다. 같은 표현도 장르와 문맥에 따라 정상일 수 있다.
+
+## 패턴 목록
+
+### AIK-META-001 — 내용 없는 메타 문장
+
+**신호**
+
+- `본 글에서는 ... 살펴보고자 합니다.`
+- `다음과 같은 내용을 확인할 수 있습니다.`
+- `이에 대해 알아보겠습니다.`
+
+**수정**
+
+목적을 직접 말하거나, 다음 문장이 이미 목적을 수행하면 삭제한다.
+
+```text
+본 문서에서는 배포 절차에 대해 살펴보겠습니다.
+→ 이 문서는 배포 절차를 설명합니다.
+```
+
+**유지**
+
+긴 보고서에서 독자에게 범위와 탐색 경로를 실제로 안내할 때.
+
+---
+
+### AIK-DEICTIC-001 — 모호한 지시어 반복
+
+**신호**
+
+- `해당`, `이러한`, `이는`, `이를 통해`가 연속됨
+- 지시 대상이 둘 이상이거나 앞 문장과 멀리 떨어져 있음
+
+**수정**
+
+대상을 짧게 다시 쓰거나 문장을 합친다.
+
+```text
+해당 설정을 변경합니다.
+→ 캐시 만료 시간을 변경합니다.  # 대상이 원문에 명시된 경우에만
+```
+
+**유지**
+
+법률·규정 문서에서 이미 정의된 대상을 정확히 가리키거나, 반복을 줄이기 위해 대명사가 필요한 경우.
+
+---
+
+### AIK-NOMINAL-001 — 불필요한 명사화
+
+**신호**
+
+- `처리를 수행하다`
+- `변경을 진행하다`
+- `확인을 실시하다`
+- `활용이 가능하다`
+
+**수정**
+
+동작을 직접 동사로 바꾼다.
+
+```text
+설정에 대한 변경을 수행합니다.
+→ 설정을 변경합니다.
+```
+
+**유지**
+
+`장애 처리`, `접근 제어`, `부하 분산`처럼 도메인에서 고정된 개념일 때.
+
+---
+
+### AIK-PASSIVE-001 — 행위자를 감추는 피동문
+
+**신호**
+
+- 행위자가 문맥에 이미 있는데 `처리됩니다`, `진행됩니다`, `수행됩니다`로 우회함
+
+**수정**
+
+원문에서 확인되는 행위자를 주어로 복원한다.
+
+```text
+요청에 대한 검증이 서버에서 수행됩니다.
+→ 서버가 요청을 검증합니다.
+```
+
+**유지**
+
+처리 결과가 중심이거나, 행위자가 중요하지 않거나, 보안상 행위자를 특정하지 않는 문서일 때.
+
+---
+
+### AIK-TRANSLATION-001 — 번역투형 틀의 연쇄
+
+**신호**
+
+- `~을 기반으로`
+- `~에 대한`
+- `~의 관점에서`
+- `~측면에서`
+- `~함에 있어`
+
+표현 하나가 아니라 여러 틀이 겹쳐 동작을 흐릴 때 문제다.
+
+```text
+이 구조를 기반으로 요청에 대한 처리가 수행됩니다.
+→ 이 구조가 요청을 처리합니다.
+```
+
+---
+
+### AIK-GENERIC-001 — 근거 없는 일반 효용
+
+**신호**
+
+- `효율성을 향상할 수 있습니다.`
+- `유연한 대응이 가능합니다.`
+- `확장성 측면에서 유리합니다.`
+- `사용자 경험을 개선합니다.`
+
+**수정**
+
+원문에 메커니즘이나 측정 결과가 있으면 그 내용을 직접 쓴다. 없으면 구체화하지 말고 `suggest/review`로 남긴다.
+
+```text
+이를 통해 효율성을 높일 수 있습니다.
+→ 근거가 없으면 자동 재작성하지 않는다.
+```
+
+**금지**
+
+그럴듯한 지표·원인·결과를 새로 만들어 구체화하지 않는다.
+
+---
+
+### AIK-HEDGE-001 — 불필요하게 긴 가능 표현
+
+**신호**
+
+- `~하는 것이 가능합니다.`
+- `~할 수 있게 됩니다.`
+- `~이 가능하다고 볼 수 있습니다.`
+
+**수정**
+
+가능성의 강도는 그대로 두고 표현만 줄인다.
+
+```text
+로그를 확인하는 것이 가능합니다.
+→ 로그를 확인할 수 있습니다.
+```
+
+**금지**
+
+`확인할 수 있습니다`를 `확인합니다`로 바꿔 가능성을 확정으로 강화하지 않는다.
+
+---
+
+### 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 — 판단 주체와 근거가 없는 결정문
+
+**신호**
+
+- `이 방식을 선택하는 것이 바람직합니다.`
+- `일반적으로 이 구조가 더 적합합니다.`
+
+누가 어떤 조건에서 판단했는지 없음.
+
+**수정**
+
+원문에 조건과 근거가 있으면 바로 연결한다.
+
+```text
+쓰기 트래픽이 적으므로 단일 리더 구조를 선택합니다.
+```
+
+**금지**
+
+작성자의 경험이나 조직 상황을 새로 만들어 판단 근거로 넣지 않는다.
+
+---
+
+### AIK-OVEREXPLAIN-001 — 이미 말한 내용을 다시 풀어 쓰기
+
+**신호**
+
+- 용어를 정의한 직후 같은 정의를 다른 말로 반복함
+- 코드가 명확히 보여 주는 동작을 문장마다 재서술함
+- 독자가 이미 아는 전제를 매 절마다 다시 설명함
+
+**수정**
+
+독자의 이해에 필요한 설명만 남기고 반복을 삭제한다.
+
+**유지**
+
+초급 독자용 교육 자료에서 단계별 반복이 학습 목표일 때.
+
+## 최소 대조 원칙
+
+각 수정에는 다음 질문을 적용한다.
+
+```text
+이 표현을 없애면 정보가 줄어드는가?
+주체와 동작이 더 분명해지는가?
+장르상 원래 필요한 구조인가?
+원문에 없는 근거를 만들어야만 고칠 수 있는가?
+```
+
+마지막 질문이 `예`이면 자동 재작성하지 않는다.