agent-scripts: ローカルワークスペース間で共有エージェント指示とポータブルワークフロースキルを統合するハブ

解決する課題

このプロジェクトは、複数のローカルワークスペースにまたがって AI エージェント（Codex や Claude など）の共有指示、再利用可能なスキル、ヘルパースクリプトを管理するための、集中化されたポータブルシステムを提供します。

仕組み

システムはディレクトリ構造を利用し、共有ルールを AGENTS.MD に、実行可能スキルを skills/ フォルダーに格納します。これらはユーザーのグローバル設定ディレクトリ（例: ~/.codex/ や ~/.claude/）へのシンボリックリンクを通じて AI エージェントに統合されます。依存関係が少ないヘルパースクリプトのセットが同梱されており、スキルの検証、変更のコミット、Chrome DevTools を用いたブラウザ自動化といったタスクを自動化します。

対象者

ローカル開発環境で AI エージェントを使用し、エージェントの振る舞い、共有スキル、プロジェクト間で共通に利用できるユーティリティスクリプトの単一の真実の情報源を求めている開発者向けです。

ハイライト

• 集中化されたエージェントルール: ポインタ形式の AGENTS.MD を使用し、グローバルルールを維持しつつリポジトリ固有のオーバーライドを可能にします。
• モジュラーなスキルシステム: スキルは Markdown ファイル内の YAML フロントマターで定義され、エージェントが簡単に検出できるルーティング層を実装しています。
• ポータブルヘルパー: ブラウザ自動化、スキル検証、制御された git コミット用の専門スクリプトが含まれています。
• クロスリポジトリ同期: 他プロジェクトのリポジトリ所有スキルをシンボリックリンクで中央ハブに取り込み、統一されたアクセスを実現します。