自己改善スキル
学習内容とエラーをマークダウンファイルに記録し、継続的な改善を実現します。コーディングエージェントは後でこれらを処理して修正に反映でき、重要な学習内容はプロジェクトメモリに昇格されます。
クイックリファレンス
| 状況 | アクション |
|---|---|
| コマンド/操作の失敗 | .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 に記録 |
| 既存のエントリと類似 | **関連** でリンク、優先度の引き上げを検討 |
| 広く適用可能な学習 | 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はこれらのファイルをすべてのセッションに注入します:
~/.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プッシュには事前に認証設定が必要」 |
セッション間通信
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/ からコピーするか、ヘッダー付きのファイルを作成します。
ログ形式
学習エントリ
.learnings/LEARNINGS.md に追記:
## [LRN-YYYYMMDD-XXX] category
**記録日時**: ISO-8601 タイムスタンプ
**優先度**: low | medium | high | critical
**ステータス**: pending
**エリア**: frontend | backend | infra | tests | docs | config
### 概要
学習内容の1行説明
### 詳細
完全なコンテキスト:何が起こったのか、何が間違っていたのか、正しいことは何か
### 推奨アクション
行うべき具体的な修正や改善
### メタデータ
- ソース: conversation | error | user_feedback
- 関連ファイル: path/to/file.ext
- タグ: tag1, tag2
- 関連: LRN-20250110-001(既存のエントリと関連する場合)
---
エラーエントリ
.learnings/ERRORS.md に追記:
## [ERR-YYYYMMDD-XXX] skill_or_command_name
**記録日時**: ISO-8601 タイムスタンプ
**優先度**: high
**ステータス**: pending
**エリア**: frontend | backend | infra | tests | docs | config
### 概要
失敗内容の簡単な説明
### エラー
実際のエラーメッセージまたは出力
### コンテキスト
- 試行したコマンド/操作
- 使用した入力またはパラメータ
- 該当する場合は環境の詳細
### 推奨修正
特定できる場合、問題を解決する方法
### メタデータ
- 再現可能: yes | no | unknown
- 関連ファイル: path/to/file.ext
- 関連: ERR-20250110-001(繰り返し発生する場合)
---
機能要求エントリ
.learnings/FEATURE_REQUESTS.md に追記:
## [FEAT-YYYYMMDD-XXX] capability_name
**記録日時**: ISO-8601 タイムスタンプ
**優先度**: medium
**ステータス**: pending
**エリア**: frontend | backend | infra | tests | docs | config
### 要求された機能
ユーザーがやりたかったこと
### ユーザーのコンテキスト
なぜそれが必要だったのか、どのような問題を解決しているのか
### 複雑さの見積もり
simple | medium | complex
### 推奨実装方法
これをどのように構築できるか、何を拡張するか
### メタデータ
- 頻度: first_time | recurring
- 関連機能: 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
エントリの解決
問題が修正されたら、エントリを更新します:
**ステータス**: pendingを**ステータス**: resolvedに変更- メタデータの後に解決ブロックを追加:
### 解決
- **解決日時**: 2025-01-16T09:00:00Z
- **コミット/PR**: abc123 または #42
- **注釈**: 行われた作業の簡単な説明
その他のステータス値:
in_progress- 現在作業中wont_fix- 対応しない決定(解決注釈に理由を追加)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ワークスペース) |
昇格方法
- 抽出:学習内容を簡潔なルールまたは事実に凝縮する
- 追加:ターゲットファイルの適切なセクションに追加(必要に応じてファイルを作成)
- 更新:元のエントリを更新:
**ステータス**: pendingを**ステータス**: 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 "キーワード" .learnings/ - エントリをリンク: メタデータに
**関連**: ERR-20250110-001を追加 - 優先度を引き上げ:問題が繰り返し発生する場合
- 体系的な修正を検討:繰り返し発生する問題は、多くの場合、以下を示しています:
- ドキュメントの不足(→ CLAUDE.md または .github/copilot-instructions.md に昇格)
- 自動化の不足(→ AGENTS.md に追加)
- アーキテクチャ上の問題(→ 技術的負債チケットを作成)
定期的なレビュー
自然な区切りで .learnings/ をレビューします:
レビューのタイミング
- 新しい主要タスクを開始する前
- 機能を完了した後
- 過去の学習がある分野で作業する場合
- 活発な開発中の毎週
クイックステータスチェック
# pendingアイテムをカウント
grep -h "Status\*\*: pending" .learnings/*.md | wc -l
# pendingの高優先度アイテムを一覧表示
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)
プロジェクトに .claude/settings.json を作成します:
{
"hooks": {
"UserPromptSubmit": [{
"matcher": "",
"hooks": [{
"type": "command",
"command": "./skills/self-improvement/scripts/activator.sh"
}]
}]
}
}
これにより、各プロンプト後に学習評価リマインダーが注入されます(約50〜100トークンのオーバーヘッド)。
フルセットアップ(エラー検出付き)
{
"hooks": {
"UserPromptSubmit": [{
"matcher": "",
"hooks": [{
"type": "command",
"command": "./skills/self-improvement/scripts/activator.sh"
}]
}],
"PostToolUse": [{
"matcher": "Bash",
"hooks": [{
"type": "command",
"command": "./skills/self-improvement/scripts/error-detector.sh"
}]
}]
}
}
利用可能なフックスクリプト
| スクリプト | フックタイプ | 目的 |
|---|---|---|
scripts/activator.sh | UserPromptSubmit | タスク後に学習を評価するようリマインド |
scripts/error-detector.sh | PostToolUse (Bash) | コマンドエラーでトリガー |
詳細な設定とトラブルシューティングについては、references/hooks-setup.md を参照してください。
自動スキル抽出
学習内容が再利用可能なスキルとして十分に価値がある場合、提供されているヘルパーを使用して抽出します。
スキル抽出基準
以下のいずれかが該当する場合、学習はスキル抽出の対象となります:
| 基準 | 説明 |
|---|---|
| 繰り返し | 2つ以上の類似問題への 関連 リンクがある |
| 検証済み | ステータスが resolved で、動作する修正がある |
| 自明でない | 発見に実際のデバッグ/調査が必要だった |
| 広く適用可能 | プロジェクト固有ではない;コードベース全体で有用 |
| ユーザーフラグ付き | ユーザーが「これをスキルとして保存」などと言った |
抽出ワークフロー
- 候補を特定: 学習が抽出基準を満たしている
- ヘルパーを実行(または手動で作成):
./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run ./skills/self-improvement/scripts/extract-skill.sh skill-name - SKILL.mdをカスタマイズ: テンプレートに学習内容を記入
- 学習を更新: ステータスを
promoted_to_skillに設定し、Skill-Pathを追加 - 検証: 新しいセッションでスキルを読み、自己完結していることを確認
手動抽出
手動による抽出を希望する場合は、extract-skill.sh を実行せずに、上記の手順に従うことができます。