Agent Skill to Force Docs in ASD-STE100 Simplified Technical English

あなたのAIはLinkedInの投稿のように書きます。ボーイングのマニュアルのように書かせましょう。LLMにASD-STE100簡易技術英語で文書を書かせるエージェントスキルです。これは航空宇宙産業が1983年から使用している、疲れた整備士が指示を誤読できないようにするための統制言語です。AIのくだらない文章は副次的に死にます。💀 これを見る · インストール · ルール · 文書だけではない · 受領書 · FAQ Agent Skills標準に対応しているすべてのハーネスで動作します: Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode、その他約25種類。1つのフォルダ、依存関係なし、MITライセンス。🔥 変更前 / 変更後 左列は実際の編集されていないClaudeの出力です。右列は同じモデルにスキルをロードした結果です。🤖 スキルなし ✈️ スキルあり sqlpipeの堅牢なアーキテクチャを活用することで、ユーザーは最小限の設定オーバーヘッドでPostgresテーブルをS3にシームレスに同期できます。開始する前に、AWS認証情報が正しく設定されていることを確認してください。これは、後でフラストレーションのたまる権限の問題を回避するために非常に重要です。 sqlpipeはPostgresテーブルをS3にコピーします。設定ファイルが1つ必要です。開始する前に、AWS認証情報が正しいことを確認してください。正しくない場合、S3は権限エラーでアップロードを拒否します。 おっと！接続の確立中に問題が発生しました。認証情報が正しく設定されていることを確認してから再試行してください。問題が続く場合は、管理者に連絡してください。 データベースへの接続に失敗しました: ユーザーappのパスワードが正しくありません。DB_PASSWORDを正しい値に設定してから、再度接続してください。 一部のユーザーのサービスアクセス能力に影響を与えた可能性のある問題を確認しました。ご迷惑をおかけしたことを深くお詫び申し上げます。UTC 14:02から14:31の間、12%のリクエストが失敗しました。14:00のデプロイでキャッシュウォームアップステップが削除されました。14:27に元に戻しました。 ┌──測定値: 6 Claudeモデル × 8タスク × 2条件、96回の実行──┐ │ 100語あたりのSTE違反数 ▼ 72.9% (全モデルで達成) │ │ 出力トークン数 ▼ 全6モデルで減少 │ │ 平均文長 11.2 → 9.7語 │ │ "seamlessly" は0回生存 │ └─────────────────────────────────────────────────────────────────┘ examples/before-after.md でさらに多くの書き換えを確認できます: README、エラーメッセージ、インシデントレポート、リリースノート。 📦 インストール npx skills add AminBlg/SimpleEnglish これで完了です。skills CLIは、お使いのエージェント（Claude Code, Cursor, Codex, Copilot, Gemini CLIなど）を検出し、選択したものにインストールします。 インストール前に試す: npx skills use AminBlg/SimpleEnglish@simple-english SKILL.md のサポートは全くないのですか？ prompts/system-prompt.md をシステムプロンプト、AGENTS.md、または .cursorrules に貼り付けてください。タイトな予算のために約60トークンのバージョンもあります。その後、技術文書を依頼するか、「simple-englishで書き直して」と言ってください。 🖱️ ターミナルがない場合 (claude.ai, ChatGPT, Gemini) Claude.ai (有料プラン) はネイティブでスキルをサポートしています: スキルファイルをダウンロード: SKILL.md を開き保存します (Ctrl+S / Cmd+S)。claude.ai で、Settings → Capabilities に移動し、コード実行をオンにします。Settings → Customize → Skills → Upload に移動し、保存した SKILL.md をアップロードします。スキルをオンにします。完了です。技術文書を依頼すると、Claudeがそれを適用します。 ChatGPT: スキルサポートがないため、プロンプトバージョンを使用してください。prompts/system-prompt.md のブロックを Settings → Personalization → Custom Instructions、または Project や Custom GPT の指示にコピーしてください。 Gemini: Gem を作成し、同じブロックをその指示に貼り付けてください。 その他のチャットボット: prompts/system-prompt.md をチャットに添付または貼り付け、「私へのすべての書き込みに適用してください」と言ってください。 📏 ルール 53の番号付きルール、9つのセクション、1983年に、曖昧な文章で読者が死ぬような人々によって書かれました。最も重要なルール: ルール | それを排除するもの 💀 ---|--- 命令ごとに最大20語、説明ごとに25語 | 長すぎる文 1単語 = 1意味、文書全体チェック/検証/確認/承認ルーレット | 複数の意味を持つ単語 単純な時制のみ | "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つの命令 | 夜中の2時に誰も従えないステップ 冠詞を維持、"that" を維持 | 略語 電報スタイル。STEは短く、簡潔ではない | 長すぎる文章 ソフトウェア例を含む完全な言い換えセット: SKILL.md。はい、このREADMEはこれらのルールの半分を破っています。マーケティングはSTEの範囲外であることが明示されています。スキルはそれを知っており、文書内に留まります。😌 🧰 文書だけではない スキルは以下のための適応（use-cases.md）を提供します: 🚨 エラーメッセージ: 何が起こったか → なぜ → どうするか、この順序で 📟 ランブック: STEのホームグラウンド; ランブックはメンテナンスマニュアルです 🧯 インシデントレポート: 単純な過去の失敗 "we have identified an issue that may have impacted" 📣 リリースノート: 警告としての破壊的変更: コマンドが先、リスクが後 🤖 あなたのAGENTS.md / プロンプト: システムプロンプトは質問できない読者のための手順です。モデルは "should" をオプションとして読みます。STEは "should" を禁止します。考えてみてください。 🌍 翻訳準備: STEの元の仕事: 非ネイティブでも読める、ローカライズが安い どこに行かないか: マーケティングコピー、ブログのトーン、ブランドライティング。意図的にフラットに。 ✋ 📊 ベンチマーク スキル使用時、100語あたりのSTE違反数が72.9%減少しました。これは6モデル×8つのライティングタスク（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% 出力トークン数も6モデルすべてで減少しました（スキルはより短く書きます）。決定論的な正規表現リンター、両条件で同じルール、正直な注意リストと完全な方法はevals/results/RESULTS.mdにあります。python3 evals/run_bench.py で再現できます — ログインしたClaude Code CLIのみが必要です。 🧾 受領書 プライマリIssue 9テキスト（2025年）に対してTDDスタイルで構築されました。ブログの要約ではありません: スキルなしのベースラインエージェントは40語の文を書き、ルール番号をでっち上げました。1つは自信を持って「Rule 3.1: short sentences」（実際のRule 3.1は動詞形です💀）を引用しました。 オンラインの二次情報源は、モーダル（canとwill）について間違っています: canとwillは承認されています。PDFを確認しました。スキルは、記録されたすべてのベースラインの失敗を解消するために書かれ、エージェントが合格するまで再テストされました。シナリオ + 記録された結果: evals/pressure-tests.md ❓ FAQ これにより出力はSTE認定されますか？いいえ。ASDはどのツールも認定しないため、何も認定されません。デフォルトモードは実用的です: 構造的なルール + あなたのドメイン語彙。厳密モードはそれに近づきます。単語レベルの裁定は公式標準にあり、無料ダウンロードできます。 私の文書はロボットのように聞こえますか？エアバスのマニュアルのように聞こえます: フラットで誤読不可能です。文書にとってはそれがすべてです。ブログにはあなたの声を使っています。 ✍️ なぜ単に「明確に書け」とプロンプトしないのですか？ 「明確」は意見です。「文長20語以下」は仕様です。エージェントは仕様に従います。 📐 なぜ40年前の航空宇宙標準なのですか？ それはヴァイブスではないからです。それは維持され（Issue 9、2025年1月）、番号が付けられ、テスト可能です。そして、それはAIライティングのすべての兆候のほぼ完璧な否定形です。 ⚖️ ライセンスとステータス すべてMITライセンスです。リポジトリはルールを教育目的で言い換えており、仕様テキストや辞書コンテンツは一切複製していません。非公式プロジェクトであり、ASDまたはSTEMGと提携または承認されていません。ASD-STE100はASDの登録商標です。