Agent skill · writing content · xtone
lessons
CLAUDE.mdの「Lessons Learned」セクションを管理するスキル。`/lessons` で学びを追記、`/lessons review` で既存ルールのレビュー・整理を行う。セッション中の修正・失敗・発見を構造的に蓄積し、チーム全体の知見として共有する。「CLAUDE.mdを更新して」「学びを記録して」等の自然言語でも起動可能。
Why this skill is useful
Adds structured procedures for documenting lessons learned during sessions, which the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-06-05. 3 stars on the source repository.
What this skill does
Lessons MD Manager CLAUDE.mdの「Lessons Learned」セクションを管理するスキル。セッション中の学びを構造的に蓄積し、チーム全体の知見として共有する。 目的 Boris Cherny氏のTip #3「CLAUDE.mdへの投資」を仕組み化: セッション中の修正・失敗・発見をCLAUDE.mdに自動蓄積 同じミスの繰り返しを防止（複利効果） チーム全員が即座に恩恵を受けられる知見共有 トリガー /lessons - セッション中の学びをCLAUDE.mdに追記（追加モード） /lessons review - 既存ルールのレビュー・整理（レビューモード） 「CLAUDE.mdを更新して」「学びを記録して」等の自然言語 System Instructions モード判定 引数を確認し、動作モードを決定する: 引数なし or add: 追加モード（デフォルト） review: レビューモード --- 追加モード ステップ1: CLAUDE.mdの読み込み 1. 現在のプロジェクトルート（gitルート）を特定する 2. プロジェクトルートの CLAUDE.md を読み込む 3. ファイルが存在しない場合、以下の初期テンプレートで作成を提案する: ステップ2: Session Rulesの確認 1. ## Session Rules セクションを探す 2. セクションが存在しない、または /lessons 提案ルールが含まれていない場合: 以下のルールを追加することをユーザーに提案する - セッション終了前に /lessons の実行を提案すること このルールにより、以降のセッションでClaudeがセッション終了時に自動で /lessons を提案するようになる 3. ユーザーが承認した場合、CLAUDE.mdに追記する ステップ3: Lessons Learnedセクションの特定 1. ## Lessons Learned セクションを探す 2. セクションが存在しない場合、CLAUDE.mdの末尾に ## Lessons Learned を追加する 3. 既存のサブカテゴリ（### テスト、### ビルド・環境 等）を把握する ステップ4: 会話履歴からの学び抽出 以下のシグナルを手がかりに、今回のセッションの学びを抽出する: 抽出対象のシグナル: エラーが発生し、修正した箇所 最初のアプローチが失敗し、別の方法に切り替えた箇所 ユーザーが指摘した誤り・修正 「実は〜だった」「〜が必要だった」等の発見 ビルド・テスト失敗の原因と解決策 APIやライブラリの予想外の挙動 プロジェクト固有の規約・パターンの発見 除外対象: 一般的な知識（公式ドキュメントに書いてあること） 一時的な問題（ネットワークエラー等） ユーザー個人の好み（コーディングスタイル等、明示的に記録を求められた場合を除く） ステップ5: 重複チェック 1. 抽出した学びと既存の Lessons Learned エントリを比較する 2. 意味的に同一の内容（表現が異なっても同じ教訓）は重複として除外する 3. 既存エントリを補強・具体化する内容は、更新案として提示する ステップ6: カテゴリ自動判定 学びの内容に応じてカテゴリを自動判定する: カテゴリ 判定基準 --------- --------- テスト テストコード、Mock、アサーション、テストライブラリ関連 ビルド・環境 Gradle、JAVAHOME、依存関係、CI/CD関連 コード規約 型、命名、パッケージ構造、アーキテクチャパターン関連 アーキテクチャ レイヤー構造、依存方向、設計パターン関連 API APIレスポンス、ネスト型、シリアライズ関連 ツール Claude Code、IDE、Git、外部ツール関連 既存カテゴリがある場合はそれに合わせる。新カテゴリが必要な場合は提案する。 ステップ7: 追記案の生成と確認 1. 以下のフォーマットで追記案を生成する 2. ユーザーに追記案を提示し、承認を求める 3. 承認されたらCLAUDE.mdに書き込む 追記フォーマット: 記述の品質基準: 「〜しないこと」ではなく「〜を使うこと」（肯定形推奨） 具体的なコード例やクラス名を含める なぜそうすべきかの理由を添える プロジェクト固有の型名・クラス名を明記する 1行1ルールで、他の人が読んですぐ実行できる粒度にする 良い例: 悪い例: ステップ8: CLAUDE.mdへの書き込み 1. 承認された内容をCLAUDE.mdに書き込む 2. 既存カテゴリに追記する場合は、そのカテゴリの末尾に追加する 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills xtone/lessons-md-manager