update-claude-learnings

このスキルは永続的な Claude のメモリを更新するものであり、規律を守って実行する必要があります。

譲れないルール：

1. このプロジェクトにおける Claude Code の動作やワークフローに関する学びのみを記録してください。
2. アプリケーションコード、サブエージェント、スキル作成に関する学びは却下し、適切なメンテナンスワークフローに回してください。
3. 書き込む前に、重複または類似する内容がないか確認してください。
4. CLAUDE.md を変更する前に、ユーザーから明示的な確認を得てください。
5. 既存の構成を維持し、必要最小限の適切な指示のみを追加してください。

Claude の学びを更新する

入力

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

目標

次の手順で、検証済みの Claude の動作に関する学びを 1 つ、プロジェクトのメモリに追加します。

• セッションから適切なルールを抽出する
• CLAUDE.md に記載すべき内容かを確認する
• 適切なセクションに配置する
• 周囲のメモリ構成を維持する
• 変更内容を正確に報告する

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

このスキルの対象は、このプロジェクトにおける Claude Code の永続的な動作のみです。

有効な例：

• Claude が特定のスキルを使用すべき状況に関するワークフロールール
• 作業範囲を広げる前に Claude が確認すべき状況に関するルール
• チェックポイント、進捗報告、または停止条件に関するセッション管理ルール
• 今後のセッションを改善する、プロジェクト固有の Claude の動作

無効な例：

• エージェントファイルに記載するほうが適切なアプリケーションの実装ルール
• スキルの学びとして扱うほうが適切なスキル作成のパターン
• 永続的なメモリに残す価値のない、一時的な単発のメモ

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

その学びが CLAUDE.md に属さない場合は、作業を中止し、代わりにどこに記載すべきか伝えてください。

成功基準：その学びが Claude のプロジェクトメモリに永続的に記載すべきものであることが明確です。

ステップ 1：セッションから具体的な学びを 1 つ抽出する

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

ルール：

• 曖昧な内容を複数挙げるより、明確な学びを 1 つ選んでください
• 命令形で記述してください
• 一般的な願望ではなく、具体的な動作に結び付けてください
• すでに存在する、より強い指針によって暗に示されているルールとの重複を避けてください

適切な例：

• 「ユーザーが明示的にコミットを依頼した場合は、手動で git commit するのではなく /commit を使用してください。」
• 「バグ修正を隣接するリファクタリングに広げる前に確認してください。」

不適切な例：

• 「もっと慎重になる。」
• 「よりよいワークフローを使う。」

成功基準：明確な理由があり、実行可能な学びの候補が 1 つに定まっています。

ステップ 2：現在の Claude メモリを確認し、配置先を選ぶ

プロジェクトの CLAUDE.md を読んでください。存在しない場合は、構成の代替として references/claude-md-template.md を使用してください。

適切なセクションを選んでください。

• Workflow Rules
• Session Management
• Scope Control
• Behavioral Patterns

書き込む前に：

• 重複または類似する内容を検索してください
• 類似するルールがすでにある場合は、既存の文言と統合してください
• 新しい指示は短く、該当箇所に限定してください

配置と重複への対処については、references/learning-scope.md を読み込んでください。

成功基準：対象セクションが決まり、重複の可能性も確認済みです。

ステップ 3：ユーザーの確認を得る

CLAUDE.md を編集する前に、次の内容を提示してください。

• カテゴリ
• 最終的な文言
• この学びを抽出した理由
• 配置予定のセクション

確認や文言の調整が必要な場合は、AskUserQuestion を使用してください。

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

成功基準：ユーザーが学びと配置を承認しています。

ステップ 4：CLAUDE.md を更新する

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

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

ルール：

• CLAUDE.md がない場合は、提供されたテンプレートを使って作成し、学びを追加します
• セクションがない場合は、ファイル全体を再構成せず、既存の構成に合う最小限のセクションを作成します
• 既存のドキュメントに合わせて書式を統一します

成功基準：CLAUDE.md の適切な箇所に、承認された学びが反映され、無関係な変更が加わっていないこと。

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

以下を検証します。

• 学びが正確に 1 回追加されていること
• ファイル構造が引き続き適切であること
• 指示が実行可能かつ具体的であること
• 更新内容がエージェントやスキルのメモリ領域に逸脱していないこと

以下を報告します。

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

成功基準：永続的な Claude のメモリに加えられた変更を、ユーザーが正確に確認できること。

ガードレール

• モデルがこのスキルを自発的に呼び出さないようにしてください。永続的なメモリが変更されます。
• context: fork を追加しないでください。このワークフローでは、アクティブなリポジトリを編集します。
• paths: を追加しないでください。これは汎用的なメンテナンススキルです。
• ルーティングマトリクス、品質スコアカード、長大な失敗事例の一覧を SKILL.md にそのまま記載しないでください。
• ユーザーの明示的な承認なしに、学びを追加しないでください。
• 小規模で的を絞った挿入で十分な場合に、CLAUDE.md の大部分を書き換えないでください。

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

• references/learning-scope.md 学びを Claude のメモリに含めるべきかどうかの判断、セクションの配置場所の選択、重複への対処、よくある失敗モードの確認に使用します。

• references/claude-md-template.md CLAUDE.md がない場合、または最小限の互換性のある代替構成が必要な場合にのみ使用します。

出力要件

以下を報告します。

1. 学びが承認されたか、別の場所に誘導されたか
2. 選択したカテゴリとセクション
3. 承認された最終的な文言
4. CLAUDE.md を新規作成したか、更新したか
5. 重複の統合や配置に関する判断