mcpField
S
Simplified Technical English (ASD-STE100)

Simplified Technical English (ASD-STE100)

github.com/danyuchnエージェントワークフロー5.9k200 回インストール今日更新
リポジトリ

Simplified Technical English (ASD-STE100) について

ASD-STE100の原則を用いて、エージェントや他のシステム向けに英語の指示や技術文書を明確にするスキルです。規則違反を示し、意味を保った書き換えを提示しますが、認定STE作成ツールではありません。

主な機能

  1. 01曖昧な英語文の書き換え
  2. 02具体的な規則違反の指摘
  3. 03事実と条件の保持
  4. 04専門用語の用語集項目の提案

活用シーン

  1. 01プロンプトやツール説明の明確化
  2. 02エージェント指示や状況報告の簡潔化
  3. 03翻訳や後続処理向けの文章整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/danyuchn/asd-ste100-skill --skill simplified-technical-english-(asd-ste100)

インストール後、Claude Code で/simplified-technical-english-(asd-ste100)を入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
LICENSE
examples/
before-after.md
references/
writing-rules.md

詳細

簡易テクニカル英語(ASD-STE100)

ASD-STE100は、航空宇宙・防衛産業(ASD、欧州航空宇宙・防衛産業協会)が、整備技術者が英語の指示を誤読しないように策定した、統制言語の規格です。この規格は、誤読の主な原因を2つ取り除きます。複数の意味を持つ単語と、複数の構造に解釈できる文です。

このスキルは、同じ方針を別の読者、つまり人間が介在して曖昧さを解消できない状況で、エラーメッセージ、ツールの説明、エージェント間の指示、ステータスレポートなどの英語の文字列を解析する必要があるAI エージェントや後続システムに適用します。整備技術者が「close the valve」を命令ではなく形容詞(「近くにあるバルブ」)と誤読する可能性があるなら、言語モデルにも同じことが起こり得ます。

このスキルを使う場面

  • エージェントの出力(説明、指示、ログメッセージ、ツールの説明)が、難解で専門用語が多く、曖昧に感じられる場合。
  • テキストを別のエージェント、翻訳パイプライン、または英語を母語としない読者が扱い、誤解析によって実害が生じる可能性がある場合。
  • プロンプト、システムメッセージ、ツールの説明を書く際に、モデルが目にする前に曖昧さを取り除きたい場合。
  • どの規則に違反していたか、書き換えによってどのように解決したかを正確に示す変更前と変更後の比較を提示したい場合。

このスキルは、創作やマーケティング向けの文章には適していません。STEは意図的に平坦で文字どおりの表現を使います。語調、ニュアンス、説得力が重要な文章には適用しないでください。

情報源と適用範囲

このスキルには、ASD-STE100第9版(2025年1月)の規則カテゴリが組み込まれています。単語の選択、文法、文の構造、スタイルを扱う9つのセクションに、53の文章作成規則が記載されています。また、承認済み単語約900語(各単語に意味と品詞が1つずつ)と、推奨される置き換え表現を添えた使用を避けるべき単語約1,200語の辞書に基づいています。規則の概要と出典の詳細については、references/writing-rules.mdを参照してください。

ASDが定める承認済み単語約900語の辞書を、そのまま再現するものではありません。この文書はASDが無料でダウンロードできる公式規格であり、丸ごと複製すべきものではありません。その代わりに、固定の単語リストと照合するのではなく、根本的な原則(できるだけ平易で一般的な単語を選び、常に同じ方法で使うこと)を適用します。ASDが承認した正確な表現が重要な場合(実際の航空機整備文書など)は、https://www.asd-ste100.org/ から公式規格をダウンロードし、実際の辞書と単語ごとに照合してください。

基本的な書き換えルール

