update-agent-learnings

エージェント向けの永続的なガイダンスと、現在使用中のエージェントプロンプトファイルを更新します。

譲れないルール：

1. エージェントのメモリに記録するべき学びだけを記録します。
2. 学びの信頼できる情報源は一元化し、並行する別の中央ファイルを作成しません。
3. 承認済みの学びを、対応する CLI 用に存在するすべての関連エージェントサーフェスに同期します。
4. 「Claude Code Only」の学びを、エンジニア／レビュアーのエージェントプロンプトに反映しません。
5. 学びのファイルまたはエージェントファイルを変更する前に、必ずユーザーの明示的な確認を得ます。

エージェントの学びを更新する

入力

• $request：任意の学びの候補、適用範囲のヒント、エージェント名、またはセッションで明らかになったことに関するリマインダー

目標

次の手順で、検証済みのエージェントの学びを1つ中央の学びストアに追加し、該当するエージェントファイルに同期します。

• その学びがエージェントのメモリに属することを確認する
• 適用範囲を正しく分類する
• 正規の学びファイルを1つ更新する
• 関連する ## Learnings セクションを再生成する
• それらのセクションを存在するすべてのエージェントサーフェスに同期する

ステップ0：その学びがここに属することを確認する

このスキルの対象は、エージェントの動作に影響を与えるべき永続的な学びに限られます。

有効な例：

• スコープ管理、テスト、反復など、コーディングエージェント全般に適用されるルール
• 特定のテクノロジーまたは役割に関するエージェント固有のルール
• 中央の学びストアには属するものの、サブエージェントのプロンプトには反映しない「Claude Code Only」の学び

無効な例：

• スキル設計のルール
• メインの CLAUDE.md に記載するワークフローのルール
• 一度限りの実装メモ
• エージェントプロンプトを今すぐ書き換える直接的な依頼

適用先と範囲の分類については、references/learning-scope.md を読み込んでください。

その学びがエージェントのメモリに属さない場合は、ここでの作業を中止し、代わりにどこへ記載するべきか伝えてください。

成功基準：その学びがエージェントの学びのシステムに明確に属していること。

ステップ1：具体的な学びを1つ抽出する

セッションを振り返り、役に立つ最小限のルールを特定します。

次のいずれかに分類します。

• Global
• Claude Code Only
• Agent-Specific

ルール：

• 命令形で記述する
• 曖昧なルールの寄せ集めより、明確な学びを1つ優先する
• コーディングエージェント全般に本当に適用される場合に限り、Global とする
• スキル、オーケストレーション、設定、またはプロジェクトのセットアップに関するメタ作業には、Claude Code Only を使用する

成功基準：適切な範囲に分類された、実行可能な学びの候補が1つあること。

ステップ2：中央の学びファイルとエージェントの同期先を特定する

正規の中央学びファイルを特定します。

パスの方針：

• 中央エージェント学びファイルがすでに1つ存在する場合は、それを使用する
• .agents/learnings/agent-learnings.md と .claude/learnings/agent-learnings.md の両方が存在する場合は、正規の情報源を1つ選び、両方を手動で管理しない
• .agents を優先するこのリポジトリでは、.agents/learnings/agent-learnings.md を優先する
• リポジトリに .claude/learnings/agent-learnings.md しかない場合は、そちらを使用する

次に、エージェントの同期先を特定します。

