Agent Scripts
Peter のローカルワークスペース向けに共有されるエージェント指示、スキル、小型ポータブルヘルパーをまとめたリポジトリです。
このリポジトリは以下の正規の保管場所です。
AGENTS.MD: Codex/Claude 系エージェント向けの共有ハードルールskills/: 再利用可能なワークフロースキル(シンボリックリンクで公開されるリポジトリ所有スキルを含む)scripts/: プロジェクト横断で使う依存関係の少ないヘルパーhooks/: スキルバリデーションなどのローカルガードレール
スキル
スキルは主要なルーティング層です。各 skills/<name>/SKILL.md は YAML フロントマターを持ちます。
---
name: skill-name
description: "短い汎用トリガーフレーズ"
---
ルール:
- 説明は短く汎用的に保ち、ドキュメントではなくルーティングを最適化する。
- スキル本体は簡潔かつ実用的に保つ。
- 繰り返し実行されるコマンドがあるワークフローでは、
skills/<name>/scripts/以下にヘルパースクリプトを置くことを推奨。 - 編集後は
scripts/validate-skillsで検証する。 - フロントマターの
descriptionは引用符で囲む。
グローバルな検出は scripts/sync-skills によって構築されます(冪等。クローン後またはスキル追加後、各 Mac で実行)。
- Codex は入れ子のディレクトリをスキャンするため、ルート全体へのリンクを得ます:
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills、~/.codex/skills/manager -> ~/Projects/manager/skills。 - Claude Code は
~/.claude/skills/<name>/SKILL.mdのみを読み込みます(正確に1階層深く、エントリごとのシンボリックリンクは追跡されますが、カテゴリサブフォルダはスキャンされません — バージョン2.1.197で確認済み)。両方のリポジトリに加えてマシンローカルの~/.codex/skills/<name>の拡張部分をカバーするフラットなスキルごとのリンクミラーを取得します。 - 名前の衝突は agent-scripts > manager > codex-local の優先順位で解決します。スクリプトはスキップされた重複を表示し、壊れたり古い管理リンクを削除します。
共有の個人スキルは skills/ 内の実フォルダとして存在します。公開の OpenClaw 共有スキルは ../agent-skills にあり、追跡された相対シンボリックリンクでここから公開されます。リポジトリ所有スキルは自身のリポジトリで正規の状態を保ち、同じ方法でここから公開されます。例:
skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl
現在シンボリックリンクされているリポジトリ所有スキル: birdclaw, discrawl, gog, imsg, slacrawl, wacli, wacrawl。
エージェント指示
共有ハードルールは AGENTS.MD にあります。
グローバル設定(scripts/sync-skills でも管理されています。Claude Code は CLAUDE.md のみを読み込むため、共有 AGENTS.MD にリンクします):
~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
下流のリポジトリはポインター形式の AGENTS.MD を使用する必要があります:
READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing).
リポジトリ固有のルールはそのポインターの下に記述します。共有ブロックを下流リポジトリにコピーしてはいけません。
ヘルパー
scripts/committer
- 指定されたファイルのみをステージします。
- 空でないコミットメッセージを必須とします。
- コミット前にスキルのバリデーションを実行します。
scripts/sync-skills
- マシンごとのスキルミラーを構築します: Codex 向けルート全体リンク、Claude 向けフラットなスキルごとのリンク、共有
AGENTS.MDポインター。 - 冪等。変更のみを表示し、壊れた古い管理リンクを削除し、実ファイルを上書きしません。
scripts/validate-skills
- すべての
skills/*/SKILL.mdをチェックします。 - YAML フロントマターと必須の
nameおよびdescriptionを検証します。 git config core.hooksPath hooksでローカルフックとして有効にできます。
scripts/docs-list.ts
docs/を走査します。summaryとread_whenのフロントマターを必須とします。- これを組み込んだリポジトリに対してオンボーディングサマリーを出力します。
scripts/browser-tools.ts
- スタンドアロンの Chrome DevTools ヘルパー。
- よく使うコマンド:
start --profile,nav <url>,eval '<js>',screenshot,console,network,search --content "<query>",content <url>,inspect,kill --all --force。 - オプションのバイナリを
bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-toolsでビルドできます。
同期
このリポジトリを共有エージェントルールとポータブルヘルパースクリプトの正規の保管場所として扱います。
下流リポジトリを同期する際は:
- まずここで最新を pull します。
- 各ターゲットリポジトリがポインター形式の
AGENTS.MDで始まっていることを確認します。 - ポインターの下にあるリポジトリローカルルールは保持します。
- ヘルパーの変更は、そのヘルパーがバイト単位で同一であるべき場合にのみ双方向にコピーします。
- スクリプトは依存関係がなくポータブルに保ちます。リポジトリ固有のインポートやパスエイリアスは使用しません。
サブモジュールについては、各サブリポジトリ内でポインターの確認を繰り返し、それらの変更をプッシュし、その後親リポジトリのサブモジュール SHA を更新します。