ste-ko-skillSAFE

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

/plugin marketplace add junwonkim07/ste-ko-skill
/plugin install ste-ko@ste-ko-skill

claude plugin marketplace add junwonkim07/ste-ko-skill

claude plugin install ste-ko@ste-ko-skill

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: ste-ko
description: "한국어로 남이 읽을 글을 쓰거나 고칠 때 쓴다: 기술 문서, README, 장애·작업 보고, 커밋 메시지, PR 본문, 코드 주석, Slack·Notion·이메일 업무 글, UI 문구, 오류 메시지. ASD-STE100 방식의 한국어 통제 언어 규격(STE-KO)으로 결론을 먼저 쓰고, 한 대상은 한 단어로 부르고, 이중피동·번역투·빈 동사를 걷어내고, 사실·추론·미확인을 나눈다. 사실·조건·부정·수치·확신 수준은 바꾸지 않는다. '쉽게 고쳐줘', '번역투 빼줘', '간결하게', '읽기 쉽게', 'STE-KO', '/ste-ko' 요청에 쓴다. 대화 답변은 플러그인 출력 스타일이 `대화` 표면으로 맡는다. 홍보·창작·법률 문구에는 쓰지 않는다. Korean controlled-language writing for docs, commits, PRs, work messages and UI copy. For English text use the asd-ste100 skill."
---

# STE-KO

