Community寫作與編輯github.com

asd-ste100

將給定的英文文本改寫為 ASD-STE100 簡化技術英語:一個詞對應一個意思、主動語態、簡單時態、短句。當需要釐清文本、應用 STE100 或簡化技術英語,或進行純語言/受控語言改寫以防止代理誤讀時使用。若要編寫、重構或刪減整個代理文件(如 AGENTS.md、系統提示、工具描述、代理簡報),請使用 writing-agent-docs。不適用於創意或行銷文案。

asd-ste100 是什麼?

ASD-STE100 是由歐洲航空航天與國防工業協會(ASD)制定的受控語言標準,旨在防止維修技術人員誤讀英語指令。此技能將相同的紀律應用於 AI 代理或下游系統,這些系統需要解析英文字串(如錯誤訊息、工具描述、代理間指令、狀態報告),而沒有人類在迴圈中解決歧義。技能分為「嚴格」與「STE 風格」兩種模式,分別適用於程序性文本與說明性散文,並透過結構規則與詞彙規則的區分來實現。結構規則(如主動語態、無片語動詞、句子長度限制、無分號)可以完全應用,而詞彙規則(如一詞一義、每詞一個詞性)則因無法直接複製 ASD 官方約 900 詞的詞典而只能作為傾向性指導。該技能支援多種平台,並能輸出簡化的文本或規則違反對照表。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smb374/agent-skills/tree/HEAD/skills/asd-ste100

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

簡化技術英語 (ASD-STE100)

ASD-STE100 是由航空航天與國防行業(ASD,歐洲航空航天與國防工業協會)建立的受控語言標準,旨在防止維修技術人員誤讀英語指令。該標準消除了導致誤讀的兩個最大來源:具有多個含義的詞語,以及具有多種可能結構的句子。

這項技能借用了同樣的紀律,但針對的是不同的讀者:AI 代理或下游系統,它們需要解析英文字串(如錯誤訊息、工具描述、代理間指令、狀態報告),而沒有其他人類在迴圈中解決歧義。如果維修技術人員可能將“close the valve”誤讀為形容詞(“靠近的閥門”)而不是命令,那麼語言模型也可能犯同樣的錯誤。

使用時機

  • 代理的輸出(解釋、指令、日誌訊息、工具描述)顯得密集、充滿術語或含糊不清。
  • 文本將被另一個代理、翻譯管道或非母語英語讀者使用,且誤解析會帶來實際成本。
  • 你正在編寫提示、系統訊息或工具描述,並希望在模型看到之前消除歧義。
  • 你想要一個前/後對比,準確顯示違反了哪條規則以及改寫如何修復。提出要求——預設輸出僅是改寫後的文本(請參閱輸出格式)。

此技能不適用於創意或行銷文案——STE 故意平淡且直白。不要將其應用於以語氣、細微差別或說服力為重點的文本。

兩種模式

在改寫前選擇一種模式。如果使用者未指定,則從文本類型推斷。除非使用者要求規則表格(請參閱輸出格式),否則將選擇保留在內部。

嚴格 —— 程序、錯誤訊息、工具和功能描述、代理間指令、安全文本。任何誤讀都會產生成本的地方。應用以下所有規則,包括嚴格的長度限制和一詞一義的紀律。

STE 風格 —— README、PR 描述、變更日誌、解釋性散文。完整應用結構規則,並將詞彙規則視為建議性(請參閱核心改寫規則以了解此區分)。實際上,這意味著保持句子長度限制、主動語態、簡單時態、無片語動詞、無分號、無名詞化以及無行銷形容詞,同時放鬆一詞一義的限制:散文需要一定的靈活性,對散文進行嚴格的改寫會像人格移植而非澄清。

這兩種模式以及結構/詞彙規則的區分是從兩個方向看到的相同區別。區分裂說明了此技能無需 ASD 詞典即可驗證哪些規則。模式則說明了對於給定類型的文本應執行哪些規則。

來源與範圍

此技能編碼了 ASD-STE100 Issue 9 (2025 年 1 月) 的規則類別:9 個章節中的 53 條寫作規則,涵蓋詞彙選擇、語法、句子結構和風格,並由一個約 900 個已批准詞彙(每個詞一個含義、一個詞性)和約 1,200 個應避免詞彙(附有建議替代詞)的詞典支援。請參閱 references/writing-rules.md 以獲取完整的規則摘要和引用。

它並未逐字複製 ASD 約 900 詞的已批准詞典。ASD-STE100 可以免費獲取,但不能免費重新發布:Issue 9 第 2 頁指出,"未經 ASD 官員的書面授權,不得對其進行全部或部分的複製或發布",並且僅對八類實體(ASD/AIA/AIAC 成員協會及其成員公司和客戶、成員國國防部、A4A、適航當局以及用於教育目的的大學和研究機構)授予免費複製權。此專案不屬於其中任何一類,因此詞典不包含在此儲存庫中。

