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,110 @@
+# 판정·재작성 정책
+
+## 1. 목적
+
+이 스킬은 AI 작성 여부를 판정하지 않는다. 다음 두 질문에만 답한다.
+
+1. 이 표현이 문맥에서 정보 전달을 방해하거나 불필요하게 우회하는가?
+2. 사실과 문체를 보존하면서 더 직접적으로 쓸 수 있는가?
+
+두 질문 모두 `예`일 때만 자동 재작성한다.
+
+## 2. 우선순위
+
+상위 항목은 하위 항목을 항상 제약한다.
+
+1. 사용자 잠금과 보호 구간
+2. 사실·의미·수치·주체 보존
+3. 부정·조건·시제·양태 보존
+4. 기술 용어와 고유 명칭 일관성
+5. 문서 장르와 독자
+6. 작성자의 기존 관점과 말투
+7. 직접성·구체성·정보 밀도
+8. 문장 리듬과 취향
+
+스타일 개선이 상위 항목과 충돌하면 해당 수정을 취소한다.
+
+## 3. 탐지 임계값
+
+표현 하나가 보인다는 이유만으로 문제로 판정하지 않는다. 다음 중 하나 이상이 명확해야 한다.
+
+- 문장을 삭제해도 명제가 줄지 않는다.
+- 추상 명사화 때문에 주체와 동작이 가려진다.
+- 일반적인 효용을 주장하지만 원인·조건·결과가 없다.
+- 같은 연결어나 문장 틀이 가까운 구간에서 반복된다.
+- 한 문단이 바로 앞 문단의 내용을 표현만 바꿔 반복한다.
+- 장르상 필요하지 않은 목록·요약·결론이 연쇄적으로 붙는다.
+
+단순히 자주 쓰이는 단어라는 이유는 충분한 근거가 아니다.
+
+## 4. 수정 강도
+
+### `light`
+
+- A 등급의 국소 수정만 수행한다.
+- 문장 순서와 문단 구조를 유지한다.
+- 개인 문체 보존이 가장 중요한 경우에 사용한다.
+
+### `standard`
+
+- A 등급과 명확한 B 등급을 수정한다.
+- 반복 문장 통합과 불필요한 메타 문장 삭제를 허용한다.
+- 기본값이다.
+
+### `strong`
+
+- 문단 순서, 제목, 목록 형태까지 조정할 수 있다.
+- 새로운 정보나 경험은 여전히 추가할 수 없다.
+- 사용자가 대대적인 재작성을 명시했을 때만 사용한다.
+
+## 5. 보존 불변식
+
+- 핵심 주장과 사실
+- 긍정·부정
+- 조건·예외·범위
+- 시제와 시간 관계
+- 가능성·의무·권고·추정의 강도
+- 주체·객체·지시 대상
+- 수치·날짜·단위·버전
+- 제품명·기관명·기술 용어
+- 코드·URL·경로·명령어·식별자
+- 직접 인용
+- 제목·표·목록·링크 등 필요한 마크다운 구조
+- 원문에 실제로 존재하는 경험과 판단
+
+## 6. 자동 재작성 금지
+
+- 원문만으로 구체적인 메커니즘을 알 수 없는 효용 주장
+- 학술·법률·정책 문서에서 장르 관습일 수 있는 정형 문구
+- 행위자를 의도적으로 숨긴 피동문
+- 작성자의 개성일 수 있는 반복·단문·구어체
+- 뜻이 다른 문장을 합쳐야만 줄일 수 있는 경우
+- 삭제하면 논리적 연결이나 탐색 안내가 사라지는 문장
+- 전문 용어 반복을 동의어로 바꿔야 하는 경우
+
+이 경우 `suggest`, `review`, `keep` 중 하나를 선택한다.
+
+## 7. 금지된 인간화 전략
+
+다음은 자연스러운 글쓰기가 아니라 출처 위조 또는 품질 저하다.
+
+- 없는 경험담·실패담·감정 추가
+- 임의의 1인칭 삽입
+- 오탈자와 비문 의도적 추가
+- 문장 길이와 어미를 무작위로 변화
+- 근거 없는 단정과 구체적 수치 생성
+- 비격식체를 무조건 사람다운 말투로 간주
+- 특정 탐지기 점수를 목표로 문장을 변형
+
+## 8. 최종 검증
+
+출력 전 다음을 비교한다.
+
+- 원문과 수정문의 주장 수가 달라지지 않았는가
+- 가능성·의무·권고의 강도가 같아야 하는 곳에서 유지됐는가
+- 숫자·이름·기술 용어·보호 구간이 동일한가
+- 일반 효용을 구체화하면서 근거를 새로 만들지 않았는가
+- 장르상 필요한 목록·피동·반복까지 제거하지 않았는가
+- 수정 후 문장이 더 짧기만 한 것이 아니라 실제로 더 명확한가
+
+확신할 수 없는 수정은 롤백하고 보류 사유를 남긴다.
@@ -0,0 +1,46 @@
+# 장르별 경계
+
+이 스킬은 장르별 글쓰기 스킬을 대체하지 않는다. 같은 패턴이라도 장르에 따라 유지 여부가 달라진다.
+
+## 기술 블로그
+
+- 문제, 선택, 실제 관찰, 결과가 드러나면 좋다.
+- 원문에 존재하는 1인칭과 판단은 보존할 수 있다.
+- 경험이나 장애 사례를 새로 만들면 안 된다.
+- 서론과 결론에서 같은 효용을 반복하지 않는다.
+
+## 설계 문서와 ADR
+
+- 제목, 표, 목록, 비교 축은 탐색과 의사결정에 필요하므로 함부로 줄이지 않는다.
+- `선택`, `근거`, `제약`, `기각한 대안`을 직접 연결한다.
+- 중립적 피동문과 반복된 기술 용어는 일관성을 위해 필요할 수 있다.
+
+## README와 런북
+
+- 짧은 명령문, 목록, 번호 매기기, 반복된 절차 형식은 정상이다.
+- 문체 변화보다 실행 가능성과 순서 보존이 우선이다.
+- 명령어·경로·환경 변수·코드 블록은 보호한다.
+
+## 발표 대본
+
+- 말하기 위한 반복과 표지어는 글보다 더 허용한다.
+- 문장을 짧게 나눌 수 있지만, 임의의 추임새나 감탄사를 넣지 않는다.
+- 화면에 보이는 문장과 발표자가 말할 문장을 구분한다.
+
+## 보고서·학술 문서
+
+- `본 연구에서는`, `다음과 같이` 같은 정형 표현이 장르 관습일 수 있다.
+- 객관적 문체를 저자성이 없다는 이유로 바꾸지 않는다.
+- 요약·방법·결과·논의의 구조를 AI식 틀로 오인하지 않는다.
+
+## 정책·법률 문서
+
+- 반복, 정의, 피동문, 지시어가 법적 정확성을 위해 필요할 수 있다.
+- 자연스러움보다 용어 일관성·범위·조건 보존을 우선한다.
+- 정의된 용어를 동의어로 바꾸지 않는다.
+
+## 대화·SNS·개인 글
+
+- 단문, 반복, 생략, 말줄임표, 구어체는 개성일 수 있다.
+- 표준어·격식체로 바꾸지 않는다.
+- 사용자가 원하지 않으면 거친 말투나 감정 강도를 약화하지 않는다.
@@ -0,0 +1,95 @@
+# 출력 모드
+
+## 공통 원칙
+
+- 수정문을 먼저 제시한다.
+- AI 작성 여부나 확률은 출력하지 않는다.
+- 설명은 실제 수정과 일치해야 한다.
+- 근거가 부족한 항목은 `보류`로 표시한다.
+- 사용자가 요청하지 않으면 모든 패턴을 장황하게 열거하지 않는다.
+
+## `silent`
+
+재작성된 본문만 반환한다.
+
+```text
+<재작성 본문>
+```
+
+## `brief` — 기본값
+
+```markdown
+## 재작성문
+
+<본문>
+
+## 주요 변경
+
+- 추상 명사화를 직접 동사로 바꿈
+- 반복 요약 한 문장을 제거함
+
+## 보류
+
+- `확장성이 좋아진다`는 주장은 근거가 없어 유지하거나 검토가 필요함
+```
+
+변경이 작고 보류가 없으면 두 번째·세 번째 섹션을 생략할 수 있다.
+
+## `audit`
+
+원문은 바꾸지 않고 문제 후보만 분류한다.
+
+```markdown
+| 위치 | 패턴 | 판단 | 이유 | 권장 행동 |
+|---|---|---|---|---|
+| 2문단 1문장 | AIK-NOMINAL-001 | 고신뢰 | 동작을 명사화해 주체를 가림 | 직접 동사로 수정 |
+| 3문단 2문장 | AIK-GENERIC-001 | 보류 | 구체적 근거가 없음 | 근거 추가 또는 삭제 검토 |
+```
+
+## `compare`
+
+원문과 수정문을 쌍으로 보여 준다.
+
+```markdown
+### 1
+
+**원문**
+> 설정에 대한 변경을 수행합니다.
+
+**수정**
+> 설정을 변경합니다.
+
+**이유**
+`AIK-NOMINAL-001`: 불필요한 명사화를 직접 동사로 바꿈.
+```
+
+## 구조화된 출력
+
+자동 평가나 다른 하네스가 결과를 소비할 때 다음 형식을 사용할 수 있다.
+
+```json
+{
+  "revised_text": "...",
+  "findings": [
+    {
+      "span": "...",
+      "pattern_id": "AIK-NOMINAL-001",
+      "action": "rewrite",
+      "confidence": "high",
+      "reason": "..."
+    }
+  ],
+  "warnings": ["..."],
+  "preserved": ["numbers", "technical_terms", "code", "register"]
+}
+```
+
+## 수정 강도와 출력 모드의 관계
+
+| 요청 | 권장 조합 |
+|---|---|
+| AI 같은 표현만 확인 | `audit + light` |
+| 게시 전 일반 윤문 | `brief + standard` |
+| 원문과 변경 근거 검토 | `compare + standard` |
+| 문단 구조까지 다시 정리 | `brief + strong` |
+| 결과만 필요 | `silent + 사용자 지정 강도` |
@@ -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
+이 표현을 없애면 정보가 줄어드는가?
+주체와 동작이 더 분명해지는가?
+장르상 원래 필요한 구조인가?
+원문에 없는 근거를 만들어야만 고칠 수 있는가?
+```
+
+마지막 질문이 `예`이면 자동 재작성하지 않는다.
@@ -0,0 +1,39 @@
+# 자료 기반과 범위
+
+## 직접 기반으로 사용한 내용
+
+업로드된 「한국어 문법·표현 교정 에이전트 스킬 설계 보고서」에서 다음 원칙을 사용했다.
+
+- 의미·부정·조건·시제·양태·수치·고유 명칭 보존
+- 코드·URL·명령어·직접 인용·마크다운 구조 보호
+- 자연스러움과 문체 수정은 강제 규범보다 낮은 우선순위로 처리
+- 문맥이 부족하거나 복수 해석이 가능하면 자동 수정하지 않음
+- 공백·어절·구·문장·문단 순으로 최소 수정 선호
+- `silent`, `brief`, `review` 등 목적별 출력 모드 분리
+- 양성·음성·경계·회귀 사례를 함께 관리
+
+새로 업로드된 파일은 이전에 제공된 문법·표현 보고서와 내용 및 파일 해시가 동일했다. 따라서 해당 자료는 **AI 유사 문체 패턴 자체의 조사 근거**가 아니라, 안전한 재작성 정책과 검증 구조의 근거로만 사용했다.
+
+## 확장 설계한 내용
+
+다음 항목은 사용자가 앞선 대화에서 지정한 문제와 대표 문장을 바탕으로 별도 설계했다.
+
+- 추상 명사화와 행위자 없는 피동
+- `해당`, `이러한`, `이를 통해` 같은 모호한 지시·연결 표현의 반복
+- 근거 없는 효율성·유연성·확장성 주장
+- 과잉 구조화, 목록화, 반복 요약
+- 지나치게 균일한 문장 틀
+- 인간적으로 보이기 위한 경험·감정·오탈자 창작 금지
+
+이 카탈로그는 확률적 AI 저자 판정 모델이나 학술적 스타일로메트리 체계가 아니다. 글의 직접성·구체성·정보 밀도를 검토하는 편집 규칙이다.
+
+## 지원하지 않는 주장
+
+이 자료만으로는 다음을 주장할 수 없다.
+
+- 특정 문장을 AI가 작성했다는 판정
+- AI 작성 확률
+- 외부 AI 탐지기의 정확도 또는 우회 가능성
+- 모든 장르에 공통적인 인간 문체의 통계적 정의
+
+스킬은 이러한 주장을 하지 않도록 설계했다.