STE80 Humanizer の機能
STE80 Humanizer は、AI が生成した文章を書き直し、丁寧に書かれた人間の文章のようにする AI エージェント用スキルです。原文の意味を変えずに、明瞭さを高めることを目的としています。AI 検出器の回避は目的としていません。
このプロジェクトは、2 つの編集方法を組み合わせています。
- Humanizer パス: blader/humanizer のカタログと Wikipedia の Signs of AI writing に基づき、AI による文章に見られる 26 の一般的な特徴を取り除きます。
- STE80 パス: 航空宇宙分野の整備文書で使われる管理英語、ASD-STE100 に向けて、文章を約 80% の度合いで再構成します。
最初のパスでは、チャットボット特有の表現、誇張された主張、不要な限定語、装飾的な書式、曖昧な権威付け、繰り返される修辞パターンなどを取り除きます。2 つ目のパスでは、短い文、能動態、平易な単語、1 文 1 主題を使って、文の構造そのものを修正します。
2 つのパスを使う理由
明らかな AI 表現を取り除くだけでは不十分です。良い質問です や シームレスな体験 などの表現を削除しても、読みにくさが残ることがあります。複数の考えが 1 つの文に含まれたり、行為者が隠れていたり、説明の中に指示が埋もれていたりする場合もあります。
そのため STE80 Humanizer は、まず表現を整理し、次に文章を再構成します。たとえば、次のような文を考えてみます。
アプリケーションを利用可能な状態に保つため、コンテナは kubelet によって自動的に再起動されます。
2 つ目のパスでは、考えを分けて能動態を使います。
プローブに失敗した場合、kubelet はコンテナを再起動します。これにより、アプリケーションは利用可能な状態に保たれます。
この方法により、正式な簡略テクニカル英語のすべての制限を通常の文章に強制することなく、直接的な出力を保てます。
STE80 のアプローチを理解する
ASD-STE100 は、読者が技術情報を正しく理解する必要がある場合のために作られました。その構成は、短い文、単純な動詞形式、能動態、一貫した用語、明確に分けられた手順を重視します。
厳密な ASD-STE100 では、語彙も制限されます。STE80 Humanizer は、デフォルトではこの部分を緩和しています。自然で一般的な単語を維持しながら、読みやすさを高める構造上のルールを適用します。
- 1 文につき 1 つの主な考えだけを述べます。
- 能動態と単純な時制を優先します。
If X, do Y.のように、条件を先に置きます。- 指示と説明を分けます。
- 手順や複雑な情報にはリストを使います。
- 1 つの対象には 1 つの用語を使います。
- 長い名詞の連結、セミコロン、複雑な句読点を避けます。
- 段落の主題を 1 つに絞ります。
デフォルトの 80% レベルでは、より自然に聞こえる場合、文が推奨長を数語超えることがあります。check や test などの一般的な動詞は引き続き使用でき、実際の不確実性には may や should も使えます。
STE80 Humanizer のインストール
skills CLI でインストールする
Vercel の skills CLI は、Claude Code、Codex、Cursor、OpenCode などのエージェントに対応しています。スキルを使用するプロジェクトで、次のコマンドを実行します。
npx skills add Dodaios/ste80-humanizer--global を付けない場合、コマンドは現在のプロジェクトだけにスキルをインストールします。
特定のエージェント向けにグローバルインストールするには、次のいずれかのコマンドを使用します。
npx skills add Dodaios/ste80-humanizer --global --agent claude-code
npx skills add Dodaios/ste80-humanizer --global --agent codex
npx skills add Dodaios/ste80-humanizer --global --agent cursor対応するすべてのエージェントで使用できるようにするには、次を実行します。
npx skills add Dodaios/ste80-humanizer --global --agent '*'Claude Code プラグインとしてインストールする
リポジトリのマーケットプレイスを追加してから、プラグインをインストールします。
/plugin marketplace add Dodaios/ste80-humanizer
/plugin install ste80-humanizer@ste80-humanizerClaude.ai または Claude Desktop にインストールする
- GitHub リポジトリを開き、Code を選択します。
- リポジトリを ZIP ファイルとしてダウンロードします。
- Settings、Capabilities、Skills の順に開きます。
- ZIP ファイルをアップロードします。
最初の書き直しを実行する
インストール後、スキルを呼び出し、コマンドの下に文章を貼り付けます。
/ste80-humanizer
書き直す文章をここに貼り付けます。エージェントに文章のヒューマナイズ、簡略化、AI らしさの除去、または STE スタイルでの書き直しを依頼すると、スキルを自動的に開始することもできます。
標準的な書き直しには、次を試してください。
This sounds like ChatGPT wrote it. Make it sound like a person.技術的な説明には、次のように依頼します。
Explain how TLS handshakes work in STE.ファイルを指定することもできます。
Rewrite this README 80% of the way to ASD-STE100.
Light touch: just remove the AI stuff from docs/intro.md.
Convert docs/runbook.md to strict STE.スキルは、文章を編集せずに評価することもできます。その要件を直接指定します。
Does this email sound like AI? Just tell me, don't rewrite it.適切な編集モードを選ぶ
Humanize モード
Humanize は、通常の依頼で使われるデフォルトモードです。26 の AI 特徴チェックをすべて適用した後、緩和された 80% レベルで構造上のパスを適用します。このモードは、文章を読みやすくしながら、書き手の文体を維持することを目的としています。
ライトモード
ライトモードは、原文がすでに機能していて、少し整えるだけでよい場合に便利です。軽く手を入れて、またはAIらしい部分だけ削除してと依頼します。このスキルは最初のパスを適用し、最も問題のある文だけを再構成します。
厳格なSTEモード
厳格なSTEは、構造に対する完全なパスを100%適用します。一貫性が会話調より重要な手順書、ランブック、安全上の注意事項を対象としています。
厳格モードでは、文の長さと語彙の選択に関する制約が強くなります。短縮形も使用しません。ただし、この形式で出力しても、公式のASD-STE100標準に自動的に準拠するわけではありません。
番号付きルールが編集のレビューに役立つ仕組み
プロジェクトのSKILL.mdファイルには、番号付きのルールセットが2つあります。§1から§26までのルールは、AIが書いたように見える特徴を扱います。S1からS15までのルールは、STE80の構造を扱います。
このスキルは、§1, §8, S2のような参照付きで編集内容を報告できます。その後、なぜ「XではなくY」という構文を削除したのか、繰り返し使われるダッシュを置き換えたのか、文を短くしたのかを確認できます。
一部のパターンには単独では弱いという印が付いています。これには、繰り返される書き出し、修飾語の積み重ね、ハイフンで結ばれた語の組み合わせ、一部の受動態が含まれます。スキルは、周辺の証拠が編集を裏付ける場合にだけ、それらを問題として扱います。
意味と文体を維持する
忠実性は、このワークフローの中核です。このスキルは、事実と不確実性を維持するよう設計されています。mayをmayのまま残し、40+のような値を保持し、裏付けのない主張を追加せず、原文の矛盾を指摘します。
自分の文体に合わせるには、依頼に自分の文章サンプルを含めます。
Rewrite the draft with STE80 Humanizer. Match the sentence length, vocabulary, and punctuation in this sample of my writing:
Paste your writing sample here.
Draft:
Paste the draft here.これにより、曖昧な「人間らしい文章」のイメージをまねさせるのではなく、好みのリズムに関する具体的な根拠をスキルに与えられます。
Pythonリンターでファイルを確認する
リポジトリには、依存関係のないPythonリンターscripts/ste_check.pyが含まれています。次のコマンドでファイルを確認できます。
python scripts/ste_check.py README.md手順書またはランブックには、厳格なチェックを使用します。
python scripts/ste_check.py --strict docs/runbook.md標準入力からテキストを渡すこともできます。
cat draft.txt | python scripts/ste_check.py -チェッカーは、両方のパスに含まれる測定可能なパターンの多くを検出します。対象には、チャットボット的な表現、段階的な導入、ヘッジ表現の積み重ね、曖昧な権威付け、誇張された主張、カールした引用符、長い文、長い段落、セミコロン、ダッシュ、受動態、進行形または完了形、-ing形、句動詞が含まれます。
このチェッカーはヒューリスティックです。AI検出器でも、公式のASD-STE100準拠チェッカーでも、テキストが正しいことの証明でもありません。
高度なワークフローのヒント
対象読者と文書の種類を明示する
README、メール、説明、ランブック、安全上の注意事項、ソーシャルメディアへの投稿のどれを編集するのかをスキルに伝えます。文書の種類によって、役立つ構造の量は変わります。厳格なSTEは手順に適していますが、通常、くだけた投稿にはより軽いパスが必要です。
変更してはいけないものを指定する
変更してはいけない正確な事実、数値、製品名、法助動詞、引用を列挙します。これにより、プロジェクトの忠実性を優先する動作が強化されます。
報告されたルール番号を確認する
編集によって文体が変わりすぎた場合は、引用されたルールを確認します。必要な明確化だけを残し、元の文体を戻すようエージェントに依頼します。
手動編集後にチェッカーを実行する
有用なワークフローは、書き換えを生成し、自分で編集してからste_check.pyを実行することです。各警告は、自動的なエラーではなく、レビューのきっかけとして扱います。
創作には適切なパスを使用する
STEの構造は、明確な説明文を対象に設計されています。フィクション、スピーチ、ブランドコピーには、プロジェクトは最初のパスだけを適用します。これにより、文体、リズム、または意図的な曖昧さに支えられた文章が平板になるのを防ぎます。
言語上の制限を考慮する
ASD-STE100は英語の標準です。他の言語では、このスキルは一般的な特徴の除去と構造上の原則を適用できますが、英語の語彙リストを直接適用することはできません。
含まれている評価を実行する
evals/ディレクトリには、Claudeプラグイン評価形式のケースが4つ含まれています。READMEの書き換え、オリジナルの説明、厳格なランブック、STEに言及しないカジュアルなLinkedIn投稿です。
次のコマンドで実行します。
claude plugin eval . --allow-tools Write,Edit,Bashリポジトリでは、これらのテストを証明ではなく、小さな指標として説明しています。テストしたケースで主に報告された利点は忠実性でした。このスキルは、通常のプロンプトよりも確実に事実、数量、不確実性を維持しました。
重要な制限
- このスキルは、主に説明文と技術文書を対象としています。
- 英語以外の言語には、英語のSTE語彙リストを使用できません。
- STEに似た文体で書いても、文書が公式にSTE準拠になるわけではありません。
- 公式準拠には、ASD-STE100辞書、訓練を受けた執筆者、レビューが必要です。
- このプロジェクトには、公式のASD-STE100仕様書または辞書は含まれていません。
結論
STE80 Humanizerは、表面的なクリーンアップと構造的な編集を組み合わせます。エージェントスキルまたはClaude Codeプラグインとしてインストールし、Humanize、Light、Strict STEのいずれかのモードを選択して、忠実性に関する要件を明確に指定してください。ファイルベースのワークフローでは、付属のPythonチェッカーを使って、引き続き確認が必要なパターンを見つけられます。結果として、元の内容の事実と意図を保ちながら、より明確な文章に仕上げます。