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、粗体、表格，以及第一行的标题或列表。
盲评
12 / 16
在不知道哪个是技能回答的评判中，16 组里 SimpleKorean 回答胜出的组数。3 组打平，1 组落败。
文档的检查器警告
0.71 → 0.17
每 100 个语节的检查器警告数。语节是韩语中按空格分开的单位。
最长句子
18 → 15 个语节
16 份文档中最长的句子。严格模式下为 13 个语节。

文档和回答由 claude-sonnet-5-5 编写，由 claude-opus-5-5 评判。
评判模型也是 Claude，所以可能偏向同一系列的模型。

03 规则

句子要短，先写答案

拆分长句，减少不必要的格式，修正翻译腔。

  • 回答

    在第一句写出答案

    防止： 重复问题的开场白

  • 回答

    不用粗体和表格

    防止： 包在一行答案外面的格式

  • 回答

    不用 em-dash

    防止： 只连了一半的想法

  • 文档

    操作句不超过 15 个语节，说明句不超过 20 个语节

    防止： 没完没了的长句

  • 文档

    用“-면”（如果）把条件放在命令前面

    防止： 放在命令后面、读者读到时已太晚的“단, ~경우”（但是，在~的情况下）

  • 文档

    使用主动语态和简单时态

    防止： “되어지다”（双重被动）、“~에 의해”（由~）、“-고 있습니다”（正在~）

  • 文档

    不用猜测和建议语尾

    防止： “-ㄹ 수도 있습니다”（可能）、“-것 같습니다”（好像）

  • 文档

    一个词只表示一个意思

    防止： 交替使用“확인”“검증”“점검”（都表示“检查”）

这些规则来自航空维修文档使用的受控英语 ASD-STE100。完整规则见 SKILL.md。

04 写法

同一个术语用同一种写法

遵循韩语外来语标记法和国立国语院的用例。没有规定写法的词，由项目决定使用的写法。

  • 디렉터리不写作 디렉토리
  • 메시지规范形式
  • 애플리케이션规范形式
  • 릴리스规范形式
  • 셸规范形式
  • 레포지토리惯用形式
  • 바디惯用形式
  • 칼럼惯用形式
  • 리팩터링没有官方写法
  • 반환값连写

如果公司的写法不同，可以在仓库根目录的 .simple-korean.json 中修改。

05 安装

按你使用的工具安装

  • Claude Code

    一起安装技能、三个钩子和输出样式。

    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"

如果不安装就使用，请把仓库地址交给智能体，并让它按照 README 操作。