取而代之的是,此技能應用基本原則(選擇最樸實、最常見的詞彙,並每次都使用相同方式),而不是針對固定詞彙列表進行檢查。當需要確切的 ASD 批准詞彙時(例如實際的飛機維護文件),請獲取標準並逐詞對照真實詞典進行檢查。從官方下載頁面申請——請注意,這是一個會透過電子郵件向您發送連結的申請表單,而不是直接下載。

核心改寫規則

STE 的規則分為兩類,此技能只能完全實現其中一類。結構規則是自成一體的:它們描述了句子形狀,您可以僅從描述中應用它們。詞彙規則完全由官方約 900 詞的詞典定義,此技能故意不複製該詞典(請參閱來源與範圍)。沒有該詞典,詞彙規則就從可驗證的標準降級為偏好樸實詞彙的傾向。

自信地應用結構規則。將詞彙規則作為指導方向應用,並在輸出中說明,而不是暗示您無法驗證的詞典合規性。

結構規則 —— 應用這些規則

規則正確錯誤
主動語態“代理刪除檔案。”“檔案(被代理)刪除。”——除非行為者確實未知或無關
無片語動詞 (規則 9.3)“取下面板。” / “開始工作。”“拆下面板。” / “啟動工作。”——雙詞動詞的含義無法從其組成部分預測
每句一個指令“打開檔案。讀取第 3 行。”“打開檔案並讀取第 3 行,然後檢查是否匹配。”
句子長度指令/程序 ≤20 個詞,描述 ≤25 個詞長復合句/從句句
無分號 (規則 8.1)分成單獨的句子任何分號——STE 完全禁止此標點,不僅作為從句連接。(規則 8.1 允許所有其他標準標點符號。雖然未禁止破折號,但它通常表示應被拆分的句子。)
名詞叢集≤3 個詞堆疊成名詞短語(“燃油泵閥門”)4+ 詞名詞堆疊(“高壓燃油泵進口閥門組件”)
無省略明確保留主語、動詞和冠詞,即使讀起來更長為了節省空間而省略詞語(“未備份的檔案將丟失”→ 模糊是哪個檔案)
保持情態“請求可能失敗了。”保留“可能”將推測提升為事實(“請求失敗了。”)或捏造來源未陳述的確定性
段落限制每個段落一個主題,≤6 個句子多主題段落
列表用於序列對 3 個或更多步驟或條件使用編號或項目符號列表將序列埋在一個散文句子中

詞彙規則 —— 僅作為指導方向

規則正確錯誤為何在此處較弱
一詞一義為一個動作選擇一個動詞並每次重複使用(例如總是使用“檢查”,不要混合使用“檢查”/“驗證”/“確認”表示同一動作)在整個文件中為同一概念輪換同義詞文件內的一致性是可檢查的。但哪個詞是批准的詞,沒有詞典則無法得知。
每詞一個詞性“將油塗抹在閥門上”(油 = 名詞)“給閥門上油”(油 = 動詞)“油”是否僅被批准為名詞是詞典事實。當兩者讀起來同樣好時,優先使用名詞形式。不要聲稱合規。
動詞,非名詞 (規則 3.7)“分析日誌。”“對日誌進行分析。”——動作的名詞形式使句子更長並隱藏了誰在行動規則 3.7 說“使用已批准的動詞來描述動作”。在任何地方偏愛動詞形式是安全的。知道哪個動詞是已批准的動詞需要詞典。
領域術語保留必要的技術名詞/動詞,但如果不是常見英語,則定義一次(STE 允許在其基礎詞典之外使用專案特定的術語表)使用術語而不進行定義術語表的允許是真實的 STE,但它擴展的基礎詞典不存在。

簡單時態 —— 應用時有一個例外

STE 允許不定式、祈使句、一般現在時、一般過去時、一般將來時以及作為形容詞的過去分詞。它排除現在完成時和其他複合形式:“we received the report”,而不是“we have received the report”。

飛機手冊永遠不需要現在完成時,因此該排除對標準來說沒有損失。其他文本並不總是如此幸運。“The job has completed”(且其輸出現在可用)和“the job completed”(在過去的某個時間點)是不同的陳述,狀態文本經常需要前者。當複合形式攜帶簡單形式無法傳達的資訊時——當前相關性,或如“may have failed”中的推測——請保留它並標記此偏離。 在其他情況下,遵循規則。

掃描檢查清單

