このプロジェクトについて

avoid-ai-writingは、AIエージェント向けの可搬性のあるライティングスキルで、散文を監査・書き換えして、しばしば「AIらしさ」と呼ばれる一般的なAI文章パターンを除去します。これは、Claude Code、OpenClaw、Hermes、Cursor、OpenAI Codexなど、agentskills.io互換ツールで動作するように設計されており、ChatGPTとCodex用のプラグインとしてもパッケージ化されています。 このスキルは3つのモードで動作します。デフォルトの書き換えモードは、AIパターンにフラグを立て、最大2回の編集パスを適用し、可能な場合は結果を検証し、単一の最終版を返します。検出モードは、書き換えずにパターンにフラグを立て、明確な問題と判断を要するケースを分離します。これは、パターンが意図的である可能性がある場合や、変更すべきでないコンテンツを監査する場合に役立ちます。編集モードは、散文ファイルに対して最小限の的を絞ったインプレース変更を行い、すでに人間らしく読める箇所は保持します。散文の書き換えは構造化コンテンツを破壊する可能性があるため、ソースコード、設定、生成データは拒否します。 重要な設計上の選択は、2パス編集制限であり、--iterate 1または--iterate 2で設定できます。最初のパスで書き換え、2番目のパスで生き残ったパターンを捕捉したり、保存の問題を修復したりして、正当なスコープ内の編集が残っていない場合は早期に停止します。このスキルは、使用したパス数と、意図的、保護、または未解決の所見を報告します。オプションの音声プロファイル(カジュアル、プロフェッショナル、テクニカル、ウォーム、率直)は、オーディエンスコンテキストプロファイルとは別に、散文の聞こえ方を制御します。 リポジトリには、かなりのパターンカタログが含まれています。74のパターンカテゴリを前後の例とともに文書化しており、重要性の誇張や曖昧な帰属などのコンテンツパターン、コピュラ回避や同義語サイクリングなどの言語パターン、フォーマットや遷移フレーズなどの構造パターン、チャットボットのアーティファクトやお世辞のトーンなどのコミュニケーションパターン、リズムの均一性や過度な研磨などのメタパターンをカバーしています。その後の追加では、構造検出、未入力のプレースホルダーやチャットボットの引用マークアップなどのAIツールの指紋、会話調の特徴、シェア投稿のフレーミング、語られる率直さ、不要なハイフネーションをカバーしています。112エントリの単語置換テーブルは3つの層に及び、Tier 1は頻度マーカーと明確さの編集に分割されているため、冗長性の修正が文書をAI分類に押しやることはありません。 バンドルされた決定論的検出エンジンは、機械的な検証を提供します。53のタイプカテゴリを実装しており、語彙層を分割し、句読点分布、機能語エントロピー、バイパストリック検出などの文体計量と指紋シグナルを追加するため、散文カタログ数とは意図的に異なります。検出器は、コマンドラインからファイルまたはパイプされたテキストをスコアリングし、GitHub Actionsやpre-commitフックで散文をゲートし、MCP上で実行できます。2つのカウントは検出器のドキュメントでマッピングされており、調整することを意図していません。 インストールはプラットフォームによって異なります。ユーザーは、リポジトリをエージェントのスキルディレクトリにクローンし、自己完結型のdistファイルを使用し、Claude Coworkプラグインとしてインストールし、OpenClaw用にClawHubからインストールし、Cursorに移植されたルールをドロップし、またはCodexの.agents/skillsディレクトリにスキルを配置できます。OpenAIプラグインパッケージは、ルーター、検出器、音声保持リライター、ファイルエディター、保存検証器、誤検知レビューアを含む7つの焦点を絞ったスキルを提供します。このプロジェクトはMITライセンスです。