mcpField
L
learn

learn

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

learn について

learn は、プロジェクトの修正点や知見を記録し、適切な指示ファイルへ振り分けるエージェントスキルです。蓄積した知見の確認、昇格、監査にも対応します。

主な機能

  1. 01プロジェクト範囲に応じた更新の振り分け
  2. 02保留中の知見と頻度の確認
  3. 03繰り返し発生する知見の昇格
  4. 04古い記録や矛盾の監査
  5. 05ファイル変更前の承認必須化

活用シーン

  1. 01修正点をプロジェクト指示ファイルへ振り分け
  2. 02ガイド更新前に知見の傾向を確認
  3. 03重複または古い知見の発見

インストール

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

$npx skills add https://github.com/wyattowalsh/agents --skill learn

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

同梱ファイル

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

evals/
correction-routing.json
evals.json
promote-mode.json
review-mode.json
references/
kaizen-principles.md
routing-rules.md
scripts/
check.py
state.py
scripts/asset_toolkit/
__init__.py
_shared.py
common.py
package.py
validate_evals.py
validate_hooks.py
validate_skill.py

詳細

学習 — プロジェクトのナレッジを記録して振り分ける

修正点、知見、パターンを記録します。適切な指示ファイルに振り分けます。指示を簡潔かつ効果的に保つため、カイゼンの原則を適用します。

振り分け

$ARGUMENTSアクション
"<correction text>"修正点を適切な指示ファイルに振り分ける
review未処理の学びとその発生頻度を表示する
promote発生頻度の高い学び（3回以上）を指示ファイルに昇格させる
audit古くなった学び、矛盾する学び、重複した学びを確認する
空使用方法の概要を表示する

参照資料

ファイル目的
references/routing-rules.md指示の変更先を決めるための判断ツリー
references/kaizen-principles.mdエラー防止パターン、フック・文章・ルールの使い分け

振り分けプロトコル

提案された更新を適切な変更先に振り分けます。

範囲変更先
プロジェクト横断の規約instructions/global.md
言語固有のツール規約スキル（python-conventions など）
オーケストレーション／並列処理orchestrator スキルの本文
プロジェクト固有の標準プロジェクトの AGENTS.md
ファイル単位の適用.claude/rules/<topic>.md
スキルの動作スキル独自の SKILL.md
振り分けの判断手順
  1. 範囲を判断します。すべてのプロジェクトに適用されますか、それとも特定のプロジェクトだけですか？
  2. プロジェクト横断の場合、特定の言語やツールに関する内容ですか？
  3. 言語固有の場合、対応する規約スキルに振り分けます
  4. 一般的な内容の場合、instructions/global.md に振り分けます
  5. プロジェクト固有の場合、そのプロジェクトの AGENTS.md に振り分けます
  6. ファイル単位の適用に限られる場合、.claude/rules/ にエントリーを作成します

カイゼンの原則

  1. 抜本的な変更より段階的な改善 — 実行可能な最小限の変更を行い、次に進む前に検証します
  2. ポカヨケ — 文章による指示よりフックやツールを優先します（設計によってエラーを防止）
  3. 標準作業 — 既存のパターンに従い、うまくいく方法を文書化します
  4. JIT — 必要なものだけを作成し、測定後に最適化します

検証チェックリスト

  1. 実際の運用と照合します — パターンが実際の使い方を反映していることを確認します
  2. 既存の指示と矛盾していないか確認します
  3. トークンへの影響を評価します — 常時読み込まれる内容を最小限に保ちます
  4. ユーザーの承認を得ます — 同意なしに指示ファイルを変更してはいけません
  5. 変更をテストします — 指示ファイルを編集したら python scripts/check.py を実行します

重要なルール

  1. ユーザーの明示的な承認なしに指示ファイルを変更してはいけません
  2. 昇格には、2回以上のセッションにわたる3回以上の修正を必要とします
  3. 既存の指示と矛盾していないか確認します
  4. 適用可能な範囲のうち最も限定的なものに振り分けます（ルールはスキルより優先、スキルはグローバルより優先）
  5. 常時読み込まれる内容をトークン予算内に保ちます
  6. 指示ファイルを変更するたびに python scripts/check.py を実行します
  7. 文章よりフックやルールを優先します（ポカヨケの原則）

正式用語

  • instruction file — エージェントへの指示を記載したファイル（global.md、AGENTS.md、SKILL.md など）
  • routing — 変更に適した変更先ファイルを選ぶプロセス
  • correction pattern — 指示の欠落や誤りを示す、繰り返し発生する修正
  • token budget — 常時読み込まれる指示内容の上限
  • scope — プロジェクト横断、言語固有、オーケストレーション、プロジェクト固有、またはファイル単位

検証要件

変更完了を宣言する前に、このスキルのディレクトリから以下を実行します。

python scripts/check.py

完了条件：

  1. scripts/check.py が終了コード 0 で終了すること。
  2. このスキルのディレクトリ内に、移植可能な CLI に関する違反が残っていないこと。

コメント

Markdown 対応