
2026/07/31 4:34
ASD-STE100 シンプル英語でドキュメント強制を行うエージェントスキル
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
AminBlg/SimpleEnglish スキルは、LLM に ASD-STE100 シンプルテクニカル英語規格を適用し、航空宇宙業界で 1983 年以来開発されてきた制御された言語を用いて技術ドキュメントの曖昧さを排除することを強制します。本スキルは Cursor、VS Code Copilot、Claude Code、Gemini CLI を含む各種 AI ハーネスと互換性があり、npx skills add AminBlg/SimpleEnglish を使用してインストールするか、ターミナルサポートがない環境では特定のプロンプトファイルを介して直接適用できます。本規格は、指示あたりの最大 20 語(1 語=1 つの意味)、単数形時制、能動 voice、"might" や "should" などの保留語を除外することといった厳格な制約を強制します。6 つのモデルを対象としたベンチマークでは、このスキルを適用することでベースラインエージェントとの比較において規則違反が 72.9% 減少し、出力トークンも減少することが示されました(ベースラインエージェントは本来、架空の規則番号を発明したり、過度に長い文を書く傾向があります)。本スキルはエラーメッセージ、インシデント報告書、リリースノートに対して特化された適応版を提供しますが、マーケティングコピーやブログ記事の作成はその範囲から明確に除外されています。非公式に開発され MIT ライセンスの下で提供されている本プロジェクトは、特定の技術的問題に対する TDD(テスト駆動開発)手法を用いてその有効性を評価し、教育資料において固有の仕様テキストを複製することはありません。本文
ASI: 航空宇宙標準英語(ASD-STE)エージェントスキル
📌 概要
ASI (ASD-STE) は、航空宇宙業界の技術マニュアルに基づいた文体を強制するエージェントスキルです。1983 年以来、整備士の誤読を防ぐために採用された管理言語であり、AI が生成する低品質な出力(「AI スラップ」)を自然に排除します。
✨ 対応環境
このスキルは「エージェントスキル標準」を採用する全ての開発環境に対応しています。
- 対応ツール: Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode など(25 以上のツール対応)
- 構成要件: 単一のフォルダ構成で、外部依存ライブラリ不要
- ライセンス: MIT ライセンス
🔥 ベフォー・アフター比較
左側:スキル未使用時の出力 | 右側:ASI を適用した後の出力
| カテゴリ | ❌ スキル未使用時 | ✅ ASI 適用後 |
|---|---|---|
| 機能説明 | の堅牢なアーキテクチャを活用することで、Postgres テーブルを S3 にシームレスに同期でき...設定のオーバーヘッドは最小限で済みます。着手前に、AWS 認証情報の正しく設定されていることを確認してください... | sqlpipe は Postgres テーブルを S3 にコピーします。 必要なのは単一の設定ファイルだけです。開始前に、AWS 認証情報が正しいか確認してください。もし正しくない場合、S3 側ではアップロード拒否(権限エラー)を起こします。 |
| エラーメッセージ | Oops!接続確立中にエラーが発生しました。認証情報が正しく設定されていることを確認して再度お試しください... | データベースへの接続に失敗しました: ユーザー「app」のパスワードが正しくありませんでした。DB_PASSWORD を正しい値に設定してから再度接続してください。 |
| インシデントレポート | 利用者にサービスのアクセスを阻害した可能性がある問題を特定しました。ご不便をおかけし心よりお詫び申し上げます... | UTC 14:02 から 14:31 の間、要求の約 12% が失敗しました。 14:00 にキャッシュウォームアップステップが削除されたデプロイが発生し、14:27 にロールバックを行いました。 |
💡 詳細: 対象は README、エラーメッセージ、インシデントレポート、リリースノートなど多岐にわたります(
を参照)。examples/before-after.md
📦 インストール手順
1. CLI を使用する場合
以下のコマンドを実行してください。
npx skills add AminBlg/SimpleEnglish
動作:
はエージェント(Claude Code、Cursor など)を検出し、選択した対象のみインストールします。skills CLI- お試し運用: インストール前に
で試せます。npx skills use AminBlg/SimpleEnglish@simple-english
2. プロンプトファイルによる適用
SKILL.md のサポートがない場合は、以下のファイルをシステムプロンプトに貼り付けてください。
- 推奨場所:
prompts/system-prompt.md.cursorrulesAGENTS.md
- 短縮版: 予算を抑えたい場合は、約60 トークン程度の短縮版もあります。指示に「simple-english(簡略化英語)で再作成してください」と含めるだけで十分です。
3. ターミナルがない場合(Web クライアント)
| プラットフォーム | 設定手順 |
|---|---|
| Claude.ai (有料プラン) | 1. SKILL.md をダウンロード・保存 2. 「設定」→「機能」でコード実行をオン 3. 「設定」→「カスタマイズ」→「スキル」でファイルをアップロード 4. トグルをオン(自動適用) |
| ChatGPT | 1. プロンプト版を使用 2. を「設定」→「パーソナライゼーション」→「カスタム指示」に貼り付け3. または、プロジェクト/カスタム GPT の指示欄に貼り付け |
| Gemini | 1. Gem を作成 2. プロンプトをその指示欄に貼り付け |
| その他チャットボット | を添付・貼り付け、「これを書くすべてのテキストに応用してください」と指示 |
📏 規則の概要
ASI は、1983 年に記述された53 の番号付き規則と9 のセクションで構成されています。読者が文脈の曖昧さに苦しむことを防止する目的です。
主要な規制ルール
| 項目 | 規則内容 / 排除対象 🪦 |
|---|---|
| 指示文 | 20 語以内に制限(複雑な複文禁止) |
| 単語の意味 | 1 つの単語 = 1 つの意味(check/verify/confirm/validate の曖昧な同義語使用禁止) |
| 時制 | 単数形のみ使用("has been updated" → "we updated") |
| 動詞形式 | "ing"動詞の禁止(分節文 ", making it easy to..." 禁止) |
| 能動態 | 能動態のみ採用(受動態・間接表現 "it should be noted that" 禁止) |
| 助動詞 | should/would/may/might の禁止(推量排除。can, will, must は許容) |
| 条件文 | コマンド前の条件提示を禁止("...if the flag is set" の型は排除) |
| 1 文の指示 | 1 文に 1 つの指示のみ(手順を追えない文章防止) |
| 冠詞 | "That" は保持(テレグラフスタイル。短くても簡潔・terse ではない) |
📝 補足: 完全なパラフレーズ済み規則集は
を参照してください。マーケティングコンテンツは STE の対象外です。SKILL.md
🧰 文書以外への適用
本スキルには以下のユースケース向けのアダプテーションが含まれています。
- 🚨 エラーメッセージ: 何が起こったのか → なぜ起きたのか → どう対処すべきか(この順序で記述)
- 📟 ランブック: メンテナンスマニュアルそのものとして最適化されます。
- 🧯 インシデントレポート: 過去形により、「we have identified...」といった曖昧な表現を排除します。
- 📣 リリースノート: 破壊的な変更を警告として提示し、リスク説明をコマンド後に追加する構成へ。
- 🤖 システムプロンプト: 「should(〜すべき)」は任意と解釈されるため禁止します。「手順書」であることを明確にします。
- 🌍 翻訳の準備: 非母語話者に読みやすく、ローカライズコストを低減します。
❌ 適用しない分野: マーケティングコピー、ブログ調、ブランディング文章(平坦な文体は意図的ではありません)。
📊 ベンチマークデータ
測定条件: 6 つの Claude モデル × 8 つのタスク × 2 つの状態(計 96 回の実行)
| モデル | ベースライン違反数 (100 ワードあたり) | スキル適用後違反数 (100 ワードあたり) | 削減率 |
|---|---|---|---|
| claude-opus-4-8 | 1.05 | 0.62 | 41% |
| claude-opus-4-7 | 2.28 | 0.42 | 82% |
| claude-opus-4-6 | 2.24 | 0.40 | 82% |
| claude-opus-4-5 | 2.55 | 0.57 | 78% |
| claude-sonnet-5 | 2.67 | 0.53 | 80% |
| claude-sonnet-4-6 | 2.06 | 0.52 | 75% |
効果のまとめ
- ✅ STE 違反件数: 100 トークン当たり平均で 72.9% の削減(すべてのモデルで達成)
- ⬇️ 出力トークン総量: すべてのモデルで低下(記述が短くなるため)
- 📉 平均文の長さ: 11.2 語 → 9.7 語
検証方法
決定論的な正則表現によるリンター(lint)を用いて両状態に同一の規則を適用しています。詳細な方法は
evals/results/RESULTS.md に記載されています。
再現コマンド:
python3 evals/run_bench.py
※ ログインした Claude Code CLI で実行可能です。
🧾 検証データ(Receipts)
TDD(テスト駆動開発)スタイルで構築されており、ベースラインとなる Issue 9 の原文(2025 年版)に基づいています。
- スキルの目的: エージェントの失敗を解消し、パスするまで再テストを行うことで検証。
- 典型的なエラー例:
- 長文(40 語以上)の生成
- 架空の規則番号の発明
- 実際のルールとの不一致(例: 「Rule 3.1: short sentences」と主張しながら、実際には動詞形式に関する規定だったケース)
シナリオと記録結果は
evals/pressure-tests.md を参照してください。
❓ よくある質問 (FAQ)
Q: これは出力を STE 認証付きにしますか? A: いいえ。ツールを検証して認証する機関は存在しません。デフォルトモードは実用的で、構造規則+ドメイン固有語彙を採用しています。厳格モードでもほぼ同様の成果を得られます。
Q: 文書は機械的になりませんか? A: 否。Airbus マニュアルのような平らで誤読不可能な文体になります。技術文書の本質です。ブログ用には独自の口調を保ってください。
Q: 「明確に書いて」とプロンプトするだけではダメですか? A: 「明確に」は主観的な意見です。「文 20 語以内」というのは仕様(spec)です。エージェントは仕様に従います。📐
Q: なぜ 40 年先の航空宇宙標準を使っているのですか? A: それは感情論ではなく、維持管理されており(Issue 9, 2025 年 1 月)、番号付きで検証可能なものだからです。また、あらゆる AI の記述傾向とほぼ逆の性質を持っています。
⚖️ ライセンスと現状
- ライセンス: MIT ライセンス(全プロジェクト)
- 包含内容: レポジトリには規則のパラフレーズ版を含みますが、仕様テキストや辞書内容の複製は行っていません。
- 公式関係: 非公式なプロジェクトです。ASD や STEMG との関係性は推奨されるものではありません。
- 商標注意: ASD-STE100 は ASD の登録商標です。