update-skill-learnings

このスキルは、永続的なスキル作成ガイダンスを更新するため、規律を守る必要があります。

譲れないルール：

1. スキルの構造、スキルの内容、アンチパターン、または単一のスキルの設計に関する学びだけを記録してください。
2. アプリケーションコードやエージェントの動作に関する学びは受け入れず、適切なメンテナンスワークフローに振り分けてください。
3. 並行するコピーを作成せず、正規の学びファイルをちょうど1つ更新してください。
4. 書き込む前に、重複または類似した内容がないか確認してください。
5. 学びファイルを変更する前に、ユーザーから明示的な確認を得てください。

スキルの学びを更新する

入力

• $request：任意の学び候補、スキル名、カテゴリのヒント、またはセッションで明らかになったことに関するリマインダー

目標

以下の方法で、検証済みのスキル作成に関する学びを1つ、中央の学びストアに追加します。

• その学びがスキルメモリに属することを確認する
• 適切なカテゴリを選ぶ
• 正規の学びファイルを更新する
• ファイルの構造を維持し、重複を避ける
• 変更内容を正確に報告する

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

このスキルは、スキルの作成、レビュー、改善に関する永続的なガイダンス専用です。

有効な例：

• より良いスキルのための構造パターン
• 明確さや使いやすさを高める内容のパターン
• 繰り返し混乱を招くアンチパターン
• 中央で記憶しておくべき、特定のスキルに関する設計ルール

無効な例：

• アプリケーションの実装ルール
• メインのClaudeとの会話におけるエージェントの動作ルール
• 今すぐスキルを書き換える直接的な依頼
• 永続的なメモリとして残す価値のない単発のメモ

振り分け先、カテゴリの配置、失敗パターンについては、references/learning-scope.mdを読み込んでください。

学びがスキルの学びシステムに属さない場合は、そこで中止し、代わりにどこへ記録すべきかを伝えてください。

成功基準：その学びが、永続的なスキル作成ガイダンスに明確に属しています。

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

セッションを確認し、役立つ最小限のルールを特定してください。

ルール：

• 曖昧な観察を長々と列挙するより、正確な学びを1つ選んでください
• 命令形で記述してください
• 具体的なパターン、アンチパターン、またはスキル固有のルールに結び付けてください
• より強い既存のガイダンスからすでに推測できる助言は記録しないでください

適切な例：

• 「大きなチェックリストはSKILL.md内ではなく、referencesに置いてください。」
• 「永続メモリを管理するスキルにはdisable-model-invocation: trueを設定してください。」

不適切な例：

• 「スキルをもっと良くしてください。」
• 「指示をもっと明確にしてください。」

成功基準：明確な根拠を伴う、実行可能な学びの候補が1つあります。

ステップ2：正規の学びファイルを特定し、配置先を選ぶ

正規の中央学びファイルを特定してください。

パスの方針：

• リポジトリに既存のスキル学びファイルが1つある場合は、それを使用してください
• .agents版と.claude版の両方が存在する場合は、正規の作成元となる場所を更新し、第二の情報源を作成しないでください
• この正規の.agentsツリーでは、.agents/learnings/skill-learnings.mdを優先してください
• リポジトリが唯一の学びストアとして.claude/learnings/skill-learnings.mdを使用している場合は、代わりにそれを使用してください

適切なカテゴリを選んでください：

• Structural Patterns
• Content Patterns
• Anti-Patterns
• Skill-Specific Learnings

書き込む前に：

• 重複または類似した内容がないか検索してください
• 類似するルールがすでにある場合は、既存の文言に統合してください
• 新しい指示は短く、適用範囲を限定してください

以下を読み込んでください：

• 振り分け、カテゴリ、重複の扱いについてはreferences/learning-scope.md
• 正規の学びファイルがまだ存在しない場合に限り、references/skill-learnings-template.md

成功基準：対象ファイルとセクションが特定され、重複のリスクが確認されています。

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

学びのファイルを編集する前に、次の内容を提示します。

• カテゴリ
• 最終的な文言
• 対象ファイル
• この学びを抽出した理由

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

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

成功基準：ユーザーが学び、配置、対象ファイルを承認していること。

ステップ 4：学びのファイルを更新する

必要最小限の適切な編集を行います。

• ファイル構造を維持する
• 選択したセクションに学びを追加する
• 関係のない内容を削除しない
• ファイルに「Last updated」マーカーがすでにある場合に限り、更新する

ルール：

• 正本となる学びのファイルがない場合は、references/skill-learnings-template.md から作成する
• セクションがない場合は、ファイル全体を再構成せず、既存の構成に合う最小限のセクションを作成する
• 既存のドキュメントに合わせて書式を維持する
• このワークフローの一環として、実際のスキルファイルを同期または書き換えない

成功基準：承認された学びが、正本となる学びのファイルの適切なセクションに記載されていること。

ステップ 5：検証して報告する

次の点を検証します。

• 学びがちょうど 1 回追加されていること
• カテゴリの配置が正しいこと
• ファイル構造に問題がないこと
• 更新内容がアプリケーションコードやエージェントの振る舞いに逸脱していないこと

次の内容を報告します。

• カテゴリ
• 対象ファイル
• セクションのパス
• 最終的な文言
• ファイルを作成したか更新したか

成功基準：どの永続的なスキル作成用メモリが変更されたかを、ユーザーが正確に確認できること。

ガードレール

• このスキルをモデルが自発的に呼び出さないようにしてください。永続的な学びを変更するためです。
• context: fork を追加しないでください。このワークフローはアクティブなリポジトリを編集します。
• paths: を追加しないでください。汎用的なメンテナンススキルです。
• ルーティングマトリックス、品質スコアカード、長大な失敗一覧を SKILL.md 内に残さないでください。
• ユーザーの明示的な承認なしに学びを追加しないでください。
• .agents/learnings/skill-learnings.md と .claude/learnings/skill-learnings.md の両方を作成しないでください。
• この学びの更新の一環として、実際のスキルファイルを書き換えないでください。

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

• references/learning-scope.md 学びをスキルメモリに含めるべきかの判断、適切なカテゴリの選択、重複への対応、よくある失敗の確認に使用します。

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

出力の契約

次の内容を報告します。

1. 学びが承認されたか、別の場所に案内されたか
2. 選択したカテゴリと対象ファイル
3. 承認された最終的な文言
4. 学びのファイルを作成したか更新したか
5. 重複の統合や正本パスの決定があった場合は、その内容