auto-skill-guide

Auto-Skill プラグイン

このプラグインは、コーディングエージェントのセッションからワークフローのパターンを自動的に検出し、再利用可能なスキルを生成し、セッションの途中で動的に読み込むことができます。

CLI ツールのインストール

エージェントスキルはインストールされましたが、auto-skill init、auto-skill discover などの CLI コマンドを使用するには、npm パッケージをインストールする必要があります。

クイックインストール:

# Option 1: Run the included install script
bash ~/.agents/skills/auto-skill-guide/install-cli.sh

# Option 2: Install globally via npm
npm install -g @matrixy/auto-skill

# Option 3: Use without installing (via npx)
npx @matrixy/auto-skill init

確認: auto-skill version

---

仕組み

Session 1: Grep → Read → Edit    ─┐
Session 2: Grep → Read → Edit     ├──▶ Pattern Detected → SKILL.md
Session 3: Grep → Read → Edit    ─┘

1. 観察: すべてのツール呼び出しは PostToolUse フックを介して記録されます
2. 検出: パターンが繰り返し（3 回以上）について分析されます
3. 生成: 承認されたパターンは、適切なフロントマターを持つ SKILL.md ファイルになります
4. 検出: Claude がタスクに関連するスキルを積極的に提案します
5. 読み込み: スキルは再起動なしでセッションの途中で読み込むことができます

コマンド

/auto-skill:review

検出されたパターンを確認して承認します:

/auto-skill:review              # List all detected patterns
/auto-skill:review preview ID   # Preview a pattern as a skill
/auto-skill:review approve ID   # Generate skill from pattern
/auto-skill:review reject ID    # Dismiss a pattern

/auto-skill:load

生成されたスキルを現在のセッションに読み込みます:

/auto-skill:load                # List available skills
/auto-skill:load <name>         # Load specific skill immediately

この方法で読み込まれたスキルは、セッションを再起動することなく即座に有効になります。

/auto-skill:status

システム診断を表示します:

/auto-skill:status              # Display stats, patterns, and config

パターン検出

パターンは次の場合に検出されます:

• 同じツールシーケンスがセッションをまたいで 3 回以上出現する
• シーケンスの長さが 2〜10 個のツールである
• パターンが過去 7 日以内に発生している

信頼度スコアリング

要素	重み	説明
出現回数	40%	出現回数が多いほど信頼度が高くなります
長さ	20%	3〜5 個のツールが理想的です
成功率	25%	成功したパターンはより高いスコアになります
新しさ	15%	最近のパターンが優先されます

パターンの例

Grep → Read → Edit        # Search, read context, make changes
Glob → Read → Write       # Find files, read, create new file
Read → Edit → Bash        # Read file, edit, run tests

動的スキル読み込み

標準の Claude Code スキル（セッション開始時に読み込まれる）とは異なり、自動生成されたスキルは、レジストリシステムを使用してセッションの途中で読み込むことができます。

仕組み

1. 軽量なレジストリがすべてのスキルにインデックスを付けます（メタデータのみ）
2. スクリプトが必要に応じてスキルの内容を取得して整形します
3. 出力には、有効な指示を示す明確な区切り文字が使用されます:

======================================================================
SKILL LOADED: <name>
Confidence: <score>
Allowed tools: <tools>
======================================================================

<skill instructions>

======================================================================
END OF SKILL - INSTRUCTIONS ARE NOW ACTIVE
======================================================================

積極的な検出

Claude は、skill-discovery スキルを使用して関連するスキルを自動的に検出できます:

1. ユーザーが複数ステップのタスクを要求します
2. Claude が一致するスキルを検索します
3. 見つかった場合、Claude が「このスキルを読み込みますか？」と尋ねます
4. ユーザーが承認 → スキルが読み込まれ、それに従います

CLI コマンド

auto-skill discover             # Discover skill patterns
auto-skill stats                # Show adoption statistics
auto-skill graduate             # Manage skill graduation
auto-skill agents list          # List known agents
auto-skill agents detect        # Detect installed agents

コミュニティスキルを検索するには、Skills CLI を使用します:

npx skills find "query"         # Interactive search
npx skills add owner/repo       # Install skill

実行コンテキスト

生成されたスキルには、適切な実行設定が自動的に付与されます:

パターンタイプ	コンテキスト	エージェント	理由
Grep → Read	Inline	Explore	読み取り専用で安全
Read → Edit → Bash	Fork	general-purpose	副作用がある

Inline: 現在の会話コンテキストで実行されます。

Fork (context: fork): 分離されたサブエージェントで実行されます。次の場合に使用します:

• 副作用のあるタスク（デプロイ、ビルド）
• 会話履歴を汚染すべきでないワークフロー
• 長時間実行される操作

ツールの制限

生成されたスキルには、パターンに基づいて allowed-tools が含まれます:

allowed-tools: Grep, Read, Edit

これにより、スコープの拡大を防ぎ、予測可能な動作を保証します。

生成されたスキル

自動生成されたスキルは次に保存されます:

~/.claude/skills/auto/<skill-name>/SKILL.md

各スキルには次のものが含まれます:

• メタデータを含む YAML フロントマター
• auto-generated: true フラグ
• 適切な場合は context: fork
• allowed-tools の制限
• 信頼度スコアとソースセッション
• パターンから導出された手順

設定

検出しきい値（~/.claude/auto-skill.local.md 内）:

---
detection:
  min_occurrences: 3      # Minimum pattern repetitions
  min_sequence_length: 2  # Shortest pattern
  max_sequence_length: 10 # Longest pattern
  lookback_days: 7        # Analysis window
  min_confidence: 0.7     # Suggestion threshold
---

データストレージ

データ	場所
イベント	~/.claude/auto-skill/events.db
スキル	~/.claude/skills/auto/
トラッキング	~/.claude/auto-skill/skills_tracking.db

プライバシー

• すべてのデータはローカルに保存されます
• データは外部サービスに送信されません
• 匿名テレメトリは AUTO_SKILL_NO_TELEMETRY=1 または DO_NOT_TRACK=1 で無効にできます

トラブルシューティング

パターンが検出されない場合

• 同じシーケンスが 3 回以上出現する必要があります
• ルックバック期間(デフォルト: 7 日間)を確認してください
• /auto-skill:status を実行してイベント数を確認してください

スキルが読み込まれない場合

• auto-skill discover を実行して更新してください
• ~/.claude/skills/auto/ にスキルが存在するか確認してください

フックが動作しない場合

• プラグインが正しくインストールされているか確認してください
• hooks/hooks.json の設定を確認してください
• Node.js 18 以上が利用可能であることを確認してください

リセットしたい場合

• ~/.claude/auto-skill/events.db を削除してください
• ~/.claude/skills/auto/ からスキルを削除してください