這六個習慣涵蓋了絕大多數使機器編寫的英語難以解析的問題。每一個都是機械性的:您可以指出確切的詞或標點符號違反了規則,無需判斷。在改寫任何內容之前,掃描所有六項。

  1. 同義詞輪換 —— 同一事物在一個文件中有多個名稱(“使用者”、“客戶”、“客戶端”)。讀者無法判斷它們是一個事物還是三個事物。修正:選擇一個名稱,每次都使用它。
  2. 推測詞堆疊 —— 助動詞和限定詞堆疊起來,直到句子什麼也沒斷言(“it is important to note that this may potentially help to improve”)。修正:陳述主張,或刪除它。
  3. 名詞化 —— 動作凍結成名詞(“perform an analysis of”、“provides assistance to”)。修正:使用動詞(“analyze”、“helps”)。
  4. 行銷形容詞 —— 聲稱品質而非展示品質的詞:seamless、robust、powerful、cutting-edge、effortless、blazing-fast。修正:刪除,或替換為證明該主張的測量值。
  5. 冗長句子 —— 由分號或破折號連接的多個想法。修正:每個句子一個想法。
  6. 軟性片語動詞 —— spin up、reach out、dive into、kick off。修正:使用單一的樸實動詞(start、contact、read、begin)。

處理流程

  1. 選擇模式(嚴格或 STE 風格)。僅在使用者要求規則表格時才說明(請參閱輸出格式)。
  2. 閱讀輸入文本以理解其含義一次——在您理解它之後必須仍然表達什麼之前,不要開始改寫。
  3. 逐句處理。標記來自核心改寫規則表格的每個規則違反以及來自掃描檢查清單的每個習慣。在 STE 風格模式下,標記詞彙規則但不執行它們。該選擇留給改寫。Linter 沒有風格模式,同義詞輪換仍然是一個硬性發現。傳遞 --disable synonym-rotation 以放棄它。要對結構規則進行機械性的首次檢查,請運行 scripts/ste-lint.py(標準輸入或檔案參數,--json 取得結構化輸出);它檢查分號、句子長度、片語動詞、名詞化、行銷形容詞、同義詞輪換、支援列表中項目中的懸掛連詞、被動語態和複合時態,並且設計上從不標記推測詞或情態。--baseline N 容忍 N 個硬性違反(用於採用現有文件);--disable rule1,rule2 靜默指定的規則。
  4. 改寫每個標記的句子以修復違規,同時精確保留原始含義。如果改寫會丟失必要的精確度(安全條件、範圍限定詞、數字),則保留較長的措辭並標記它,而不是默默地簡化。
    • 在提交改寫之前檢查情態。 推測詞(“may”、“could”、“sometimes”、“is likely to”)承載著作者的信心,信心就是內容。一個將推測詞升級為事實的較短句子不是簡化——它是一個不同的主張。這是善意的 STE 改寫最常出錯的方式,因為推測詞正是長度限制誘使您刪除的內容。
    • 永遠不要添加來源未陳述的事實。一個為了讀起來更好而提供了原因、頻率或機制的改寫已經不再是改寫。
  5. 輸出改寫後的文本(請參閱輸出格式)。除非使用者要求查看,否則將模式選擇和規則分析保留在內部。
  6. 如果輸入已經合規,請說明——不要強行對合規文本進行更改。

輸出格式

預設:僅輸出改寫後的文本。 大多數呼叫者希望得到一個可以直接貼上到工具描述、錯誤字串或提示中的結果。單獨列印簡化後的文本。不要添加關於此技能的前言、模式公告、違規次數、更改摘要、規則表格或結束時提供進一步解釋的提議。

唯一允許的附加內容:如果步驟 4 故意保留了較長的措辭,請在文本後添加一行,以 保留原樣: 開頭,命名該短語以及將會丟失的精確度。當沒有可報告的內容時,省略此行。

應要求:規則表格。 當使用者要求查看推理時——“顯示差異”、“違反了哪些規則”、“解釋更改”、“前/後”——請改為輸出以下表格:

| 違反的規則 | 原始內容 | 簡化後內容 |
|---|---|---|
| 現在完成時 | “We have received your request.” | “We received your request.” |
| 名詞叢集 (4+ 詞) | “the agent task queue priority handler” | “the handler that sets task-queue priority” |

模式:嚴格。找到 7 個違規。

在表格後面添加一行註釋,說明您故意未簡化的任何內容及其原因(通常是:簡化會丟失所需的精確度)。

邊界

將會:

  • 將含糊或密集的英語改寫為簡短、單一含義、主動語態的句子。
  • 預設僅返回改寫後的文本,並在使用者要求時命名其應用的規則。
  • 保留原始內容中的每個事實、條件和範圍限定詞。
  • 保留每個推測詞的強度,並且不添加來源未做出的主張。
  • 為必須保留的領域術語建議一行術語表條目。

將不會:

  • 逐字複製 ASD 官方約 900 詞的詞典(請參閱來源與範圍)。
  • 在原始文本不明確時添加事實。
  • 改寫創意或行銷文本(語氣和細微差別是重點)。
  • 更改特定領域術語的含義。
  • 將推測詞升級為事實。
  • 產生比輸入更長的輸出(除了在保留精確度所需的特定情況,這時 保留原樣 標記將會出現)。

當輸入已經合規時,輸出應為 "輸入已經符合 ASD-STE100 結構規則。" 如有必要,可附上簡潔的解釋。

相關技能