agent-scripts: ローカルワークスペース全体で共有AIエージェントのルールと再利用可能なワークフロースキルを管理するためのセントラルハブ

何を解決するか

複数のローカルワークスペースにわたって、AIエージェント（具体的には Codex と Claude Code）用の共有指示、再利用可能なスキル、およびポータブルなヘルパースクリプトを管理するための、集約化されたシステムを提供します。これにより、個々のプロジェクトリポジトリごとにルールやワークフローを複製する必要がなくなります。

仕組み

このプロジェクトは、グローバルなエージェントルール (AGENTS.MD) と、スキルのライブラリ（YAML front matter を含む SKILL.md ファイルで定義）を保存するためのカノニカルなリポジトリを使用します。同期スクリプト (sync-skills) が、エージェントの設定ディレクトリ（例: ~/.codex/ や ~/.claude/）にシンボリックリンクを作成することで、ユーザーが現在どのプロジェクトで作業しているかにかかわらず、異なるAIエージェントがこれらの共有スキルやルールを検出して使用できるようにします。

対象者

Claude Code や Codex のようなAIエージェントを多くの異なるリポジトリで使用しており、ローカル環境全体で一貫した「厳格なルール」と運用ワークフロー（スキル）のセットを、常に利用できるようにしたい開発者。

ハイライト

• 集約化されたルール管理: 単一の AGENTS.MD ファイルを複数のエージェント設定にシンボリックリンクすることで、一貫した動作を保証します。
• スキルルーティング: YAML メタデータを使用した構造化されたスキルシステムを実装しており、短いフレーズを通じてエージェントが特定のワークフローをトリガーすることを支援します。
• リポジトリをまたぐ統合: 他のリポジトリからスキルをセントラルハブへシンボリックリンクすることをサポートしており、リポジトリ固有のスキルを自身のプロジェクト内でカノニカルに保ちつつ、グローバルに利用可能にすることができます。
• ポータブルなヘルパー: スキルの検証、コミット管理、Chrome DevTools の自動化などのタスクのための、依存関係の少ないスクリプトを含んでいます。