Calq-dev/laravel-ai-skills

laravel-ai-skills は何をしますか？

Laravel AI SDK 向けエージェントスキル（オープンスタンダード）サポート — ベンダーに依存しない SKILL.md ローダーと、オプションの Anthropic ネイティブ container.skills[] 統合を提供します。

概要

このパッケージは、Laravel AI SDK に対して、AI エージェント（例：Claude Code）が解釈可能なスキル定義を読み込む機能を追加します。SKILL.md ファイルはオープンスタンダードに基づいており、任意の AI エージェントツールと互換性があります。

インストール

composer require calq-dev/laravel-ai-skills

設定

config/ai-skills.php を公開して設定をカスタマイズできます：

php artisan vendor:publish --tag=ai-skills-config

基本設定

return [
    /*
    |--------------------------------------------------------------------------
    | スキルソース
    |--------------------------------------------------------------------------
    |
    | ここでスキルファイルの読み込み元を定義します。
    |
    */
    'source' => env('AI_SKILLS_SOURCE', 'local'),
    
    /*
    |--------------------------------------------------------------------------
    | スキルパス
    |--------------------------------------------------------------------------
    |
    | SKILL.md ファイルが配置されているディレクトリのパスです。
    |
    */
    'paths' => [
        resource_path('skills'),
    ],
    
    /*
    |--------------------------------------------------------------------------
    | Anthropic 統合
    |--------------------------------------------------------------------------
    |
    | 有効にすると、Anthropic のネイティブ container.skills[] フォーマットで
    | スキルをエクスポートします。
    |
    */
    'anthropic' => [
        'enabled' => env('AI_SKILLS_ANTHROPIC_ENABLED', false),
    ],
];

使用方法

スキルの読み込み

use CalqDev\LaravelAiSkills\SkillLoader;

$loader = new SkillLoader();
$skills = $loader->load();

特定のスキルの取得

$skill = $loader->find('skill-name');

Anthropic スキルのエクスポート

$anthropicSkills = $loader->toAnthropicFormat();

SKILL.md フォーマット

SKILL.md ファイルは、Agent Skills オープンスタンダードに従います。以下は最小限の例です：

# スキル名

スキルの説明文。

## 使用方法

使用方法の説明。

## 設定

- オプション1: 説明
- オプション2: 説明

統合

Laravel Artisan コマンド

スキルを管理するための Artisan コマンド：

php artisan ai:skills:list     # 利用可能なスキルを一覧表示
php artisan ai:skills:show {name}  # 特定のスキルを表示
php artisan ai:skills:cache    # スキルキャッシュを構築

環境変数

変数名	デフォルト値	説明
AI_SKILLS_SOURCE	local	スキルソース（local または remote）
AI_SKILLS_ANTHROPIC_ENABLED	false	Anthropic 統合を有効にする

ライセンス

MIT