yzhao062/agent-style

21 writing rules for AI coding and writing agents. Drop-in for Claude Code, Codex, Copilot, Cursor, and Aider, so their output reads like a tech pro.

Agent Style の要素 – 何であるか

agent-style は、Python/Node 用の軽量で言語に依存しないライブラリ（PyPI および npm で利用可能）で、AI コーディング・ライティングエージェント向けに厳選された 21のライティングルール を提供します。これらのルールは、古典的なスタイル指南（ストランク＆ホワイト、オーウェル、ピンカー、ゴーペン＆スワン）と、2022–2026年のLLM生成文章から著者が観察したパターンを組み合わせています。エージェントが生成時にルールを読み取ることで、最初のドラフトを書く段階でルールに従おうとするようモデルが促され、後からテキストを修正するのではなく、自然にスタイルを統合できます。

ルールの範囲

対象ドキュメントタイプ 対象外
APIドキュメント、設計ドキュメント、研究論文、助成金申請書、README、ランブック、コミットメッセージ、技術ブログ記事、ポストモーテム、イシュー報告書 小説、詩、マーケティングコピー、長編の物語的ノンフィクション、非英語文章、リズムや感情表現が精度よりも重視される文章

21のルールは2つの同等なグループに分けられます：

  • RULE‑01 … 12 – 4つの古典的スタイル参照から直接採用された定番ルールで、それぞれ正確な出典を明記。
  • RULE‑A … I – LLM特有の典型的なミス（例：箇条書きの過剰使用、ダッシュの乱用、繰り返しの文頭、不要な接続語、引用の欠落など）を捉えた「現場観察ルール」。

両グループは同等に扱われ、優先順位の差はありません。

動作方法

  1. ソフトな強制（生成時） – お使いのAIツール（Claude Code、GitHub Copilot、Cursor、Aiderなど）に対応する agent-style enable <adapter> を実行します。CLIはツールがシステムプロンプトとして読み込む場所に小さなルールファイル（またはマーカーブロック）を書き込みます。モデルがテキストを生成する際、ルールがコンテキストに含まれるため、望ましいスタイルに自然に誘導されます。
  2. スキル / 2回目のレビュー – ドラフト生成後、agent-style style-review <path> を実行する（または、スキル対応ホスト上で style-review スキルを呼び出す）。このコマンドは同じ21のルールに基づいてドラフトを審査し、承認を得た上で、元の文章と並行して仕上げられたバージョンを出力します。

このパッケージには、多くの人気エージェント（Claude Code、Codex/AGENTS.md、GitHub Copilot、Cursor、Anthropic Skills、Kiroなど）向けのアダプタが同梱されており、インストール不要の curl レシピも用意されています。これはルールファイルを .agent-style フォルダに直接取得するものです。

効果はあるか？

著者は、10の固定された技術的ライティングタスク（製品説明、設計ドキュメントのセクション、論文の関連研究、PR説明、コミットメッセージなど）に対する健全性ベンチマークを提供しています。各タスクでモデルを2回実行（ルールあり／ルールなし）し、機械的レビューでルール違反数をカウントしました。

モデル（2026） ルールなしの違反数 ルールありの違反数 減少率
Claude Opus 4.7 88 47 ‑47 %
OpenAI GPT‑5.4（Codex CLI） 48 26 ‑46 %
Gemini 3 Flash 65 9 ‑86 %
GitHub Copilot（コントロール） 52 52 0 %

ベンチマークは「機械的モード」でのみ動作するため、ルールの一部（7つの機械的ルール）のみを測定しています。最大の改善は、長文の削減（RULE‑12）、em/enダッシュの回避（RULE‑B）、専門用語の削減（RULE‑06）に見られます。意味的なルール（例：引用の厳格さ（RULE‑H）、知識の呪い（RULE‑01））は現在のベンチではカバーされていないため、数値は方向性のみであり、統計的有意性を主張するものではありません。

だれが使うべきか？

  • AIコーディングまたはライティングアシスタントの開発者（Claude Code、Codex、GitHub Copilot、Cursor、Aider、Kiro、Replitなど）で、エージェントがより明確で伝統的な技術的文章を生成することを望む人。
  • これらのエージェントのメンテナスで、モデルプロンプトにスタイルガイドを簡単に組み込む、または生成後のレビュー手順を追加したい人。

クイックスタート（Python例）

pip install agent-style          # または npm i -g agent-style
agent-style enable claude-code   # Claude Code用のルールファイルを書き込み
# 後でドラフトが出来たら：
agent-style style-review path/to/file.md

READMEには、各対応ツールで作成されるファイルの一覧、今後の予定アダプタリスト、およびBAD/GOOD例を含む完全な RULES.md が含まれています。

結論：agent-style は、任意のLLMベースのライティングエージェントのプロンプトに、簡潔で文献に基づいたスタイルガイドを埋め込み、生成後に軽量なルールベースの審査を実行できる実用的でオープンソースのユーティリティです。新規モデルやトレーニングパイプラインの構築ではなく、AI生成技術文書の明確さと一貫性を高めるというニッチに特化しています。

関連

  • Dispatch
    SimpleEnglish エージェントスキルは、LLM が ASD‑STE100 簡易技術英語で執筆できるようにする

    SimpleEnglish エージェントスキルは、LLM に ASD‑STE100 標準に準拠したドキュメントを生成させ、STE 違反を 72.9% 削減し、複数の Claude モデルで出力を短縮します。

  • プロジェクト
    modoojunko/awesome-novel-agent

    awesome-novel-agent は、Claude Code、OpenCode、Reasonix、Codex、ZCode、または DeepSeek Harness を共同小説執筆アシスタントとして機能させるマルチプラットフォームスキルです。1回の音声コマンドでインストールされ、構造化されたMarkdownプロジェクトを作成し、アウトライン、プロンプト、執筆、AIフィルター、レビュー、更新など9つの専門AIエージェントを実行して、ジャンル選択から完成した章までユーザーを導きます。スタイル抽出、AIフィルター、動的メモリを備え、GPL‑3.0ライセンスで、中国語対応とQQユーザー群を提供しています。

  • Dispatch
    agent.md による LLM 支援コード品質の向上

    開発者が、AI エージェントに対して厳格なコーディング標準とコミットメッセージのルールを強制するための `agent.md` ファイルの使用システムを共有しています。これにより、繰り返しの手動レビューの必要性が軽減されます。

  • Dispatch
    AIエージェントのための効果的なツールの作成：Anthropicエンジニアリングガイド

    Anthropicは、非決定論的なAIエージェントのためのツール設計に関する、評価駆動型の体系的なフレームワークを概説しています。従来の決定論的なAPIパターンではなく、エージェント中心の設計を強調しています。

  • プロジェクト
    alirezarezvani/claude-skills

    364のスキル、120のコマンドを備えた巨大なオープンソースライブラリ。Claude Code、Codex、Gemini CLI、Cursor、および9つの他のAIコーディングエージェントにドメイン固有の専門知識を追加します。各スキルには構造化されたMarkdownガイド、純粋なPython CLIヘルパー、リファレンス資産が含まれます。リポジトリにはパーソナ、オーケストレーションプロトコル、および組み込みセキュリティオーサーが含まれており、任意のLLMコーディングアシスタントをフルスタックエンジニア、プロダクト、マーケティング、コンプライアンス、Cレベルアドバイザーに即座に変換できる仕組みです。