ameliore-systeme について
ameliore-systemeは、Claude Codeのローカルな会話履歴を分析し、繰り返される誤り、指示、ワークフロー、タスクを具体的な改善案にまとめるスキルです。会話の記録に基づいてルールやスキルの作成、定型作業の自動化を進めたいユーザー向けです。
主な機能
- 01指定期間の会話履歴を要約
- 02繰り返される誤りや指示を特定
- 03CLAUDE.mdのルールやスキルを提案
- 04定型タスクの自動化を提案
- 05履歴をローカルで読み取り専用処理
活用シーン
- 01複数セッションで繰り返すClaude Codeの誤りを特定
- 02反復するユーザー指示をプロジェクトルールに変換
- 03反復する複数手順のワークフローからスキルを設計
- 04自動化に適した定型タスクを特定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ melvynx/ shared-skills --skill ameliore-systemeインストール後、Claude Code で/ameliore-systemeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdagents/openai.yamlassets/codex-icon.svgscripts/digest.mjs詳細
ameliore-systeme
すべての Claude Code の会話はユーザーのコンピューターに保存されます。セッションごとに 1 つの .jsonl ファイルが
~/.claude/projects/<folder>/ にあります。その履歴を見ると、Claude が何を間違えたか、ユーザーが何を 2 回言わなければならなかったか、毎日どんな作業をやり直しているかがわかります。このスキルは履歴を読み取り、改善策に変えます。
ユーザーが /ameliore-systeme の後に入力した内容:$ARGUMENTS(数字は読み取る日数、既定値は 7 です)。
ユーザーが使う言語で回答します(既定はフランス語です)。
1. 履歴を読む
このスキルのフォルダーにあるダイジェストスクリプトを実行します。読み取り専用で、Markdown ファイルを 1 つ書き出します。
node <this skill folder>/scripts/digest.mjs --days <N> --out /tmp/ameliore-digest.md
次に、/tmp/ameliore-digest.md を最後まで読みます。各セッションには、フォルダー、日付、タイトル、使用したスラッシュコマンド、ツールのエラー、ユーザーが入力したすべてのメッセージが含まれます。生の .jsonl ファイルを 1 つずつ開かないでください。会話全体が含まれていて、コンテキストを圧迫します。正確な箇所を確認する場合に限り、grep を使って 1 つ開いてください。
ダイジェストが切れている(tronqué)場合は、対象日数を減らして再実行します。
2. レポート
チャットで、次の 4 つのセクションを含むレポートを書きます。各項目では、履歴から日付、フォルダー、ユーザー自身の言葉を引用します。履歴にない一般的なヒントは書きません。
- Claude がうまくできていないこと:繰り返し発生する間違い(ユーザーが「違う」「そうじゃない」「前にも言った」「同じ依頼を繰り返す」と言う、または Claude を止めるなど)。それぞれについて、発生回数、引用を 2 つ、修正策として
CLAUDE.mdに追加するルール(そのまま貼り付けられる形)を示します。 - ユーザーが繰り返し伝えていること:複数のセッションでユーザーが伝えている指示(スタイル、ツール、確認事項など)。それぞれを
CLAUDE.mdのルールかスキルにします。 - 作成するスキル:何度も行われている複数ステップのワークフロー。それぞれについて、名前、3 行での動作説明、該当するセッションを示します。
- 自動化する繰り返しタスク:毎日または毎週繰り返されるタスク(同じフォルダー、同じ種類の依頼)。それぞれについて、該当する日付とフォルダー、現在かかっている時間(該当セッションでのメッセージ数とツール数)、自動化方法(スキル、スクリプト、スケジュールタスク、フック)を示します。
最後に、節約できる時間が多い順に変更案の上位 3 つを挙げ、どれを作るか尋ねます。
3. ユーザーが選んだものを作成する
CLAUDE.mdのルール:正確な行を示し、ユーザーが承諾したら~/.claude/CLAUDE.md(すべてのプロジェクト向け)またはプロジェクトのCLAUDE.md(1 つのプロジェクト向け)に追加します。すでにある行は削除しません。- スキル:
~/.claude/skills/<name>/SKILL.mdを作成します(フロントマターにはnameと、起動条件となるフレーズを含むdescriptionを記載し、その後にセッションから得た手順を記載します)。保存する前にユーザーに内容を示します。使用するには/<name>と入力するよう伝えます。 - 自動化:スクリプトまたはスケジュールタスクを作成し、1 回実行して結果を示します。
セッションファイルは削除も編集もしません。履歴を外部に送信しません。すべてコンピューター内に保持します。
メモ
- 週に 1 回か 2 回実行します。各レポートでは、指定された日数分だけを読み取ります。
- ダイジェストにはユーザーが入力した内容だけが残り、Claude の回答は含まれないため、サイズを小さく保てます。ツールのエラーはセッションごとに集計され、Claude がどこで苦戦したかがわかります。