steipete/agent-scripts

解決する課題

このプロジェクトは、AIエージェント（特にCodexとClaude Code向けに調整）向けの共有指示、再利用可能なスキル、ポータブルなヘルパースクリプトを一元管理するシステムを提供します。複数のローカルワークスペースやリポジトリ間でルールやスキルを手動でコピーする必要がなくなり、エージェントの動作が異なるプロジェクト間で一貫して維持されます。

仕組み

このシステムは、共有ファイルとシンボリックリンクの組み合わせを使用して、指示とスキルを配布します。

• 共有指示: 中央のAGENTS.MDファイルにグローバルなハードルールが含まれています。他のリポジトリは、重複を避けるために、ポインタスタイルのAGENTS.MDを介してこのファイルを参照します。
• スキルルーティング: スキルは、ルーティング用のYAMLフロントマターを持つSKILL.mdファイルで定義されます。同期スクリプト（scripts/sync-skills）は、異なるエージェント向けに必要なミラーを作成します：Codex用のルート全体のリンクと、Claude Code用のフラットなスキルごとのリンク。
• ポータブルヘルパー: 依存関係が少ないスクリプトは、scripts/とhooks/に保存され、スキル検証などの一般的な機能とエージェントのガードレールを提供します。

対象読者

複数のローカルプロジェクトでClaude CodeやCodexなどのAIエージェントを使用し、エージェントのスキルと指示の「ナレッジベース」を一元管理したい開発者。

ハイライト

• マルチエージェントサポート: CodexとClaude Codeが必要とする異なるディレクトリ構造を具体的に処理します。
• 冪等な同期: sync-skillsスクリプトは、古いリンクを削除し、実際のファイルを上書きしないようにします。
• スキル検証: スキル定義が正しいことを確認するために、gitフックとして使用されるvalidate-skillsスクリプトが含まれています。
• ブラウザツール: エージェント駆動のブラウザ自動化用のスタンドアロンChrome DevToolsヘルパーが含まれています。