SimpleKorean

AIが書く韓国語を、
短く明確に。

SimpleKorean は、AI が文書と回答をやさしい韓国語で書くようにするエージェントスキルです。
長い文を分け、翻訳調を減らし、用語の表記をそろえます。
SimpleEnglish と ASD-STE100 から着想を得て作りました。

インストール GitHub で見る

01 前後の比較

同じ下書きがどう変わるかを見てください

左が元の下書き、右が SimpleKorean を適用した文書です。変わった文の下に、適用したルールを書きました。例文は韓国語のままです。

  • em-dash 2 → 0
  • 太字 2 → 0
  • 中点 3 → 0
  • 勧めの語尾 2 → 0
  • 最長の文 12語節 → 11語節
1

下書き： ## 문제 해결

1

修正後： ## 문제 해결

2

下書き： **Postgres 연결 타임아웃** —

2

修正後： ### Postgres 연결 타임아웃

適用したルール： 太字と em-dash の代わりに見出しを使います

3

下書き： sqlpipe가 connection timed out 오류를 내면 대부분 방화벽·보안 그룹이 5432 포트를 막고 있는 것입니다.

12語節
3

修正後： sqlpipe가 connection timed out 오류를 내면 대부분 방화벽이나 보안 그룹이 5432 포트를 막습니다.

11語節

適用したルール： 中点の代わりに助詞でつなぎ、単純な現在形で書きます

4

下書き： nc -zv <호스트> 5432로 연결되는지 확인해 보시기 바랍니다.

5語節
4

修正後： sqlpipe를 실행하는 호스트에서 nc -zv <호스트> 5432로 연결되는지 확인하세요.

6語節

適用したルール： コマンドを実行するホストを明示し、勧めの語尾を命令形「-하세요」に変えます

5

下書き： **S3 권한 오류** —

5

修正後： ### S3 권한 오류

6

修正後に加えた文： sqlpipe가 AccessDenied 오류를 내면 먼저 aws sts get-caller-identity로 현재 쓰는 자격 증명을 확인하세요.

11語節

適用したルール： 最初にすることを前に置きます

6

下書き： AccessDenied가 나면 IAM 정책·버킷 정책에 읽기·쓰기 권한(s3:GetObject, s3:PutObject)이 있는지 확인하세요.

10語節
7

修正後： 그다음 IAM 정책과 버킷 정책에 읽기와 쓰기 권한(s3:GetObject, s3:PutObject)이 있는지 확인하세요.

11語節

適用したルール： 中点の代わりに「과」「와」（と）でつなぎます

7

下書きから消した文： 먼저 aws sts get-caller-identity로 지금 쓰는 자격 증명을 확인하는 것이 좋습니다.

9語節

適用したルール： 右の6番の文に移し、勧めの語尾を消しました

出典：evals/results/2026-10-21。文の対応と適用したルールは人が付けました。ほかの比較は前後の例を参照してください。

02 測定結果

スキルをオンにすると、こう変わります

測定に使った生の出力を公開しています。下の数値はその出力から計算し直せます。

回答の書式の欠陥
162 → 0
回答32個で画面に見える欠陥の数。em-dash、太字、表、先頭行の見出しや箇条書きを数えます。
ブラインド判定
16組中 12組
どちらがスキルの回答かを伏せた判定で、SimpleKorean の回答が勝った組。3組は引き分け、1組は負けでした。
文書のリンター警告
0.71 → 0.17
100語節あたりのリンター警告。語節は分かち書きで区切った単位です。
最長の文
18 → 15語節
文書16個の中で最も長い文。厳格モードでは13語節です。

文書と回答は claude-sonnet-5-5 が書き、判定は claude-opus-5-5 が行いました。
判定モデルも Claude なので、同じ系列に有利な偏りがあり得ます。

03 ルール

文は短く、答えを先に書きます

長い文を分け、不要な書式を減らし、翻訳調を直します。

  • 回答

    最初の文に答えを書きます

    防ぐもの： 質問を繰り返す前置き

  • 回答

    太字と表を使いません

    防ぐもの： 1行の答えを囲む書式

  • 回答

    em-dash を使いません

    防ぐもの： 半分だけつながった考え

  • 文書

    手順文は15語節以下、説明文は20語節以下で書きます

    防ぐもの： どこまでも続く冗長な文

  • 文書

    条件は「-면」（〜なら）で命令の前に置きます

    防ぐもの： 命令の後ろに付いて遅れて読まれる「단, ~경우」（ただし〜の場合）

  • 文書

    能動態と単純な時制で書きます

    防ぐもの： 「되어지다」（二重受動）、「~에 의해」（〜によって）、「-고 있습니다」（〜しています）

  • 文書

    推測と勧めの語尾を使いません

    防ぐもの： 「-ㄹ 수도 있습니다」（〜かもしれません）、「-것 같습니다」（〜ようです）

  • 文書

    1つの語には1つの意味だけを与えます

    防ぐもの： 「확인」「검증」「점검」（どれも「確認」の意）を入れ替えて使うこと

ルールは、航空整備文書に使う統制英語 ASD-STE100 から来ています。ルールの全体は SKILL.md にあります。

04 表記

同じ用語は同じ表記で書きます

外来語表記法と国立国語院の用例に従います。決まった表記がない語は、プロジェクトで使う表記を決めます。

  • 디렉터리디렉토리ではない
  • 메시지規範形
  • 애플리케이션規範形
  • 릴리스規範形
  • 셸規範形
  • 레포지토리慣用形
  • 바디慣用形
  • 칼럼慣用形
  • 리팩터링公式の表記なし
  • 반환값続けて書く

会社の表記が違う場合は、リポジトリ最上位の .simple-korean.json で変えられます。

05 インストール

使うツールに合わせてインストールしてください

  • Claude Code

    スキル、フック3つ、出力スタイルをまとめてインストールします。

    claude plugin marketplace add say8425/SimpleKorean
claude plugin install simple-korean@simple-korean

  • Codex

    スキルとセッション開始フックをインストールします。

    codex plugin marketplace add say8425/SimpleKorean
codex plugin add simple-korean@simple-korean

  • そのほかのエージェント

    skills CLI でスキルだけをインストールします。

    npx skills add say8425/SimpleKorean

  • Python

    Python のコードから回答ルールとリンターを使います。

    pip install "simple-korean==1.2.0"

インストールせずに使うには、エージェントにリポジトリの URL を渡し、README に従うよう指示してください。