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>
This commit is contained in:
DongHyeonka
co-authored by
Claude Opus 5
Claude Opus 5
parent
1099834617
commit
25644cc4d9
@@ -0,0 +1,111 @@
|
||||
# 판정·보존 정책
|
||||
|
||||
## 1. 기본 정책
|
||||
|
||||
- 기본 언어 변종: 표준어
|
||||
- 기본 문체: 원문 보존
|
||||
- 기본 교정 성향: 보수적
|
||||
- 생성 기본값: 원칙형 우선
|
||||
- 입력이 이미 허용형이면: 유지
|
||||
- 해결되지 않은 중의성: 자동 수정 금지
|
||||
- 선택적 자연스러움 개선: 제안으로 분리
|
||||
|
||||
오류를 하나 놓치는 것보다 올바른 표현을 잘못 고치거나 의미를 바꾸는 위험을 더 크게 본다.
|
||||
|
||||
## 2. 우선순위
|
||||
|
||||
아래 순서에서 상위 항목은 항상 하위 항목을 제약한다.
|
||||
|
||||
1. 사용자 잠금과 보호 구간
|
||||
2. 의미·사실·데이터 보존
|
||||
3. 공식적으로 확정 가능한 강제 규범
|
||||
4. 사전의 품사·뜻·단어 판정
|
||||
5. 통사·의미 문맥
|
||||
6. 높임·문체 일관성
|
||||
7. 자연스러움·간결성
|
||||
8. 취향 기반 재작성
|
||||
|
||||
하위 규칙이 상위 규칙과 충돌하면 하위 수정을 취소하고 원문을 유지하거나 `review`로 보낸다.
|
||||
|
||||
## 3. 반드시 보존할 불변식
|
||||
|
||||
- 명제적 의미
|
||||
- 긍정과 부정
|
||||
- 조건과 예외
|
||||
- 시제와 시간 관계
|
||||
- 가능성·의무·권고·추정 등 양태
|
||||
- 주체·객체·지시 대상
|
||||
- 인명·지명·기관명·제품명
|
||||
- 숫자·날짜·단위·버전
|
||||
- 기술 용어와 사용자가 지정한 표기
|
||||
- 인용문과 발화자의 의도
|
||||
- 목록, 표, 제목, 링크 등 마크다운 구조
|
||||
- 화자의 높임 등급과 의도적인 구어체
|
||||
|
||||
## 4. 보호 구간
|
||||
|
||||
다음 구간은 기본적으로 읽기 전용이다.
|
||||
|
||||
```text
|
||||
fenced_code
|
||||
inline_code
|
||||
url
|
||||
email
|
||||
file_path
|
||||
shell_command
|
||||
identifier
|
||||
quoted_verbatim
|
||||
user_locked_span
|
||||
```
|
||||
|
||||
마크다운 파서나 구문 정보를 우선하며 정규식은 후보 탐지에만 쓴다. 보호 구간 안에서 맞춤법 오류처럼 보이는 문자열도 바꾸지 않는다.
|
||||
|
||||
## 5. 자동 교정 금지 조건
|
||||
|
||||
다음 조건 중 하나라도 충족하면 자동 수정하지 않는다.
|
||||
|
||||
- 품사에 따라 답이 달라지는 표현인데 문맥이 부족함
|
||||
- 뜻에 따라 띄어쓰기가 달라짐
|
||||
- 전문 용어, 제품명, 고유 명칭일 가능성이 있음
|
||||
- 원문이 방언·캐릭터 말투·문학적 파격일 수 있음
|
||||
- 원칙형과 허용형이 모두 맞음
|
||||
- 수정하면 부정·조건·시제·양태·논항이 바뀔 수 있음
|
||||
- 높임 대상이나 발화 관계가 불명확함
|
||||
- 인용 범위가 불명확함
|
||||
|
||||
## 6. 출처 우선순위
|
||||
|
||||
외부 확인이 가능하고 판정이 필요한 경우 다음 순서를 따른다.
|
||||
|
||||
1. 국립국어원 한국어 어문 규범·한글 맞춤법
|
||||
2. 국립국어원 표준어 규정과 표준국어대사전
|
||||
3. 국립국어원의 표준 문법 연구
|
||||
4. 국립국어원의 한국어교육 문법·표현 연구
|
||||
5. 온라인가나다 등 개별 문맥 상담 자료
|
||||
|
||||
개별 상담 답변은 규정 본문이나 사전보다 높은 기준으로 사용하지 않는다. 자료가 충돌해 보이면 먼저 품사·뜻·문맥이 같은지 확인하고, 해결되지 않으면 보류한다.
|
||||
|
||||
## 7. 수정 비용
|
||||
|
||||
같은 규범 적합도를 달성한다면 다음 순서로 선호한다.
|
||||
|
||||
1. 공백만 수정
|
||||
2. 철자 또는 한 어절 수정
|
||||
3. 짧은 구 수정
|
||||
4. 문장 재작성
|
||||
5. 문단 재구성
|
||||
|
||||
문장·문단 재작성은 사용자가 명시적으로 윤문이나 표준화를 요청했을 때만 허용한다.
|
||||
|
||||
## 8. 최종 자체 검증
|
||||
|
||||
출력 전 다음을 비교한다.
|
||||
|
||||
- 숫자와 고유 명칭이 동일한가
|
||||
- 부정·조건·시제·양태가 동일한가
|
||||
- 보호 구간이 바이트 수준에서 동일한가
|
||||
- 문체와 높임 등급이 유지됐는가
|
||||
- 허용형을 오류로 바꾸지 않았는가
|
||||
- 수정 설명이 실제 수정과 일치하는가
|
||||
|
||||
하나라도 확신할 수 없으면 해당 수정만 롤백하고 경고한다.
|
||||
@@ -0,0 +1,101 @@
|
||||
# 출력 모드
|
||||
|
||||
사용자 요청이 명시적이면 그 형식을 우선한다. 그렇지 않으면 `brief`를 사용한다.
|
||||
|
||||
## `silent`
|
||||
|
||||
교정문만 반환한다.
|
||||
|
||||
```text
|
||||
<corrected_text>
|
||||
```
|
||||
|
||||
대량 처리나 사용자가 “결과만”을 요청한 경우에 적합하다. 중대한 중의성이 있으면 짧은 경고를 예외적으로 덧붙인다.
|
||||
|
||||
## `brief` — 기본값
|
||||
|
||||
교정문을 먼저 제시한 뒤, 의미 있는 수정과 경고만 짧게 정리한다.
|
||||
|
||||
```markdown
|
||||
<corrected_text>
|
||||
|
||||
수정 사항
|
||||
- `<original>` → `<replacement>`: <짧은 근거>
|
||||
|
||||
확인이 필요한 부분
|
||||
- <중의성 또는 보존 이유>
|
||||
```
|
||||
|
||||
수정이 없으면 “교정할 확정 오류를 찾지 못했습니다” 정도로 끝내며, 불필요하게 원문을 반복 설명하지 않는다.
|
||||
|
||||
## `teaching`
|
||||
|
||||
한국어 학습이나 규칙 설명이 목적일 때 사용한다.
|
||||
|
||||
```markdown
|
||||
## 교정문
|
||||
<corrected_text>
|
||||
|
||||
## 수정 설명
|
||||
1. 원문 / 수정문
|
||||
2. 오류 유형
|
||||
3. 적용 조건
|
||||
4. 혼동하기 쉬운 반례
|
||||
```
|
||||
|
||||
확정할 수 없는 문법 이론을 하나의 정답처럼 단정하지 않는다.
|
||||
|
||||
## `review`
|
||||
|
||||
복수 해석이나 전문 용어 가능성이 핵심일 때 사용한다. 원문을 먼저 보존한다.
|
||||
|
||||
```markdown
|
||||
## 제안
|
||||
- 원문 유지
|
||||
- 가능한 수정안: ...
|
||||
|
||||
## 판단에 필요한 문맥
|
||||
- ...
|
||||
```
|
||||
|
||||
질문 없이도 안전한 부분은 먼저 교정하고, 막히는 지점만 분리한다.
|
||||
|
||||
## `preserve-style`
|
||||
|
||||
강제 규범만 교정하고 방언·구어체·말줄임·캐릭터 말투·문장 호흡은 보존한다.
|
||||
|
||||
## `standardize`
|
||||
|
||||
사용자가 명시적으로 표준어·격식체 통일을 요청했을 때만 사용한다. 변경 범위가 넓어질 수 있으므로 다음을 함께 밝힌다.
|
||||
|
||||
- 표준화한 말투와 종결형
|
||||
- 보존한 고유 명칭과 기술 용어
|
||||
- 의미 또는 화자 개성이 달라질 수 있어 유지한 부분
|
||||
|
||||
## 구조화 출력
|
||||
|
||||
도구나 후속 자동화가 요구할 때만 다음 계약을 사용한다.
|
||||
|
||||
```json
|
||||
{
|
||||
"corrected_text": "...",
|
||||
"edits": [
|
||||
{
|
||||
"span": [0, 0],
|
||||
"original": "...",
|
||||
"replacement": "...",
|
||||
"rule_id": "...",
|
||||
"severity": "mandatory|suggestion",
|
||||
"confidence": "A|B|C",
|
||||
"explanation": "..."
|
||||
}
|
||||
],
|
||||
"warnings": [
|
||||
{
|
||||
"type": "ambiguity|missing_context|possible_proper_noun|allowed_variant",
|
||||
"message": "..."
|
||||
}
|
||||
],
|
||||
"unchanged_protected_spans": ["..."]
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,116 @@
|
||||
# 핵심 규칙과 최소 대조 사례
|
||||
|
||||
이 문서는 문자열 치환표가 아니다. 각 항목은 **적용 조건과 반례를 함께 확인**할 때만 사용한다.
|
||||
|
||||
## 1. 조사와 의존 명사
|
||||
|
||||
조사는 앞말에 붙이고 의존 명사는 띄어 쓴다. 같은 표면형이 조사·의존 명사·어미로 갈릴 수 있으므로 앞말의 품사와 뜻을 함께 본다.
|
||||
|
||||
| 유지·교정 결과 | 판정 |
|
||||
|---|---|
|
||||
| 이것뿐이다 | 체언 뒤 조사 `뿐`: 붙임 |
|
||||
| 웃을 뿐이다 | 관형사형 뒤 의존 명사 `뿐`: 띄움 |
|
||||
| 학생만큼 잘한다 | 체언 뒤 조사 `만큼`: 붙임 |
|
||||
| 노력한 만큼 얻었다 | 관형사형 뒤 의존 명사 `만큼`: 띄움 |
|
||||
| 약속대로 하세요 | 체언 뒤 조사 `대로`: 붙임 |
|
||||
| 아는 대로 말하세요 | 관형사형 뒤 의존 명사 `대로`: 띄움 |
|
||||
| 떠난 지 오래다 | 시간 경과 의존 명사 `지`: 띄움 |
|
||||
| 갈지 모르겠다 | 불확실성·선택 어미 구성: 붙임 |
|
||||
| 할 수 있다 | 의존 명사 `수`: 띄움 |
|
||||
|
||||
`뿐·만큼·대로·지·만`을 일괄적으로 붙이거나 띄우지 않는다.
|
||||
|
||||
## 2. `되/돼`
|
||||
|
||||
- `돼`는 `되어`의 준말이다.
|
||||
- `되어서 → 돼서`, `되었다 → 됐다`
|
||||
- 자음으로 시작하는 어미 앞에서는 `되`가 유지된다: `되고`, `되면`, `되지`
|
||||
|
||||
| 입력 | 처리 |
|
||||
|---|---|
|
||||
| 준비가 되서 시작했다 | `준비가 돼서 시작했다` |
|
||||
| 일이 되면 연락해 | 유지 |
|
||||
|
||||
`하/해` 치환법은 설명용 기억법일 뿐 최종 판정 규칙으로 사용하지 않는다.
|
||||
|
||||
## 3. `안/않`과 `안되다/안 되다`
|
||||
|
||||
- 용언 앞의 짧은 부정은 부사 `안`: `안 간다`
|
||||
- 긴 부정은 `-지 않다`: `가지 않았다`
|
||||
- `안되다`가 하나의 단어인 뜻과 `되다`의 부정인 `안 되다`를 구분한다.
|
||||
|
||||
| 입력 | 처리 |
|
||||
|---|---|
|
||||
| 학교에 않 간다 | `학교에 안 간다` |
|
||||
| 하지 안았다 | `하지 않았다` |
|
||||
| 농사가 안돼 걱정이다 | 일이 잘 이루어지지 않는 뜻이면 유지 가능 |
|
||||
| 여기서 담배를 피우면 안돼요 | 금지·불허 뜻이면 `안 돼요` |
|
||||
|
||||
뜻이 불명확하면 자동 수정하지 않는다.
|
||||
|
||||
## 4. 종결 어미와 준말
|
||||
|
||||
- `-ㄹ게`, `-ㄹ걸`, `-ㄹ수록`은 예사소리로 적는다.
|
||||
- 의문을 나타내는 `-ㄹ까` 등은 된소리를 유지한다.
|
||||
|
||||
| 입력 | 결과 |
|
||||
|---|---|
|
||||
| 제가 할께요 | 제가 할게요 |
|
||||
| 어떻게 할까 | 유지 |
|
||||
|
||||
`ㄹ` 뒤 된소리를 일괄 치환하지 않는다.
|
||||
|
||||
## 5. 보조 용언과 허용형
|
||||
|
||||
보조 용언은 띄어 쓰는 것이 원칙이지만 일부 구성은 붙여 쓰기도 허용된다.
|
||||
|
||||
| 입력 | 처리 |
|
||||
|---|---|
|
||||
| 비가 올 듯하다 | 원칙형, 유지 |
|
||||
| 비가 올듯하다 | 허용형, 유지 |
|
||||
| 비가 올듯 하다 | `비가 올 듯하다` |
|
||||
| 갈까 보다 | 유지; 앞말에 붙이지 않음 |
|
||||
|
||||
생성할 때는 원칙형을 우선하되, 맞는 허용형은 오류로 표시하지 않는다.
|
||||
|
||||
## 6. `-든/-던`
|
||||
|
||||
- 선택·무관: `-든` — `가든 말든`
|
||||
- 과거의 지속·회상·미완: `-던` — `가던 길`
|
||||
|
||||
뜻을 보지 않고 철자만 바꾸지 않는다.
|
||||
|
||||
## 7. `로서/로써`
|
||||
|
||||
- 자격·지위·신분: `로서`
|
||||
- 수단·도구: `로써`
|
||||
|
||||
사람인지 사물인지가 기준이 아니다.
|
||||
|
||||
| 입력 | 결과 |
|
||||
|---|---|
|
||||
| 학생으로써 책임을 다했다 | 학생으로서 책임을 다했다 |
|
||||
| 대화로써 해결했다 | 수단의 뜻이면 유지 |
|
||||
|
||||
## 8. 높임과 문체
|
||||
|
||||
주체 높임, 객체 높임, 상대 높임을 분리한다. 화자 자신에게 기계적으로 `-시-`를 붙이지 않는다.
|
||||
|
||||
- `제가 말씀하시겠습니다`는 발화 관계가 확인되면 `제가 말씀드리겠습니다`를 제안할 수 있다.
|
||||
- 문맥이 없으면 강제 수정하지 않는다.
|
||||
- `-습니다`, `-어요`, `-해`, `-한다`의 혼용은 인용·대화 참여자 변경 때문에 정상일 수 있다.
|
||||
|
||||
## 9. 의도적 비표준·구어체
|
||||
|
||||
방언, 신조어, 업계 표현, 캐릭터 말투, 반복, 말줄임표, 이모티콘은 사용자의 의도를 담을 수 있다. 표준화 요청이 없으면 경고 또는 제안만 하고 원문을 보존한다.
|
||||
|
||||
## 10. 자연스러움과 간결성
|
||||
|
||||
불필요한 피동, 중복 표현, 과도한 명사화는 기본적으로 오류가 아니라 스타일 후보다. 다음 조건을 모두 만족할 때만 수정한다.
|
||||
|
||||
- 사용자가 윤문·간결화를 요청함
|
||||
- 기술적 의미와 단정 강도가 유지됨
|
||||
- 주체와 정보 초점이 바뀌지 않음
|
||||
- 더 짧은 수정으로 같은 효과를 얻을 수 없음
|
||||
|
||||
근거가 없으면 “더 자연스럽다”라는 설명을 만들지 않는다.
|
||||
@@ -0,0 +1,32 @@
|
||||
# 조사 자료 기반과 범위
|
||||
|
||||
이 스킬은 제공된 「한국어 문법·표현 교정 에이전트 스킬 설계 보고서」에서 다음 내용을 추출해 구성했다.
|
||||
|
||||
- 보수적 교정과 정밀도 우선 원칙
|
||||
- 의미·사실·문체·보호 구간 불변식
|
||||
- 공식 규범과 사전의 출처 우선순위
|
||||
- 조사·의존 명사·활용·보조 용언·높임의 대표 규칙
|
||||
- 허용형 보존과 중의성 보류 정책
|
||||
- 피드백 모드
|
||||
- 일반·어려운·회귀 테스트 27건
|
||||
- 출시 지표와 회귀 방지 기준
|
||||
|
||||
## 지원 범위
|
||||
|
||||
- 표준어 기반의 일반 한국어
|
||||
- 맞춤법, 띄어쓰기, 활용, 조사, 어미, 높임, 기본 표현 교정
|
||||
- 원문의 의미와 의도적 문체를 보존하는 제한적 윤문
|
||||
- 마크다운, 코드, URL, 명령어가 섞인 기술 문서
|
||||
|
||||
## 비지원 또는 제한 범위
|
||||
|
||||
조사 보고서만으로 다음 영역의 깊은 품질 기준은 충분히 정의되지 않았다.
|
||||
|
||||
- 문학·광고·브랜드 카피의 창작 문체
|
||||
- 특정 작가나 매체의 문체 모사
|
||||
- 기술 블로그 특유의 서사 구조와 독자 설계
|
||||
- AI 문체 탐지 자체
|
||||
- 최신 신조어·업계 용어의 포괄적 사전
|
||||
- 법률·의학 등 고위험 분야의 전문 용어 판정
|
||||
|
||||
이 영역은 별도 장르 스킬이나 도메인 자료를 추가해 확장한다. 현재 스킬은 확인되지 않은 규칙을 일반 지식으로 보충하지 않고 보류한다.
|
||||
Reference in New Issue
Block a user