• .agents/agents/*/AGENT.md ツリーが存在する場合は、そこに同期する
• .claude/agents/* ツリーが存在する場合は、そこに同期する
• 両方のツリーがある場合は、どちらも稼働中の CLI サーフェスとして扱う

次を読み込みます。

• 範囲と重複の扱いについては references/learning-scope.md
• 正規の学びファイルがまだ存在しない場合に限り、references/agent-learnings-template.md
• Learnings セクションの生成と配置については references/agent-sync-contract.md

成功基準：正規の学びファイルと、すべての同期先ツリーが特定されていること。

ステップ3：ユーザーに確認する

何かを編集する前に、次の項目を提示します。

• 適用範囲の分類
• 最終的な文言
• 正規の学びファイル
• 変更する同期先

確認または文言の調整が必要な場合は、AskUserQuestion を使用します。

ユーザーが明示的に承認するまで、書き込みを行わないでください。

成功基準：ユーザーが学びの内容と同期対象を承認していること。

Step 4: 中央の学習ファイルを更新する

最小限かつ適切な編集を行います。

• ファイル構造を維持する
• 学習内容を適切なセクションに挿入する
• 無関係な内容を削除しない
• ファイルに「Last updated」マーカーがすでにある場合に限り、更新する

ルール：

• 正規の学習ファイルがない場合は、references/agent-learnings-template.md から作成する
• セクションがない場合は、ファイル全体を再構成せず、既存の形式に合う最小限のセクションを作成する
• 既存のドキュメントに合わせて書式を統一する

成功基準：中央の学習ファイルに、承認された学習内容がちょうど1回含まれていること。

Step 5: 学習セクションを再生成し、エージェントファイルに同期する

中央の学習ファイルを使って、対象となる各エージェントファイルの ## Learnings セクションを作成します。

同期ルール：

• グローバルな学習内容は、すべてのコーディングエージェント／レビュアーエージェントのファイルに反映する
• エージェント固有の学習内容は、該当するエージェントのファイルだけに反映する
• 「Claude Code Only」の学習内容は中央の学習ファイルに残し、サブエージェントのプロンプトには反映しない
• エージェントファイルに ## Learnings セクションがすでにある場合は、そのセクションを適切に置き換える
• セクションがない場合は、references/agent-sync-contract.md で定義された位置に挿入する

重要：

• .agents と .claude の両方のエージェントツリーがある場合は、両方を更新する
• ファイル名が一致するとは限らないため、実際に存在するパスを確認する
• 学習内容の同期時に、無関係なプロンプトのセクションを書き換えない

成功基準：存在するすべての CLI ツリー内で、該当するすべてのエージェントファイルに正しい Learnings セクションが同期されていること。

Step 6: 検証して報告する

以下を検証します。

• 学習内容が中央の学習ファイルに1回だけ存在すること
• 同期対象が意図どおりに更新されていること
• エージェントの Learnings セクションに、適切なグローバルおよびエージェント固有の内容が含まれていること
• 「Claude Code Only」の学習内容がサブエージェントのプロンプトに漏れていないこと

以下を報告します。

• スコープの分類
• 正規の学習ファイル
• 更新した同期対象のツリー
• 最終的な文言
• 作成または更新したファイル

成功基準：中央および各エージェントの領域で、何が変更されたかをユーザーが正確に把握できること。

ガードレール

• このスキルによってモデルが自発的に処理を開始しないようにすること。永続的な学習内容やエージェントのプロンプトファイルを変更するためです。
• context: fork を追加しないこと。このワークフローでは、アクティブなリポジトリを編集します。
• paths: を追加しないこと。これは汎用的なメンテナンススキルです。
• ルーティング表、スコアカード、大規模な Learnings の例を SKILL.md にインラインで記載しないこと。
• ユーザーの明示的な承認なしに学習内容を追加しないこと。
• 内容が異なる中央の学習ファイルを2つ管理しないこと。
• .agents と .claude の両方のエージェント領域が存在する場合に、片方の CLI ツリーの更新を省略しないこと。

参照資料を読み込むタイミング

• references/learning-scope.md 学習内容をエージェントのメモリに含めるべきかどうかの判断、適切なスコープの選択、重複への対応に使用します。

• references/agent-learnings-template.md 正規の中央学習ファイルがなく、互換性のある最小限のファイルを作成する必要がある場合にのみ使用します。

• references/agent-sync-contract.md 対応する CLI ツリー全体でエージェントファイルに挿入する Learnings セクションの生成と、適切な挿入位置の決定に使用します。

出力要件

以下を報告します。

1. 学習内容が承認されたか、別の場所に振り分けられたか
2. 選択したスコープと正規の学習ファイル
3. 承認された最終的な文言
4. 更新した CLI エージェントツリー
5. 重複の統合や同期対象についての判断