ルールすることしないこと
1つの単語に1つの意味1つの動作には動詞を1つ選び、毎回同じ動詞を使います(例:常に「確認する」を使い、同じ動作に「確認する」「検証する」「確かめる」を混在させない)同じ意味を文書全体で類義語に置き換える
1つの単語につき1つの品詞「バルブにオイルを塗布する」(オイル=名詞)「バルブにオイルを塗る」(オイル=動詞)—「オイル」が名詞としてのみ承認されている場合
能動態「エージェントがファイルを削除します。」「ファイルは削除されます(エージェントによって)。」—行為者が本当に不明、または無関係な場合を除く
単純時制のみ「レポートを受け取りました。」(単純過去)「レポートを受け取っています。」(現在完了)
1文につき1つの指示「ファイルを開きます。3行目を読みます。」「ファイルを開いて3行目を読み、一致しているか確認します。」
文の長さ指示や手順は20語以下、説明は25語以下長い複文や従属節を含む文
名詞の連結名詞句として連結する語は3語以下(「燃料ポンプバルブ」)名詞を4語以上連結する(「高圧燃料ポンプ入口バルブアセンブリ」)
省略表現を使わない長くなっても、主語、動詞、冠詞を明示します簡潔にするために語句を省く(「バックアップされていないファイルは失われます」→どのファイルを指すか曖昧)
段落の制限1段落につき1つのトピックとし、6文以下にします複数のトピックを1つの段落にまとめる
手順はリストにする3つ以上の手順や条件には、番号付きリストまたは箇条書きを使います1つの文章の中に手順を埋め込む
専門用語必要な技術的な名詞や動詞は使います。ただし、一般的な英語ではない用語は一度定義します(STEでは、基本辞書に加えてプロジェクト固有の用語集を使用できます)定義せずに専門用語を使う

プロセス

  1. 意味を把握するため、入力文を一度読みます。書き換え後にも何を伝える必要があるか理解する前に、書き換えを始めないでください。
  2. 文ごとに確認し、すべてのルール違反(単語の曖昧さ、時制、態、長さ、省略、名詞の連結)に印を付けます。
  3. 印を付けた文をそれぞれ書き換え、元の意味を正確に保ちながら違反を修正します。書き換えによって必要な正確さ(安全条件、適用範囲の限定、数値)が失われる場合は、黙って簡略化せず、長い表現を維持してその旨を示します。
  4. 変更前/変更後の表を作成します(出力形式を参照)。
  5. 入力文がすでにルールに準拠している場合は、その旨を伝えます。準拠している文を無理に変更しないでください。

出力形式

| Rule violated | Original | Simplified |
|---|---|---|
| Present perfect tense | "We have received your request." | "We received your request." |
| Noun cluster (4+ words) | "the agent task queue priority handler" | "the handler that sets task-queue priority" |

表の後に、意図的に簡略化しなかった箇所とその理由を1行で記載します(通常、簡略化すると必要な正確さが失われるためです)。

対応範囲

対応すること:

  • 曖昧または難解な英語を、短く、意味が1つに定まり、能動態の文に書き換えます。
  • 書き換える前に、どの文がどのルールに違反しているかを正確に示します。
  • 元の文に含まれる事実、条件、適用範囲の限定をすべて保持します。
  • 残す必要がある専門用語について、用語集に追加する1行の項目を提案します。

対応しないこと:

  • ASDの公式約900語の辞書を、暗記した内容としてそのまま再現すること。承認済みの正確な表現については、必ず公式のダウンロード版を正とします。
  • 表現やニュアンスが重要な創作、マーケティング、説得を目的とする文章を簡略化すること。
  • 安全条件、例外、適用範囲の限定を、文を短くするために黙って削除すること。その場合は、トレードオフを示します。
  • 航空宇宙・防衛分野の基準に準拠したSTE文書を保証すること。これはSTEに着想を得た汎用の明確化ツールであり、認定済みのSTE文書作成ツールではありません。

追加リソース

  • references/writing-rules.md — 9つのルール項目と辞書の構成を詳しくまとめた資料です。公式規格および二次資料からの引用を含みます。
  • examples/before-after.md — 公式STEの例や、このスキル向けに作成されたエージェント出力の例を含む、変更前/変更後の例です。

コメント