# AI 寫的英文說明書，客戶看不懂？用 asd-ste100-skill 0.01 秒抓出 8 處毛病

- 網址：https://blog.valenvan.uk/posts/danyuchn-asd-ste100-skill.html
- 發布日期：2026-10-13
- 測試設備：Mac mini M4 Pro（12 核、64GB）
- 專案：danyuchn/asd-ste100-skill（https://github.com/danyuchn/asd-ste100-skill），MIT 授權
- 測試版本：danyuchn/asd-ste100-skill 的 scripts/ste-lint.py（2026-10-13 的主分支）
- 實測影片：https://www.youtube.com/shorts/dgMc941bKqw

## 重點摘要

- ste-lint.py 是純 Python 標準庫的英文寫作檢查腳本，免安裝；對一段 59 字的官腔說明抓出 8 處違規（5 項硬性），每百字 13.6 處。
- 照提示改寫成 41 字後，檢查結果為 0 違規。
- 把「We replace the device」改成意思相反的「We never replace the device」，仍然是 0 違規，因為它只查寫法、不查意思。
- should be connected、will be replaced 等被動句與 Take off the panel 這類口語動詞在實測中沒被抓到。
- **結論：** 適合當英文文件的初篩，無法保證意思正確，改完仍須人讀一遍。
- **適合：** 要寫英文說明書、錯誤訊息或給翻譯用文件的人
- **不適合：** 需要驗證意思不變或 ASD 認證合規的人

| 實測項目 | 結果 |
|---|---|
| 原稿違規數 | 8 處（5 項硬性），59 字 |
| 改寫後違規數 | 0 處，41 字 |
| 意思反轉後違規數 | 0 處 |
| 未抓到的寫法 | should be connected、will be replaced、Take off the panel |
| 安裝 | 免安裝，純 Python 標準庫 |

公司要你寫一份英文操作說明，寄給海外客戶。你請 AI 幫忙，出來的句子漂亮又專業，結果客戶回信：「這句到底要我做什麼？」問題通常不在文法，而在句子太容易被誤讀。

航空業有一套專門對付這件事的「簡化技術英語」（ASD-STE100）：一個字只用一種意思、少用被動、不用口語動詞片語、一句話只講一件事。GitHub 上的 [asd-ste100-skill](https://github.com/danyuchn/asd-ste100-skill) 把這些規則整理成給 Claude Code 用的技能，附帶一支純 Python 的檢查腳本 `ste-lint.py`。這篇只實測這支檢查腳本。

## 測試環境

Mac mini M4 Pro（12 核、64GB）。腳本只用 Python 標準庫，不需要安裝任何套件。

## 實測一：典型官腔說明

我寫了一段 59 字、很像 AI 或行銷部會寫的說明：

```text
Our robust platform leverages cutting-edge technology; it has been designed to be easily installed by the user.
Before you kick off the setup, the cable should be connected to the router.
The installation of the software is performed by the wizard.
If the light is not on, reach out to our support team and the device will be replaced.
```

```bash
python3 scripts/ste-lint.py o.txt
```

![檢查原稿，抓出 8 處](https://blog.valenvan.uk/img/danyuchn-asd-ste100-skill-article_1.png)

結果：8 處違規（5 項硬性），每百字 13.6 處，掃描不到 0.1 秒。抓到的有：robust、cutting-edge 兩個行銷形容詞，一個分號，`has been designed`、`is performed` 等被動與完成式，還有 `kick off`、`reach out` 兩個口語動詞片語。

為什麼這些會出事？`kick off` 可以是「開始」也可以是「踢開」；被動句不交代是誰要做；`robust` 沒有數字，等於沒說。

## 實測二：照提示改寫

改寫成 41 字：

```text
The platform is easy to install.
The user can install it alone.
Before you start the setup, connect the cable to the router.
The wizard installs the software.
If the light is off, contact our support team.
We replace the device.
```

再檢查：0 違規。句子變短，動作主詞都清楚。

## 實測三：它的盲點

這個檢查器只看寫法，不看意思。我把最後一句改成 `We never replace the device.`（意思整個反過來），它照樣回報 0 違規。

![意思反了仍是 0 違規](https://blog.valenvan.uk/img/danyuchn-asd-ste100-skill-article_2.png)

另外在同一次測試中，下面這些沒被抓到：

| 句子 | 結果 |
|---|---|
| The cable should be connected to the router. | 零警告（被動） |
| The device will be replaced. | 零警告（被動） |
| Take off the panel. | 零警告（口語動詞） |
| The wizard was written by the team. | 抓到被動 |
| The lid was removed. | 抓到被動 |

作者在 README 也寫明：它不認識清單以外的片語動詞，也不比對改寫前後意思有沒有變，且沒有附 ASD 官方 900 字字典（授權不允許轉載）。

## 結論

- 適合：要寫英文說明書、錯誤訊息、給海外客戶或翻譯用的文件，想先自動抓一輪容易誤讀寫法的人。
- 不適合：想用它保證「意思沒變」或「符合 ASD 認證」的人；那需要真人和官方標準。
- 用法：當初篩。改完還是要有人讀一遍意思。

專案：<https://github.com/danyuchn/asd-ste100-skill>（MIT 授權）