한국어 글을 한 번 읽고 행동할 수 있게 쓴다. 규칙 본문은 [beamonic/ste-ko](https://github.com/beamonic/ste-ko)의 STE-KO 0.5다. 이 스킬은 그 규칙을 그대로 강제하지 않고, 뜻을 바꾸지 않는 범위에서만 적용한다.

규칙 번호는 원본 `references/upstream/SPEC.md`의 번호를 쓴다. 리뷰에서 "어색해요" 대신 "2.1 위반, 명사 5개"처럼 쓴다.

## 언제 쓰나

| 쓴다 | 쓰지 않는다 |
|---|---|
| 기술 문서, README, 절차서, 장애 보고, 상태 보고 | 홍보 문안, 창작, 감상문 |
| 커밋 메시지, PR 본문, 코드 주석, 작업 보고 | 법률 문구, 계약서, 인용문 |
| Slack·Notion·이메일 업무 글, 리뷰 코멘트, UI 문구 | 코드, 로그, 명령어, 식별자 자체 |
| AI 대화 답변 (플러그인 출력 스타일이 적용, 아래 "대화 답변") | |

영어 글은 `asd-ste100` 스킬을 쓴다.

## 우선순위

두 기준이 부딪히면 위쪽을 따른다.

1. 안전과 되돌릴 수 없는 결과 (7장)
2. 사실, 조건, 예외, 부정, 수치, 확신 수준 (6장)
3. 모호성 제거와 논리 관계 (1-4장)
4. 독자에게 맞는 말투와 자연스러운 흐름
5. 간결함 (9장)

짧게 쓰는 것은 목표가 아니다. 위쪽 기준을 지키려면 글이 길어져도 된다.

## 표면

글이 놓일 자리를 먼저 정한다. 정하지 않으면 `문서`다.

| 표면 | 자리 | 문장 길이 신호 | 문단 신호 |
|---|---|---|---|
| `문서` | 기술 문서, 보고, 절차서 | 25어절 | 6문장 |
| `코딩` | 커밋, PR 본문, 코드 주석, 작업 보고 | 20어절 | 4문장 |
| `대화` | Slack, 이메일, 리뷰 코멘트 | 25어절 | 4문장 |
| `UI` | 버튼, 라벨, 안내, 오류 메시지 | 12어절 (버튼 3, 라벨 5) | 2문장 |

길이 신호는 상한이 아니다. 넘으면 다시 읽고, 뜻이 둘이면 나눈다. 넘었다는 이유만으로 자르지 않는다.

## 대화 답변

스킬은 매 답변에 불리지 않는다. 플러그인으로 설치하면 출력 스타일 `output-styles/ste-ko.md`가 모든 대화 답변에 아래 규칙을 적용한다. 플러그인 없이 쓰면 `references/chat-preferences.md`의 블록을 `~/.claude/CLAUDE.md`나 claude.ai 개인 설정에 넣는다.

대화 답변에는 `대화` 표면 규칙을 쓴다.

- 결론과 현재 상태를 첫 1-2문장에 쓴다 (6.1). 앞 턴을 되풀이하며 시작하지 않는다 (10.4).
- 모르면 첫 문장에서 모른다고 쓴다 (10.5).
- 되묻기는 한 번에 하나, 선택지는 3개까지 쓴다 (10.3).
- 분량은 질문에 맞춘다 (10.15). 짧은 답에 제목을 붙이지 않고 같은 결론을 반복하지 않는다 (10.17).
- 다음 행동은 실행이나 결정이 필요한 답에만 쓴다 (10.16).

## 반드시 지킨다

1. **결론을 먼저 쓴다 (6.1).** 보고와 설명은 첫 두 문장 안에 결론과 현재 상태를 쓴다. 교육 글과 서사는 목적에 맞는 순서를 쓴다.
2. **같은 대상은 같은 단어로 부른다 (1.2).** 동의어로 바꿔 쓰지 않는다. 다른 대상을 한 단어로 합치지도 않는다.
3. **사실, 추론, 미확인을 나눈다 (6.2, 3.7).** 확인한 것은 `-했다`, 추론은 `-로 보인다` + 근거, 모르는 것은 `아직 확인하지 못했다`로 쓴다.
4. **하지 않은 일을 했다고 쓰지 않는다 (10.8, 6.4).** 실행하지 않은 테스트, 실패, 부분 성공, 건너뛴 단계를 그대로 쓴다.
5. **이중피동을 쓰지 않는다 (3.2).** `보여집니다`는 `보입니다`, `되어졌다`는 `됐다`로 쓴다.
6. **범위에 물결표를 쓰지 않는다 (8.1).** `3~5개`는 마크다운에서 취소선이 된다. `3-5개`로 쓴다.
7. **되돌릴 수 없는 동작은 동작 앞에 알린다 (7.1, 7.3).** "되돌릴 수 없습니다"라고 그대로 쓴다.

## 기본으로 지킨다

어길 때는 이유가 있어야 한다.

- **행위자를 밝힌다 (3.1, 3.3).** `처리되었습니다` 대신 `서버가 요청 3건을 거부했다`로 쓴다. 행위자를 모르거나 상태가 주제면 피동을 쓴다.
- **동작은 동사로 쓴다 (2.5).** `검토를 진행했다`는 `검토했다`로 쓴다. `데이터 보존 정책`처럼 개념의 이름은 그대로 둔다.
- **명사를 4개 넘게 잇지 않는다 (2.1).** `인증 토큰 갱신 실패 처리 로직`은 `인증 토큰 갱신이 실패할 때 실행하는 코드`로 푼다. 공식 명칭은 예외다.
- **한 문장에 중심 내용 하나를 쓴다 (4.2, 4.3).** 조건과 행동, 원인과 결과, 대조, 동시에 하는 동작은 한 문장에 함께 둔다. `-고`, `-며`로 절을 셋 넘게 잇지 않는다.
- **번역투와 공문투는 관계가 흐려질 때 바꾼다 (1.3).** `이를 통해`가 수단인지 경로인지 모호하면 `이 방법으로`처럼 쓴다. 관계가 정확하면 그대로 둔다.
- **슬래시로 `및/또는`을 쓰지 않는다 (8.4).** `관리자 또는 운영자`처럼 단어로 쓴다. 경로와 단위는 예외다.
- **절차는 조건을 먼저 쓴다 (5.3).** 한 번호에 동작 하나를 쓰고, 성공을 확인하는 방법을 붙인다 (5.1, 5.5).
- **커밋과 PR에는 무엇을 왜 바꿨는지 쓴다 (10.6).** 위치는 `파일:줄`로 쓴다 (10.7). 남긴 일은 목록으로 쓴다 (10.9).
- **UI 버튼은 사용자가 하는 동작을 쓴다 (10.10).** 오류 메시지에는 원인과 다음 동작을 쓰고, 사용자를 탓하지 않는다 (10.12, 10.13).

## 원본보다 느슨하게 적용하는 것

원본 규칙을 기계적으로 지키면 뜻이 바뀌거나 글이 딱딱해지는 곳이 있다. 이 스킬은 아래처럼 적용한다. 판단 기준과 예시는 `references/judgment.md`에 있다.

| 원본 | 이 스킬 |
|---|---|
| 4.1 문장 길이 상한 `필수` | 다시 읽어 볼 신호. 뜻이 하나면 그대로 둔다. |
| 1.3 비승인 어휘 금지 `필수` | 바꿀 방향. 관계나 뜻이 정확하면 그대로 둔다. |
| 사전 E절 `일부`, `대부분` 금지 | 수치를 알 때만 수치로 쓴다. 모르면 그대로 둔다. |
| 사전 G-2절 `-일 수도 있습니다` 금지 | 확률을 모르면 그대로 둔다. 확신 수준은 내용이다. |
| 사전 H절 `약 30분` 금지 | 추정치면 `약`을 남긴다. |
| 1.8 비유 금지 | 설명 글에서는 쓴다. 비유와 실제가 다른 점을 함께 쓴다. 절차와 지시는 문자 그대로 쓴다. |
| 4.8 종결어미 3연속 금지 | 자연스러우면 그대로 둔다. |
| 5.2 `-하십시오` 명령형 | 사용자가 정한 말투와 높임을 따른다. |
| 10.16 다음 행동으로 끝낸다 | 실행이나 결정이 필요한 글에만 쓴다. |
| 9장 압축 등급 | 사용자가 요청할 때만 압축한다. |

외부에 보내는 글처럼 정중함이 필요한 곳에서는 `혹시`, `부탁드립니다`를 남긴다.

## 하지 않는다

- 없는 사실을 만들지 않는다. 수치, 원인, 담당자, 날짜, 출처가 없으면 쓰지 않는다. 꼭 필요하면 `[원인 확인 필요]`처럼 자리를 표시한다.
- 확신 수준을 바꾸지 않는다. `일 수 있다`를 `이다`로, `약 30분`을 `30분`으로, `권장`을 `필수`로, `이후`를 `때문에`로 바꾸지 않는다.
- 부정과 한정을 지우지 않는다. `안`, `못`, `없다`, `아니다`, `만`, `-뿐`, `제외`, `아직`, `최대`는 줄일 때도 남긴다.
- 코드, 명령어, 로그, 오류 메시지 원문, 식별자, 인용문은 고치지 않는다.
- 말투와 높임 단계를 바꾸지 않는다. 사용자가 반말 메모 투(`~함`, `~임`)를 쓰면 그대로 쓴다.
- 내용이 빈 글을 다듬어서 내용이 있는 것처럼 보이게 하지 않는다. 빈 곳이 있으면 빈 곳을 말한다.

## 작업 순서

1. 표면과 독자를 정한다.
2. 사실, 추론, 미확인, 제안을 나눈다.
3. 결론, 근거, 조건과 한계, 다음 행동 순서로 놓는다. 필요 없는 칸은 뺀다.
4. 위 규칙을 적용한다. 문장마다 뜻이 원문과 같은지 확인한다.
5. 10줄이 넘는 글은 검사기를 돌린다. `hard`는 고친다. `warn`은 문맥을 보고 정한다.
6. 결과를 낸다.

## 출력

기본 출력은 고친 글뿐이다. 앞뒤에 설명, 규칙 목록, 요약을 붙이지 않는다.

뜻을 지키려고 일부러 남긴 표현이 있으면 글 뒤에 한 줄만 쓴다.

```
그대로 둔 것: `약 30분` — 추정치라서 `약`을 지우면 확정 시간이 된다.
```

사용자가 "무엇을 고쳤어?", "규칙 보여줘", "전후 비교"를 요청하면 표로 낸다.

```markdown
| 규칙 | 원문 | 고친 글 |
|---|---|---|
| 3.2 이중피동 | 결과가 보여집니다 | 결과가 보입니다 |
| 2.5 명사화 | 삭제를 진행했습니다 | 삭제했습니다 |
```

## 검사기

`scripts/ste-ko-lint.py`는 기계로 셀 수 있는 규칙만 본다. 의존성이 없다.

```bash
python3 scripts/ste-ko-lint.py 문서.md --surface 문서
python3 scripts/ste-ko-lint.py 'docs/**/*.md' --all
echo "고칠 글" | python3 scripts/ste-ko-lint.py - --surface 코딩
python3 scripts/ste-ko-lint.py --self-test
```

| 등급 | 뜻 | 종료 코드 |
|---|---|---|
| `hard` | 3.2 이중피동, 8.1 범위 물결표 | 1 |
| `warn` | 번역투, 공문투, 빈 동사, 명사화, 문장 길이 신호 | 0 (`--strict`면 1) |
| `info` | 모호어, 완충어, 수치 표현. 근거가 있을 때만 바꾼다 | 0, 기본 출력에서 숨김 |

결론 위치(6.1), 명사 나열(2.1), 사실과 추론 구분(6.2)은 형태소 분석이나 문맥이 필요해서 검사기가 보지 않는다. 사람이나 모델이 읽고 판단한다.

## 참고 파일

- `references/judgment.md` — 원본보다 느슨하게 적용하는 판단 기준과 전후 예시
- `references/chat-preferences.md` — 대화 답변에 적용하는 설정 블록 (Claude Code, claude.ai)
- `references/upstream/SPEC.md` — STE-KO 규칙 본문 원문 (beamonic, MIT)
- `references/upstream/dictionary.md` — 비승인 표현 대응표 원문 (beamonic, MIT)

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.