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

Ponytailは、AIコーディングエージェント向けのスキル、プラグイン、ルールセットであり、より少なくシンプルなコードを書く方向へエージェントを導くように設計されています。そのキャッチフレーズは「怠惰なシニア開発者」です。たとえば日付ピッカーのようなものに対して、ラッパーコンポーネント、スタイルシート、依存関係を生成する代わりに、タスクが必要とするのがそれだけであれば、既存のネイティブHTML入力(`<input type="date">`)を使うようエージェントは導かれます。 ## 仕組み コードを書く前に、エージェントはラダーを順にたどり、最初に当てはまる段で止まります。 1. これは存在する必要があるか? いいえなら省略する(YAGNI)。 2. すでにこのコードベースにあるか? 書き直さず再利用する。 3. 標準ライブラリでできるか? それを使う。 4. ネイティブプラットフォーム機能か? それを使う。 5. インストール済みの依存関係か? それを使う。 6. 1行か? 1行書く。 7. ここまで来て初めて、動く最小限のものを書く。 このプロジェクトは、ラダーは問題を理解した後に実行されるものであり、その代わりではないと強調しています。エージェントは依然としてコードを読み、実際のフローをたどるべきです。また「怠惰」は「怠慢」ではないとも強調しています。バリデーション、エラーハンドリング、セキュリティ、アクセシビリティは決して犠牲にされません。 ## ベンチマークの主張 READMEは、実際のFastAPI + Reactテンプレートを編集するヘッドレスClaude Codeセッションを使ったエージェント型ベンチマークを報告しており、12の機能タスクにわたるgit diffで採点されています(Haiku 4.5、n=4)。PonytailはLOCを約54%削減し(過剰構築のケースでは最大94%)、同時にトークン、コスト、時間も削減し、安全性ティアでは100%を維持したと主張しています。また、80〜94%のコード削減を示す古い単発の数値も含まれていますが、その差の一部は会話型ベースラインのアーティファクトに由来するという注意書きがあります。このプロジェクトは、数値を唯一の証拠として提示するのではなく、完全な解説記事と再現手順へのリンクを提供しています。 ## インストールとサポート Ponytailは、幅広いAIコーディングホストにプラグインまたはルールセットとしてインストールできます。 - Claude CodeとCodexはプラグインマーケットプレイスのコマンド経由 - GitHub Copilot CLIはプラグインインストール経由 - Gemini CLIとAntigravity CLIは拡張機能インストール経由 - OpenCodeは`opencode.json`内のプラグインエントリ経由 - Pi、Hermes Agent、Devin CLI、OpenClaw、Grok Build、Qoderはそれぞれ独自のパッケージ機構経由 - Cursor、Windsurf、Cline、Kiro、Zed、CodeWhale、Swivalなどは`AGENTS.md`や該当するルールディレクトリなどのルールファイルをコピーする方法 共有の`hooks/`および`skills/`ディレクトリと、エージェント固有のアダプターを備えた単一リポジトリとして提供されます。 ## コマンド スキル対応ホストでは、いくつかのスラッシュコマンドが利用できます。 - `/ponytail [lite | full | ultra | off]` - 強度を設定するか、オフにする - `/ponytail-review` - 現在のdiffを過剰エンジニアリングの観点でレビューし、削除リストを返す - `/ponytail-audit` - リポジトリ全体を過剰エンジニアリングの観点で監査する - `/ponytail-debt` - 先送りされた「ponytail:」ショートカットを台帳に集める - `/ponytail-gain` - ベンチマークによる測定済みの影響を示す - `/ponytail-help` - クイックリファレンス レベルは、セッションごと、`PONYTAIL_SUBAGENT_MATCHER`環境変数によるサブエージェントごと、または`PONYTAIL_DEFAULT_MODE`環境変数や小さな設定ファイルによるデフォルトで制御できます。 ## 開発 このリポジトリには、コンパクトなルールテキストをすべてのエージェントコピー間で同期させる(`node scripts/check-rule-copies.js`)、OpenClawスキルパッケージを生成する、スキルをClawHubに公開する、正確性ベンチマークを実行する(メールとCSVのチェックにはPythonを使用)ためのスクリプトが含まれています。 ## ライセンス MIT。