Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
Agent Skill to Force Docs in ASD-STE100 Simplified Technical English (github.com)
要約
このエージェントスキルは、AIが生成する文書を航空宇宙産業で使われるASD-STE100(簡易技術英語)の標準に準拠させることを目的としています。これにより、曖昧さを排除し、誤読を防ぐことで、AIの出力品質を向上させます。このスキルは、様々なAIエージェントやプラットフォームで利用可能で、エラーメッセージやインシデントレポートなど、文書以外の用途にも応用できます。
全文翻訳
✈️ あなたのAIはLinkedInの投稿のように書きます。ボーイングのマニュアルのように書かせましょう。
LLMがASD-STE100 Simplified Technical Englishの規律に沿って平易な英語で書くようにするエージェントスキルです。これは、疲れた整備士が指示を誤読しないように、航空宇宙分野で1983年から使用されている統制言語です。デフォルトでは一般読者向けですが、要求に応じてSTE厳格モードになります。
[画像: 可視的な返信の欠陥が95%削減、測定済み] [画像: 9つのモデルでベンチマーク] [画像: Agent Skills] [画像: バージョン 2.1.1] [画像: MIT] [画像: GitHubスター]
[画像: AminBlg%2FSimpleEnglish | Trendshift]
Agent Skills standardを読み込むあらゆるエージェントで動作します:Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode、その他約25種類。1つのフォルダ、依存関係なし、MITライセンスです。
インストール
skills CLIを使えば、どのエージェントでも可能です。
npx skills add AminBlg/SimpleEnglish
これはスキルのみをインストールします。セッションフックや以下の出力スタイルはインストールしないため、プラグインなしでoutputStyleをsimple-english:simple-englishに設定しても何も起こりません。それらにはClaude Codeプラグインを使用してください。
Claude Codeプラグイン(セッションフックと出力スタイル付き):
claude plugin marketplace add AminBlg/SimpleEnglish && claude plugin install simple-english@simple-english
出力スタイルはsimple-english:simple-englishという名前です。短い名前は解決しません。/configの下の出力スタイルで選択するか、~/.claude/settings.jsonに{"outputStyle": "simple-english:simple-english"}を記述してください。
Codexプラグイン(セッションフック付き):
codex plugin marketplace add AminBlg/SimpleEnglish
codex plugin add simple-english@simple-english
Codexは、最初の実行前にフックを信頼するように求めてきます。フックにはNode.jsが必要です。詳細はsrc/hooks/README.mdを参照してください。
スキルサポートがない場合? prompts/system-prompt.mdのルールブロックをシステムプロンプト、AGENTS.md、または.cursorrulesに貼り付けてください。ページには、予算がタイトな場合のための60トークン版もあります。
その後、技術文書の作成を依頼するか、「rewrite this with simple-english」と言ってください。
動作例
左側は実際の未編集のClaude出力です。右側はスキルをロードした同じモデルの出力です。
スキルなし
スキルあり
Leveraging sqlpipe's robust architecture, users can seamlessly synchronize their Postgres tables to S3 with minimal configuration overhead. Before getting started, you should ensure that your AWS credentials have been properly configured — this is crucial for avoiding frustrating permission issues down the line.
sqlpipeはPostgresテーブルをS3にコピーします。1つの設定ファイルが必要です。
開始する前に、AWS認証情報が正しく設定されていることを確認してください。そうでない場合、S3は権限エラーでアップロードを拒否します。
その他の書き換え例はexamples/before-after.mdにあります:README、runbook、インシデントレポート、エラーメッセージ、リリースノート。
ベンチマーク
以下のすべての数値は、コミットされた生ファイルからpython3 evals/check_numbers.pyによって再計算されており、CIはプッシュごとに実行されます。すべてのClaude実行:claude-sonnet-4-6、低労力、設定なし。ジャッジはClaudeモデルがClaudeテキストに対して行うため、ファミリーバイアスが考えられます。
返信、専門用語を含む8つのチャット質問、2回の実行、生ファイルとテーブル。カウントは16回の返信の合計です。2.0.1はスキルなし(218 → 11)と比較して可視的な欠陥が95%削減されました。これらのカウントは、2.1.0で削除された5文の返信キャップがまだあった2.0.1の2026-09-02実行からのものです。2.1.0以降の実行はまだ存在しません。ブラインドジャッジは16ペア中14ペアで2.0.1を2.0.0よりも好みました。
| 条件 | 単語数 | 文数 | ダッシュ | 太字 | 見出し | 箇条書き |
|---|---|---|---|---|---|---|
| スキルなし | 216 | 16.8 | 62 | 79 | 25 | 52 |
| 2.0.0 | 184 | 14.4 | 43 | 72 | 4 | 52 |
| 2.0.1 | 146 | 7.9 | 5 | 2 | 0 | 4 |
gpt-4.1-miniでは、同じ8つの質問が8回の返信あたり23文、64の太字スパン、101の箇条書きから、2.0.1では5.2文とフォーマットなしになりました。
ドキュメント、STEリンターでスコアリングされた8つのsqlpipeライティングタスク、セルあたりの1回の実行。このモデルでは1回の実行で約0.5変動するため、行はランキングではなく、パリティまたはそれ以上として読んでください。
| 条件 | 違反数/100語 | 削減率 |
|---|---|---|
| スキルなし | 4.09 | |
| 1.3.0 | 2.11 | 48% |
| 2.0.0 | 1.70 | 58% |
| 2.0.1 | 0.91 | 78% |
リンターの履歴:9つのClaudeモデル(144回の生成、RESULTS.md)で81.3%のリンター違反削減、さらにPi、opencode、OpenAIの実行がevals/results/にあります。これらの数値は再現可能です。2026-09-02の監査では、それらが読者の目に映るものではなく、ルールの遵守を測定していることが示されました。そのため、2.0.1は上記の返信数を報告しています。
ルール
SKILL.mdの2つのレジスタ、約1,700トークン。Issue 9の53の番号付きルールは、チェックモードと厳格モードのためにrule-catalog.mdにあります。
返信、すべてのチャット回答:
| ルール | 排除するもの |
|---|---|
| テキストのみ:見出し、箇条書き、太字、表なし | 1行回答の周りのフォーマットの壁 |
| 最初の文で回答 | 前置き |
| ダッシュなし | 分割された半分の思考 |
| 用語を数語で定義 | 読者が調べる必要がある専門用語 |
| 短縮形、開始句、結び句なし | 「素晴らしい質問です!」や「お役に立てば幸いです!」 |
ドキュメント:ドキュメント、README、runbook、エラーメッセージ、リリースノート:
| ルール | 排除するもの |
|---|---|
| 指示あたり最大20語、説明あたり25語 | 長すぎる文 |
| コマンドの前に条件 | 読者が実行するのが遅すぎる「...フラグが設定されている場合」 |
| 単純な時制、能動態 | 「更新されました」、「...を容易にします」 |
| should/would/may/mightなし | 曖昧さ。can, will, mustは残ります |
| 1単語=1意味、ドキュメント全体 | check/verify/confirm/validateのルーレット |
冠詞、thatを残す | 電信スタイル。STEは短いが、簡潔ではない |
| 太字のリードインなし、2文以上の見出しなし | 事実を隠す装飾 |
| 重要性ではなく事実を述べる | 「極めて重要」、「堅牢」、「Xだけでなく、Yである」 |
2つのモード。デフォルトのPlainは上記すべてです。Strictは、STE、ASD-STE100、またはコンプライアンスと名前を付けたときにstrict-vocabulary.mdからのSTE辞書規律を追加します。返信はどのモードでもPlainのままです。
FAQ
これにより出力はSTE認定されますか? いいえ。ASDはいかなるツールも認定しないため、何も認定されません。Strictモードはそれに近いです。単語レベルの規則は公式標準にあり、無料ダウンロードできます。
私のドキュメントはロボットのように聞こえますか? Airbusのマニュアルのように聞こえます:平坦で誤読不可能です。ドキュメントにとってはそれがすべてです。ブログではあなたの声を使ってください。
なぜ単に「明確に書け」とプロンプトしないのですか? 「明確」は意見です。「文を20語以内に収める」は仕様です。エージェントは仕様に従います。
なぜ40年前の航空宇宙標準なのですか? それは維持(Issue 9、2025年1月)、番号付け、テスト可能です。また、AIのライティングの癖のほぼ完全な否定形でもあります。
どのように構築されましたか? 要約ではなく、主要なIssue 9のテキストに対して行われました。コミュニティ監査(#4)で語彙テーブルを辞書に対してチェックしました。シナリオと記録された結果:evals/pressure-tests.md。
スター履歴
単語選択リンター
evals/ste_lint.pyは機械的なルールを測定し、単語の選択は見ることができません。tools/ste-dictionary/には、無料のIssue 9 PDFのコピーから単語リストを構築する抽出ツールが含まれています。リンターがそれを読み取ります。リポジトリはツールを提供しますが、辞書コンテンツは提供しません。なぜなら、標準ではASDからの書面による許可なしの複製が禁止されているからです。
貢献
質問やバグレポートについては、イシューを開いてください。プルリクエストは歓迎します。公開された数値を変更する変更は、生ファイルを一緒に提供し、python3 evals/check_numbers.pyがパスする必要があります。プッシュする前にpython3 evals/ste_lint.py --self-testを実行してください。PRでは、コードがエージェントによって書かれたかどうかを述べ、属性トレーラーを追加しないでください。
ライセンス
ここにあるすべてはMITライセンスです。リポジトリは、教育目的でルールを言い換え、仕様テキストや辞書コンテンツを複製しません。非公式プロジェクトであり、ASDまたはSTEMGと提携または承認されていません。ASD-STE100はASDの登録商標です。