ste100-writer について
ASD-STE100 Simplified Technical English の技術文書を書くためのスキルです。制御言語の規則に沿った執筆と確認を案内し、ASD の辞書全文は含まないことも示します。
主な機能
- 01STE の執筆規則を適用
- 02文章の種類を判定
- 03語句選択の例を提示
- 04チェックリストで草稿を確認
- 05辞書での確認事項を提示
活用シーン
- 01技術的な指示を STE で書き換え
- 02説明的な技術文書を作成
- 03STE 規則に沿って草稿を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/ste100-writerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/checklist.mdrules.mdword-choices.md詳細
ASD-STE100 Writer
このスキルでできること
このスキルは、ASD-STE100 簡略技術英語（STE）で技術文書を書くのに役立ちます。STE は統制言語です。英語を母語としない人にも、技術文書を読みやすくします。また、機械翻訳の精度も高めます。
STE は、次の 2 つで構成されます。
- 一連の文章作成規則。
- 使用が認められた単語の辞書。
辞書に関する法的制限
ASD は、ASD-STE100 仕様書および辞書全文の著作権を所有しています。このスキルには辞書全文は含まれていません。文章作成規則と、単語の選択例を少数のみ含んでいます。仕様書全文は https://asd-ste100.org から無料で入手できます。
単語が使用を認められているかどうか確信がない場合は、次のいずれかを行ってください。
references/word-choices.mdに記載された単語を使います。- 公式辞書で確認が必要な単語であることをユーザーに伝えます。
単語が使用を認められているという主張をでっち上げてはいけません。
手順
- 原文を読みます。テキストの種類を特定します。手順文は指示を示し、説明文はデータを示します。
references/rules.mdを読みます。すべての規則に従います。- 新しいテキストを書きます。
references/checklist.mdを使って確認します。- ユーザーから変更内容を表示するよう指示された場合は、原文と新しいテキストの 2 列からなる表を作成します。
基本規則（簡易版）
規則の全一覧については、references/rules.md を読んでください。
- 短い文を書きます。手順文は最大 20 語、説明文は最大 25 語にします。
- 1 文につき指示は 1 つにします。1 つの手順に 2 つの操作がある場合は、2 文または 2 つの手順に分けます。
- 指示には命令形を使います。例：「ボルトを取り外します。」
- 能動態を使います。説明文では、能動態が使えない場合に限り、受動態を使います。
- 単語は、認められた意味で使います。1 つの単語には 1 つの意味を持たせます。
- 1 つのものには 1 つの単語を使います。同義語は使いません。
- 可能な限り冠詞（「a」「an」「the」）を使います。
- 動名詞（「-ing」で終わる語）を名詞または形容詞として使ってはいけません。技術用語は例外です。
- 名詞句に含める名詞は最大 3 つにします。
- 説明文の段落は最大 6 文にします。
- 該当する手順の前に、警告または注意を記載します。
- 警告または注意は、命令または明確な条件から始めます。
- スラッシュ（「/」）は使いません。ただし、「and/or」は使用できます。
- 現在形、過去形、未来形の単純な時制を使います。
- テキストを短くするために単語を削除してはいけません。明確な文章を保ちます。
- em ダッシュは使いません。
警告と注意
負傷または死亡のリスクがある場合は警告を記載します。機器が損傷するリスクがある場合は注意を記載します。まず条件を示し、次に命令を記載します。
警告の例：
WARNING: THE FUEL IS FLAMMABLE. KEEP FLAMES AND SPARKS AWAY FROM THE WORK AREA. FUEL FIRES CAN CAUSE INJURY OR DEATH.
よくある変更
| 使用しない語 | 使用する語 |
|---|---|
| commence, initiate | start |
| terminate | stop, end |
| utilize | use |
| in order to | to |
| prior to | before |
| subsequent to | after |
| in the event that | if |
| is capable of | can |
| attempt | try |
| assist | help |
| approximately | about |
| sufficient | enough |
| require | need |
| indicate | show |
| ascertain | find, make sure |
その他の例については、references/word-choices.md を読んでください。
品質チェック
ユーザーにテキストを渡す前に、次の項目を確認してください。
- 各文の単語数を数えてください。
- 受動態の動詞をすべて見つけてください。可能であれば能動態に変更してください。
- 「-ing」で終わる単語をすべて見つけてください。ルールで許可されていない場合は変更してください。
- 「使用禁止」表にある単語をすべて見つけてください。
- テキスト全体で各用語が統一されていることを確認してください。
- 技術データが変更されていないことを確認してください。
ルールに従うために、技術的な内容を変更しないでください。ルールと技術的な正確性が矛盾する場合は、ユーザーに伝えてください。