yzhao062/agent-style

解決する課題

AIエージェントが『AI特有の兆候』——たとえば過剰な接続語の使用、多すぎる箇条書き、受動態の濫用——を含む文章を生成する傾向があることを解決します。このような文章は、プロフェッショナルな技術文書に求められる正確さと明確さを欠くことが多く、本プロジェクトは確立されたライティング基準を適用することで、AIエージェントが技術専門家のように書けるよう構造化された方法を提供します。

動作方法

本プロジェクトは、21の英語ライティングルール（ストランク＆ホワイト、オーウェルなどから選ばれた12の古典的ルールと、2022年～2026年のLLM出力観察から導き出された9つのフィールドルール）をカスタマイズして提供しています。これらのルールはAIエージェントに以下の2つの方法で統合されます：

1. ソフトな強制：ルールは生成時にエージェントのシステムプロンプトまたはプロジェクト設定に読み込まれ、最初のドラフト作成時にモデルがルールに従うよう促します。
2. スキルベースのレビュー：オプションの2回目の審査（style-review）により、ドラフトがルールに準拠しているか分析し、洗練されたバージョンを生成します。

対象ユーザー

• AIコーディングおよびライティングエージェント（例：Claude Code、Cursor、GitHub Copilot、Aider、Codex）およびそのユーザー。
• エージェント設定のメンテナスで、生成された技術文書が一般のLLMパターンではなく、文献に基づいた規範に従うようにしたい人。

主な特徴

• 二重ルールセット：古典的なライティングガイドと、2022年～2026年のLLM出力観察から得られたルールを組み合わせ。
• 広範な統合：Claude Code、Cursor、Copilotなど、人気AIツール用の多数のアダプタをサポート。
• 機械的検証：複数の主力モデルで『AI特有の兆候』違反が顕著に減少することを示す健全性ベンチマークを含む。
• 技術的範囲：APIドキュメント、設計ドキュメント、研究論文、READMEに特化して最適化。小説やマーケティングコピーは明示的に除外。