自己改善スキル
学びとエラーをマークダウンファイルに記録し、継続的な改善を実現します。コーディングエージェントは後でこれらを処理して修正に反映し、重要な学びはプロジェクトメモリに昇格されます。
クイックリファレンス
| 状況 | アクション |
|---|---|
| コマンド/操作が失敗 | .learnings/ERRORS.md に記録 |
| ユーザーが修正 | カテゴリ correction で .learnings/LEARNINGS.md に記録 |
| ユーザーが不足機能を要求 | .learnings/FEATURE_REQUESTS.md に記録 |
| API/外部ツールが失敗 | 統合詳細とともに .learnings/ERRORS.md に記録 |
| 知識が古かった | カテゴリ knowledge_gap で .learnings/LEARNINGS.md に記録 |
| より良いアプローチを発見 | カテゴリ best_practice で .learnings/LEARNINGS.md に記録 |
| 繰り返しパターンを簡略化/堅牢化 | Source: simplify-and-harden と安定した Pattern-Key で .learnings/LEARNINGS.md に記録/更新 |
| 既存のエントリと類似 | **See Also** でリンク、優先度の引き上げを検討 |
| 広く適用可能な学び | CLAUDE.md、AGENTS.md、および/または .github/copilot-instructions.md に昇格 |
| ワークフローの改善 | AGENTS.md に昇格(OpenClawワークスペース) |
| ツールの落とし穴 | TOOLS.md に昇格(OpenClawワークスペース) |
| 行動パターン | SOUL.md に昇格(OpenClawワークスペース) |
OpenClaw セットアップ(推奨)
OpenClaw はこのスキルの主要プラットフォームです。ワークスペースベースのプロンプトインジェクションと自動スキル読み込みを提供します。
インストール
ClawdHub 経由(推奨):
clawdhub install self-improving-agent
手動:
git clone https://github.com/peterskoett/self-improving-agent.git ~/.openclaw/skills/self-improving-agent
OpenClaw 向けに元のリポジトリからリメイク: https://github.com/pskoett/pskoett-ai-skills - https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-improvement
ワークスペース構造
OpenClaw は以下のファイルをすべてのセッションに注入します:
~/.openclaw/workspace/
├── AGENTS.md # マルチエージェントワークフロー、委任パターン
├── SOUL.md # 行動ガイドライン、性格、原則
├── TOOLS.md # ツール機能、統合の落とし穴
├── MEMORY.md # 長期記憶(メインセッションのみ)
├── memory/ # 日次メモリファイル
│ └── YYYY-MM-DD.md
└── .learnings/ # このスキルのログファイル
├── LEARNINGS.md
├── ERRORS.md
└── FEATURE_REQUESTS.md
学習ファイルの作成
mkdir -p ~/.openclaw/workspace/.learnings
次に、ログファイルを作成します(または assets/ からコピー):
LEARNINGS.md— 修正、知識のギャップ、ベストプラクティスERRORS.md— コマンドの失敗、例外FEATURE_REQUESTS.md— ユーザーが要求した機能
昇格ターゲット
学びが広く適用可能であることが証明されたら、ワークスペースファイルに昇格します:
| 学習タイプ | 昇格先 | 例 |
|---|---|---|
| 行動パターン | SOUL.md | "簡潔に、免責事項は避ける" |
| ワークフローの改善 | AGENTS.md | "長いタスクにはサブエージェントを起動する" |
| ツールの落とし穴 | TOOLS.md | "Git push は事前に認証設定が必要" |
セッション間通信
OpenClaw はセッション間で学びを共有するためのツールを提供します:
- sessions_list — アクティブ/最近のセッションを表示
- sessions_history — 別のセッションのトランスクリプトを読む
- sessions_send — 別のセッションに学びを送信
- sessions_spawn — バックグラウンド作業用にサブエージェントを起動
オプション: フックの有効化
セッション開始時に自動リマインダーを設定するには:
# フックを OpenClaw フックディレクトリにコピー
cp -r hooks/openclaw ~/.openclaw/hooks/self-improvement
# 有効化
openclaw hooks enable self-improvement
完全な詳細は references/openclaw-integration.md を参照してください。
汎用セットアップ(他のエージェント)
Claude Code、Codex、Copilot、または他のエージェントの場合、プロジェクトに .learnings/ を作成します:
mkdir -p .learnings
assets/ からテンプレートをコピーするか、ヘッダー付きのファイルを作成します。
エージェントファイルへの参照を追加
学習を記録するように自分自身にリマインドするために、AGENTS.md、CLAUDE.md、または .github/copilot-instructions.md への参照を追加します。(これはフックベースのリマインダーの代替です)
自己改善ワークフロー
エラーや修正が発生した場合:
.learnings/ERRORS.md、LEARNINGS.md、またはFEATURE_REQUESTS.mdに記録- 広く適用可能な学びをレビューし、以下に昇格:
CLAUDE.md- プロジェクトの事実と規約AGENTS.md- ワークフローと自動化.github/copilot-instructions.md- Copilot コンテキスト
ログ形式
学習エントリ
.learnings/LEARNINGS.md に追記:
## [LRN-YYYYMMDD-XXX] category
**Logged**: ISO-8601 timestamp
**Priority**: low | medium | high | critical
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config
### Summary
学んだことの一行説明
### Details
完全なコンテキスト: 何が起こったか、何が間違っていたか、何が正しいか
### Suggested Action
解決すべき具体的な修正または改善
### Metadata
- Source: conversation | error | user_feedback
- Related Files: path/to/file.ext
- Tags: tag1, tag2
- See Also: LRN-20250110-001 (既存エントリに関連する場合)
- Pattern-Key: simplify.dead_code | harden.input_validation (オプション、繰り返しパターン追跡用)
- Recurrence-Count: 1 (オプション)
- First-Seen: 2025-01-15 (オプション)
- Last-Seen: 2025-01-15 (オプション)
---
エラーエントリ
.learnings/ERRORS.md に追記:
## [ERR-YYYYMMDD-XXX] skill_or_command_name
**Logged**: ISO-8601 timestamp
**Priority**: high
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config
### Summary
失敗した内容の簡単な説明
### Error
実際のエラーメッセージまたは出力
### Context
- 試行したコマンド/操作
- 使用した入力またはパラメータ
- 関連する場合は環境の詳細
### Suggested Fix
特定できる場合、これを解決する方法
### Metadata
- Reproducible: yes | no | unknown
- Related Files: path/to/file.ext
- See Also: ERR-20250110-001 (繰り返しの場合)
---
機能要求エントリ
.learnings/FEATURE_REQUESTS.md に追記:
## [FEAT-YYYYMMDD-XXX] capability_name
**Logged**: ISO-8601 timestamp
**Priority**: medium
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config
### Requested Capability
ユーザーが行いたかったこと
### User Context
なぜそれが必要だったか、どのような問題を解決していたか
### Complexity Estimate
simple | medium | complex
### Suggested Implementation
どのように構築できるか、何を拡張するか
### Metadata
- Frequency: first_time | recurring
- Related Features: existing_feature_name
---
ID 生成
形式: TYPE-YYYYMMDD-XXX
- TYPE:
LRN(学習),ERR(エラー),FEAT(機能) - YYYYMMDD: 現在の日付
- XXX: 連番またはランダム3文字(例:
001,A7B)
例: LRN-20250115-001, ERR-20250115-A3F, FEAT-20250115-002
エントリの解決
問題が修正されたら、エントリを更新します:
**Status**: pendingを**Status**: resolvedに変更- Metadata の後に解決ブロックを追加:
### Resolution
- **Resolved**: 2025-01-16T09:00:00Z
- **Commit/PR**: abc123 or #42
- **Notes**: 行われたことの簡単な説明
その他のステータス値:
in_progress- 現在作業中wont_fix- 対応しないと決定(Resolution ノートに理由を追加)promoted- CLAUDE.md、AGENTS.md、または .github/copilot-instructions.md に昇格済み
プロジェクトメモリへの昇格
学びが広く適用可能な場合(一度きりの修正ではない場合)、永続的なプロジェクトメモリに昇格します。
昇格するタイミング
- 学びが複数のファイル/機能に適用される場合
- すべてのコントリビューター(人間またはAI)が知っておくべき知識
- 繰り返し発生する間違いを防ぐ
- プロジェクト固有の規約を文書化する
昇格ターゲット
| ターゲット | そこに属するもの |
|---|---|
CLAUDE.md | すべての Claude インタラクションのためのプロジェクトの事実、規約、落とし穴 |
AGENTS.md | エージェント固有のワークフロー、ツール使用パターン、自動化ルール |
.github/copilot-instructions.md | GitHub Copilot のためのプロジェクトコンテキストと規約 |
SOUL.md | 行動ガイドライン、コミュニケーションスタイル、原則(OpenClawワークスペース) |
TOOLS.md | ツール機能、使用パターン、統合の落とし穴(OpenClawワークスペース) |
昇格方法
- 抽出 学びを簡潔なルールまたは事実に
- 追加 ターゲットファイルの適切なセクションに(必要に応じてファイルを作成)
- 更新 元のエントリ:
**Status**: pendingを**Status**: promotedに変更**Promoted**: CLAUDE.md、AGENTS.md、または.github/copilot-instructions.mdを追加
昇格例
学習(冗長):
プロジェクトは pnpm ワークスペースを使用。
npm installを試みたが失敗。 ロックファイルはpnpm-lock.yaml。pnpm installを使用する必要がある。
CLAUDE.md 内(簡潔):
## ビルドと依存関係
- パッケージマネージャー: pnpm(npm ではありません)- `pnpm install` を使用
学習(冗長):
API エンドポイントを変更する場合、TypeScript クライアントを再生成する必要がある。 これを忘れると、実行時に型の不一致が発生する。
AGENTS.md 内(実用的):
## API 変更後
1. クライアントを再生成: `pnpm run generate:api`
2. 型エラーを確認: `pnpm tsc --noEmit`
繰り返しパターン検出
既存のエントリと類似したものを記録する場合:
- まず検索:
grep -r "keyword" .learnings/ - エントリをリンク: Metadata に
**See Also**: ERR-20250110-001を追加 - 優先度を引き上げる: 問題が繰り返し発生する場合
- 体系的な修正を検討: 繰り返し発生する問題は、多くの場合以下を示す:
- ドキュメントの欠如(→ CLAUDE.md または .github/copilot-instructions.md に昇格)
- 自動化の欠如(→ AGENTS.md に追加)
- アーキテクチャ上の問題(→ 技術的負債チケットを作成)
Simplify & Harden フィード
このワークフローを使用して、simplify-and-harden スキルからの繰り返しパターンを取り込み、耐久性のあるプロンプトガイダンスに変換します。
取り込みワークフロー
- タスク概要から
simplify_and_harden.learning_loop.candidatesを読み取る。 - 各候補について、安定した重複排除キーとして
pattern_keyを使用する。 .learnings/LEARNINGS.mdでそのキーを持つ既存のエントリを検索:grep -n "Pattern-Key: <pattern_key>" .learnings/LEARNINGS.md
- 見つかった場合:
Recurrence-CountをインクリメントLast-Seenを更新- 関連するエントリ/タスクに
See Alsoリンクを追加
- 見つからない場合:
- 新しい
LRN-...エントリを作成 Source: simplify-and-hardenを設定Pattern-Key、Recurrence-Count: 1、First-Seen/Last-Seenを設定
- 新しい
昇格ルール(システムプロンプトフィードバック)
以下のすべてが真の場合、繰り返しパターンをエージェントコンテキスト/システムプロンプトファイルに昇格します:
Recurrence-Count >= 3- 少なくとも2つの異なるタスクで確認されている
- 30日以内に発生している
昇格ターゲット:
CLAUDE.mdAGENTS.md.github/copilot-instructions.md- 該当する場合、OpenClaw ワークスペースレベルのガイダンスとして
SOUL.md/TOOLS.md
昇格されたルールは、長いインシデントレポートではなく、短い予防ルール(コーディング前/中に何をするか)として記述します。
定期レビュー
自然な区切りで .learnings/ をレビューします:
レビューのタイミング
- 新しい主要タスクを始める前
- 機能を完了した後
- 過去の学びがある領域で作業する場合
- アクティブな開発中は毎週
クイックステータス確認
# 保留中のアイテムをカウント
grep -h "Status\*\*: pending" .learnings/*.md | wc -l
# 優先度が高い保留中アイテムを一覧表示
grep -B5 "Priority\*\*: high" .learnings/*.md | grep "^## \["
# 特定のエリアの学びを検索
grep -l "Area\*\*: backend" .learnings/*.md
レビューアクション
- 修正されたアイテムを解決
- 該当する学びを昇格
- 関連エントリをリンク
- 繰り返し発生する問題をエスカレート
検出トリガー
以下の状況に気づいたら、自動的に記録します:
修正(→ カテゴリ correction の学習):
- "いいえ、それは違います..."
- "実際には、こうすべきです..."
- "あなたの言っていることは間違っています..."
- "それは古い情報です..."
機能要求(→ 機能要求):
- "〜もできますか..."
- "〜ができたらいいのに..."
- "〜する方法はありますか..."
- "なぜ〜できないのですか..."
知識のギャップ(→ カテゴリ knowledge_gap の学習):
- ユーザーがあなたの知らなかった情報を提供
- 参照したドキュメントが古い
- API の動作があなたの理解と異なる
エラー(→ エラーエントリ):
- コマンドがゼロ以外の終了コードを返す
- 例外またはスタックトレース
- 予期しない出力または動作
- タイムアウトまたは接続失敗
優先度ガイドライン
| 優先度 | 使用するタイミング |
|---|---|
critical | コア機能をブロック、データ損失のリスク、セキュリティ問題 |
high | 大きな影響、一般的なワークフローに影響、繰り返し発生する問題 |
medium | 中程度の影響、回避策あり |
low | 軽微な不便、エッジケース、あると便利 |
エリアタグ
コードベースの領域で学びをフィルタリングするために使用:
| エリア | 範囲 |
|---|---|
frontend | UI、コンポーネント、クライアントサイドコード |
backend | API、サービス、サーバーサイドコード |
infra | CI/CD、デプロイ、Docker、クラウド |
tests | テストファイル、テストユーティリティ、カバレッジ |
docs | ドキュメント、コメント、README |
config | 設定ファイル、環境、設定 |
ベストプラクティス
- すぐに記録 - 問題の直後が最もコンテキストが新鮮
- 具体的に - 将来のエージェントが迅速に理解する必要がある
- 再現手順を含める - 特にエラーの場合
- 関連ファイルをリンク - 修正が容易になる
- 具体的な修正を提案 - 単に「調査する」だけではない
- 一貫したカテゴリを使用 - フィルタリングを可能にする
- 積極的に昇格 - 迷ったら、CLAUDE.md または .github/copilot-instructions.md に追加
- 定期的にレビュー - 古くなった学びは価値を失う
Gitignore オプション
学習をローカルに保持(開発者ごと):
.learnings/
学習をリポジトリで追跡(チーム全体): .gitignore に追加しないでください。学習は共有知識になります。
ハイブリッド(テンプレートを追跡、エントリを無視):
.learnings/*.md
!.learnings/.gitkeep
フック統合
エージェントフックを通じて自動リマインダーを有効にします。これはオプトインです。フックを明示的に設定する必要があります。
クイックセットアップ(Claude Code / Codex)
...