.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>
96 lines
2.2 KiB
Markdown
96 lines
2.2 KiB
Markdown
# 출력 모드
|
|
|
|
## 공통 원칙
|
|
|
|
- 수정문을 먼저 제시한다.
|
|
- 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 + 사용자 지정 강도` |
|