self-improvement について
self-improvementは、リポジトリのドキュメントやスキルにフィードバックや修正を記録するスキルです。変更を分類し、編集前に確認を求め、現在の作業ブランチに更新を反映します。
主な機能
- 01フィードバックと対象ファイルの分類
- 02変更内容の提示と事前確認
- 03ドキュメントとスキルの更新
- 04新しいスキルの作成と登録
- 05修正箇所を複数ファイルで確認
活用シーン
- 01実装中に見つけた誤りの記録
- 02リポジトリ内で繰り返すパターンの文書化
- 03複数手順のワークフローをスキル化
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/self-improvementを入力して読み込まれたか確認します。
同梱ファイルreferences/classification.mdtests.yaml
詳細
自己改善スキル
フィードバックや修正内容を記録し、リポジトリに関する知識を継続的に充実させます。
基本方針
作業中に得た知識はすぐに記録し、失わないようにします。その知識をもたらした作業とドキュメントの更新は並行して行います。別の PR ではなく、現在のブランチに含めてください。
実行フロー
フェーズ 1：フィードバックを分類する
適切なファイルを見つけるための、シグナル → 分類 → 対象の対応関係と判断ツリーの全容については、references/classification.md を参照してください。
概要：修正は既存のドキュメントを直します。新しいパターンはモジュールの CLAUDE.md またはスキルに追加します。アンチパターンはルートの CLAUDE.md に追加します。5 ステップ以上のワークフローはスキルにします。
フェーズ 2：適用前に確認する
更新を行う前に、必ず AskUserQuestion を使用してください。 次の内容を提示します。
- 分類したフィードバックの種類と、更新先として提案する場所
- 提案する変更のプレビュー
- 判断に迷う場合は、代替案
フェーズ 3：更新を適用する
CLAUDE.md の更新：ファイルを読み、適切なセクションを見つけ、既存のスタイルと構成を保ちながら内容を追加します。
スキルの更新：既存の SKILL.md を読み、該当するセクションを特定して追加または変更し、必要に応じて参照先を更新します。
新しいスキル：適切なフロントマターを含む SKILL.md を作成し、.claude/agents/ 内の関連するエージェントの skills: リストに追加して、.claude/settings.json の許可リストに追加します。
修正：誤った情報がある箇所をすべて見つけて修正し、参照先が壊れていないことを確認します。
配置に迷う場合は推測せずに質問してください。対象ファイルが存在しない場合は、新規作成するか別の場所を探すかを確認してください。更新内容が大規模（セクションの書き換えなど）になる場合は、変更全体をプレビューし、独立したスキルにすべきか検討してください。
PR ワークフローとの連携
ドキュメントの更新は現在の作業の一部です。関連するコード変更とドキュメント変更は、同じコミットにまとめてください。実装中に新しいパターンが見つかった場合は、ドキュメントの更新を積極的に提案してください。
積極的な呼び出し
次の場合にこのスキルを呼び出します。
- 新しいパターンが生まれた実装作業を完了したとき
- 同じ概念を 2 回説明したとき（記録してください）
- タスクの途中でユーザーがアプローチを修正したとき
- ドキュメント化されていない動作を発見したとき
相互参照
- references/classification.md — フィードバック分類表と更新先を選ぶための判断ツリー