mcpField
C
coach

coach

github.com/netresearchエージェントワークフロー1383 回インストール11 週間前に更新
リポジトリ

coach について

Coachは、訂正、指示の繰り返し、ツールの失敗などの摩擦を検出し、再利用可能な改善案を提案するClaudeスキルです。変更は明示的な承認後にのみ適用されます。

主な機能

  1. 01訂正や指示の繰り返しを検出
  2. 02ツールの失敗など摩擦の兆候を記録
  3. 03重複を除いた改善案を生成
  4. 04変更案を確認して承認
  5. 05承認済みルールをプロジェクトまたは全体のファイルに適用

活用シーン

  1. 01繰り返される訂正をプロジェクトルールに変換
  2. 02ツール失敗後に改善案を確認
  3. 03古いCLIツールや依存関係を検出
  4. 04手作業からスキルの不足を特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/netresearch/claude-coach-plugin --skill coach

インストール後、Claude Code で/coachを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
architecture.md
schema.md
scope_heuristics.md
signal_patterns.md
scripts/
aggregate.py
apply.py
detect_signals.py
fingerprint.py
hook_healer.py
init_coach.py
ledger.py
propose.py
root_cause_analyzer.py
scope_analyzer.py
skill_analyzer.py
scripts/tests/
test_process_violation_clustering.py

詳細

Coach - 自己改善型学習システム

Coach を使うと、Claude はつまずきから学び、時間とともに改善できます。学習の機会（ユーザーからの修正、指示の繰り返し、ツールの失敗、口調の強まり）を検出し、実行可能な改善候補を抽出して、ユーザーの明示的な承認が必要な変更を提案します。

基本原則：サイレントな書き込みは行いません。すべての改善に /coach approve によるユーザーの承認が必要です。

アクティベーションのトリガー

ユーザーからの修正（「いいえ」「やめて」「しないで」など）、指示の繰り返し、ツールやコマンドの失敗、口調の強まり（すべて大文字、「!!!」）、スキルへの補足（「これも覚えておいて……」など）、非推奨ツールの警告、明示的な /coach コマンド、またはセッション終了時にアクティベートします。

シグナルのカテゴリ（優先順位順）

  1. COMMAND_FAILURE（最高）— ゼロ以外の終了コード、stderr のパターン
  2. USER_CORRECTION（高）— 明示的な修正表現
  3. SKILL_SUPPLEMENT（高）— スキルへの追加のガイダンス
  4. VERSION_ISSUE（中〜高）— 非推奨または古いバージョンに関する警告
  5. REPETITION（中）— 意味的に類似した指示の繰り返し
  6. TONE_ESCALATION（低）— いらだちの兆候

候補の種類

種類説明例
rule安定した制約「生成されたファイルは決して編集しない」
checklistワークフローの手順「コード変更後にテストを実行する」
snippet繰り返し使えるコマンド「事前チェック用スクリプト」
skillスキル更新の提案「Y スキルに X のガイダンスを追加する」
antipattern決して行わないこと「ツールが存在すると決めつけない」

ワークフローの概要

  1. 検出 — フックがイベントを取得 → ~/.claude-coach/events.sqlite
  2. 生成 — シグナルを集約して提案を作成（フィンガープリントで重複を排除）
  3. スコープ — パスや言語に応じてプロジェクト単位かグローバルかを決定
  4. レビュー — /coach review で承認、却下、編集
  5. 適用 — 承認されたルールを ~/.claude/CLAUDE.md（グローバル）またはリポジトリの AGENTS.md（プロジェクト）に適用
  6. 振り返り — /coach retro で手作業をスキルの不足に関連付け、ソースリポジトリに PR を作成

ファイルの場所

~/.claude-coach/
├── events.sqlite      # Raw friction events
├── candidates.json    # Pending proposals
└── ledger.sqlite      # Cross-repo fingerprints

~/.claude/CLAUDE.md     # Global rules destination
<repo>/AGENTS.md        # Project rules destination

~/.claude/ or <repo>/.claude/
├── checklists/        # Workflow checklists
└── snippets/          # Reusable commands

スコープ

Coach：セッション中のリアルタイムなシグナル — events.sqlite による取得、/coach コマンド。 retro：セッション終了時／セッション横断の分析、スキルへの PR の振り分け。/coach retro は retro の役割と重複します。統合するかどうかは未決定です。

スクリプト

scripts/（このディレクトリ）— スキルディレクトリへのインストールで自己完結します。プラグインのパス： ${CLAUDE_PLUGIN_ROOT}/skills/coach/scripts/：

スクリプト目的
init_coach.pyCoach システムを初期化する
detect_signals.pyつまずきのパターンを検出する
aggregate.pyシグナルを候補に変換する
skill_analyzer.pyスキルを分析し、古いツールをスキャンする
apply.py承認された提案を適用する

プロアクティブなコマンド

  • /coach scan — 古い CLI ツールと依存関係を確認する
  • /coach retro — セッションの振り返り：手作業を分析し、ソースリポジトリのスキル改善に向けた PR を作成する

詳細なアーキテクチャ、スキーマ、パターンについては、references/ ディレクトリを参照してください。

コメント

Markdown 対応