boost-skills は何をしますか?
Sander Muller氏個人のComposer分散型AIエージェントスキルカタログ(PHPプロジェクトおよびComposerパッケージ向け)。Sander氏の好みに合えばそのまま採用してもよいし、自身のカタログのテンプレートとしても利用できます。
sandermuller/boost-skills は、Composer で配布される AI スキルカタログの一例です。汎用的なワークフロースキル(コードレビュー、バグ修正、仕様駆動実装、リリースチェックリスト、Jira ワークフロー、デプロイなど)、タグで制御されるフレームワーク固有の拡張機能、常時有効な ガイドライン を厳選してバンドルしています。詳細な スキル および ガイドライン の一覧は以下をご覧ください。
このパッケージには実行コードは含まれておらず、純粋な Markdown です。同期エンジン(sandermuller/boost-core または laravel/boost)がこれらのスキルを読み取り、設定済みの各 AI エージェントディレクトリ(Claude Code、Cursor、Copilot、Codex、Gemini など)に書き込みます。
スキルはどこから来るのか?
スキルソースは自由に組み合わせられます。
- プロジェクト内の独自
.ai/skills/フォルダ。手動作成。laravel/boostとboost-coreの両方が自動的に認識する同じ規則に従います。 - Composer インストール済みカタログパッケージ。
resources/boost/skills/を含む任意のパッケージが対象。Sander 氏は自身のカタログをsandermuller/boost-skills(このリポジトリ)で公開しています。好みに合えば採用するか、自身のプライベート/公開カタログのテンプレートとして利用できます。 boost-coreのwithRemoteSkills()による外部(非Composer)ソース。GitHub 公開の.skillバンドルや単一スキルリポジトリを URL から直接取得します。laravel/boostにバンドルされた Laravel スキル。laravel/boostが提供する Laravel 固有のスキル(Laravel アプリケーションのみ)。
withAllowedVendors() は Composer スキャンベンダー(ソース2)のみを制限します。withTags() はソース2、3、4(Composer ベンダー、リモートスキル、laravel/boost バンドル)をフィルタリングします。プロジェクトの .ai/skills/(ソース1)は両方の制限をバイパスします。プロジェクトが作成したスキルは正規のものとして扱われ、フィルタは適用されません。
boost ファミリー
sandermuller/boost-skills(または任意のComposer分散カタログ)を採用する場合、役割に応じた同期エンジンを組み合わせてください。
sandermuller/package-boost-php:フレームワーク非依存の Composer パッケージ開発者向けsandermuller/package-boost-laravel:Laravel パッケージ開発者向けsandermuller/project-boost-php:PHP アプリケーション開発者向けsandermuller/project-boost-laravel:Laravel アプリケーション開発者向け(laravel/boostと共存可能。9エージェントファンアウト、タグフィルタ、ベンダー許可リスト、リモートスキルを追加)
これら4つの sandermuller/* パッケージは sandermuller/boost-core 同期エンジンをバンドルしているため、boost-core を単体でインストールすることはほとんどありません。laravel/boost(Laravel の独自エンジン、MCP サーバー、ドキュメント API)は Laravel アプリケーション内で project-boost-laravel と共存します。ファミリーパッケージが9エージェントファンアウトとフィルタをその上に追加します。ファミリーコントロールをスキップして laravel/boost を単独で使用する場合でも、このカタログを含む任意の Composer 分散カタログを読み取ることができます。その場合は laravel/boost のセットアップ手順に従ってください。boost-core がインライン展開するプロジェクト規約スロットは laravel/boost でも正しく読み取られます。スキルは表示可能なデフォルト値を持つため(プロジェクト規約スキーマ 参照)、laravel/boost がスロットを解決しなくても適切なデフォルトの文言が得られます。これらが合わない場合(例えば非PHPパッケージ)、boost-core を直接インストールしてください。
インストール
sandermuller/boost-skills をカタログとして採用する場合、エンジンの役割に応じたファミリーパッケージと一緒にインストールします。フレームワーク非依存のパッケージ開発者であれば、package-boost-php です。
composer require --dev sandermuller/boost-skills sandermuller/package-boost-php
package-boost-php を package-boost-laravel または project-boost に置き換えて、役割に合わせてください。以下の手順は boost-core エンジンのコマンドを使用します。laravel/boost の場合は、独自のセットアップ手順 に従い、sandermuller/boost-skills が同期対象のパッケージに含まれていることを確認してください。
boost-core(ファミリーパッケージにより導入)にはインタラクティブなセットアップコマンドが含まれています。
vendor/bin/boost install
boost install はプロジェクトルートに boost.php を生成し、ターゲットエージェントと許可ベンダーを選択できます。スキルは許可されたベンダーからのみ同期されるため、sandermuller/boost-skills が選択されていることを確認してください。結果は次のようになります。
return BoostConfig::configure()
->withAgents([
Agent::CLAUDE_CODE,
Agent::COPILOT,
Agent::CODEX,
])
->withAllowedVendors([
'sandermuller/boost-skills',
'sandermuller/package-boost-php',
])
->withTags(['php', 'github']);
プロジェクトの機能を ->withTags(...) で宣言します。タグ付けされたスキルとガイドラインは、オプトインしたプロジェクトにのみ同期されます。一般的な開始タグは 'php' と 'github' です。完全な語彙は Tags レジストリを参照してください。同期後、vendor/bin/boost tags を実行すると、現在フィルタリングされているタグ付きコンテンツと同期されているコンテンツが表示されるため、宣言すべき機能を特定するのに役立ちます。
次にスキルを展開します。
vendor/bin/boost sync
編集後は vendor/bin/boost sync を再実行するか、または BoostAutoSync コールバック を composer.json の post-install-cmd / post-update-cmd に組み込むことで、composer install / composer update のたびに自動的に再同期できます。生成されたエージェントディレクトリ(.claude/skills/、.github/skills/ など)はバージョン管理の対象外です。boost-core が .gitignore ブロックを管理します。
スキル
| スキル | 説明 | タグ |
|---|---|---|
ai-guidelines | AI スキルとガイドラインファイル(.ai/、CLAUDE.md、AGENTS.md)の作成と管理。 | — |
autoresearch | 自律パフォーマンスループ:ベンチマーク、コード変更、測定結果に基づいて保持または復元。 | php |
backend-quality | 2段階PHP品質ゲート:変更ごとにPint + 関連テスト、完了時にPHPStan + 全スイート。 | php |
bug-fixing | テスト駆動バグワークフロー:失敗するテストで再現後、修正。 | — |
code-review | 最近の変更を機能性、コード品質、セキュリティ、テストの観点からレビュー。 | — |
codex-review | OpenAI Codex CLI による独立レビューを依頼し、正当な修正を適用、クリーンになるまで再レビュー。 | — |
deploying-laravel-cloud | cloud CLI を使用して Laravel Cloud 上で Laravel アプリをデプロイ・管理:環境、データベース、ドメイン、請求。 | laravel-cloud hosting |
eloquent-models | カラム/リレーション定数、包括的な DocBlock、外部キー定数を含む Eloquent モデルの作成と管理。 | laravel |
evaluate | 実装全体を自己レビューし、発見された問題を修正。 | — |
final-verification-review | 最終確認:完全な評価ループを実行し、クローズアウト事前チェック(PR フロー または PRなしコミット/リリース)をドライラン、READY / NOT READY を報告。 | github |
frontend-quality | フロントエンド品質ゲート:型チェック、リント、JS テストスイート;UI 変更には目視確認を推奨。 | frontend |
github-issue-updates | 機能リリース後、GitHub Issue にユーザー向け説明と QA テスト項目を追記。 | github-issues |
humanizer | AI 生成文章の痕跡を除去し、自然で人間らしいテキストに。 | — |
implement-spec | 進捗追跡可能な仕様ファイルをフェーズごとに実装。 | — |
interview | 複雑な機能の要件を敵対的に引き出す:コードファースト、前提条件監査済み、スペック作成前。 | — |
jira-create | 適切に整形されたユーザー向け説明を含む Jira Issue を作成。 | jira |
jira-rework | やり直しで送り返された Jira Issue を調査し、修正オプションを提案。 | jira github |
jira-updates | PR 作成後に Jira Issue を更新;「質問によりブロック中」コメントを投稿。 | jira github |
migration-squash | Laravel マイグレーションスカッシュを安全に作成・レビュー:事前にダンプを確認し、不完全、汚染、データ損失のベースラインをキャッチするチェックリスト。 | laravel |
pr-review-feedback | PR レビューコメントを適用、各コメントを批判的に評価してから対応。 | github |
pre-release | プッシュ前の総合チェック:Rector、Pint、全テストスイート、PHPStan、ドキュメントの陳腐化監査。 | php github |
pull-requests | gh 経由で自身の GitHub PR を作成・管理:説明文作成、確認、リスクに応じてルーティング。 | github |
readme | Composer パッケージの高品質 README を作成・維持:スケルトン vs 包括的、トーン、陳腐化監査。 | release-automation |
release-notes | Composer パッケージの GitHub リリース本文作成:構造、トーン、破壊的変更の強調、除外すべき内容。 | release-automation |
resolve-conflicts | どちら側の機能も欠落させずに git マージコンフリクトを解決。 | — |
test-writing | Arrange-Act-Assert に従った、具体的で説明的な名前のテストを作成。 | — |
upgrading | Composer パッケージにおける UPGRADING.md の正規の構造:いつ維持するか、何を記載すべきか。 | release-automation |
ux-review | 新機能の UX/UI オプションを評価し、アプローチを推奨、決定を文書化。 | — |
write-spec | 進捗追跡可能なフェーズを含む、実装準備完了の仕様ファイルを作成。 | — |
タグ
ほとんどのスキルとガイドラインは普遍的であり、すべてのプロジェクトに同期されます。一部のものは機能タグを持ち、コンテンツが有用になるためにプロジェクトが必要とする(またはオプトインした)機能を示します。プロジェクトは boost.php で ->withTags(...) により機能を宣言し、一致するコンテンツのみが同期されます。
タグメカニズム(サブセットAND一致、boost.php での withTags() 宣言、スキルフロントマター内の metadata.boost-tags、ガイドライン用の .boost-tags.yaml サイドカーマニフェスト)はファミリー標準です。boost-core によって定義され、任意の Composer 分散カタログに適用されます。以下のタグ語彙は、このカタログの選択であり、boost-skills が提供するスキルとガイドラインによって明示される Sander 氏の機能ミックスです。他のカタログは異なる構成を取る場合があります。Owner は、各タグを使用するコンテンツを提供する boost ファミリーパッケージを示します。
boost-core はより広範な Tag 列挙型(SanderMuller\BoostCore\Enums\Tag)を提供し、このカタログのどのスキルにも関連しないケース(Tag::Filament、Tag::Livewire、Tag::Volt、Tag::Inertia、Tag::Flux、Tag::Pest、Tag::Tailwind など)を含みます。これらはファミリー語彙における将来互換のスロットです。withTags(...) でこれらを宣言しても現在は問題なく(出荷されたスキルはまだ対象外)、boost-core の「宣言済みだが未発見の保持ルール」に従い、boost install ピッカーの再実行後も保持されます。以下の表は、boost-skills 自体が現在コンテンツを提供しているタグのみをカバーしています。完全な列挙型語彙については、boost-core の Tag::* を参照してください。
| タグ | 意味 | Owner |
|---|---|---|
boost-extension | オプトイン — boost-core の拡張(カスタムスキル + FileEmitters) | package-boost-php |
database | プロジェクトにデータベースあり | boost-skills |
frontend | フロントエンドツールチェーン — 型チェック、リント、JS テスト | boost-skills |
github | GitHub でホスティング | boost-skills |
github-issues | GitHub Issues での課題管理 | boost-skills |
hosting | プロジェクトがホスティングプラットフォームにデプロイ(プラットフォーム固有タグの親) | boost-skills |
jira | Jira でのイシュー管理 | boost-skills |
laravel | プロジェクトが Laravel を使用 | boost-skills |
…
[翻訳のため省略]