mentor

Mentor — エージェントとの作業方法に関する/insightsスタイルのレポート

これが存在する理由

エージェントは今や、かつてジュニアが担っていた仕事をこなします。しかし、ジュニアがシニアへと成長できたのは、シニアからフィードバックを受けていたからです。ジュニアにエージェントを与えてシニアを解雇すれば、そのフィードバックループは失われます。このスキルは、そのループそのものです。ローカルに保存されたあなた自身のセッション履歴を読み取り、あなたが何を作っているのか、どこで時間を失っているのか、上達するためにどのような具体的な変更をすればよいのかをまとめたレポートを1つ返します。トークンを節約することではなく、効果を重視します。

成果物は、常にレンダリング済みのreport.htmlファイルです。 8セクションの分析は中間生成物で、analysis.jsonに書き込まれてレンダリングされます。チャットに貼り付けてはいけません。分析テキストを延々と返信することこそ、このスキルが解決するために存在する失敗です。スクリプトを実行できない場合は、率直にそう伝えてください。テキストによる要約で代用してはいけません。Claude Code組み込みの/insightsをモデルにしています。

エージェント

エージェント	引数	ログ
Claude Code	claude	~/.claude/projects/<slug>/<uuid>.jsonl
OpenAI Codex	codex	~/.codex/sessions/**/rollout-*.jsonl（および~/.codex/archived_sessions/）
両方	both（デフォルト）	2つのログの和集合

ワークフロー — レポートの作成

1. 収集 対象期間内のすべてのセッションを1つの統計バンドルにまとめます（決定的）：

   uv run --no-project python ~/.claude/skills/mentor/scripts/collect.py \
     --agent <claude|codex|both> --days <N> --out /tmp/mentor-stats.json
   

   デフォルトは--agent both --days 30です。stats.jsonを書き出し、主要な数値、ツールの内訳、言語、プロジェクト、各セッションの改変していない最初のプロンプトを簡潔にまとめて表示します。そのダイジェストを読んでください。そこに根拠があります。

2. 8つのセクションに分析をまとめます。 まずreferences/best-practices.mdを読み、基準となる指針を確認します。次に、/tmp/mentor-analysis.jsonを書き出します（スキーマは/tmp/mentor-analysis.jsonの/tmp/mentor-analysis.jsonではなく、/tmp/mentor-analysis.jsonではなく、scripts/render_report.pyのヘッダーに記載されています）。 各主張は、ダイジェストの内容（数値、プロジェクト名、プロンプトのパターン）に基づかせてください。8つのセクションは/insightsに対応しています：

   • what_you_work_on — セッションをテーマごとに分類し、おおよその割合を示します。
   • how_you_use — パターン：ツールの比率（Bash/execとReadの比較）、言語、両エージェントの利用内訳、チェックポイント。
   • impressive — 実際にうまくいったことを、本人に伝えます。
   • friction — 時間が失われている箇所です。各項目に問題、根拠、具体的な修正策を記載します。このセクションがレポートの価値を決めます。
   • features_to_try — まだ十分に活用されていない既存の機能です。
   • claude_md_additions — 繰り返し発生する摩擦を解消する、コピーして貼り付けられるCLAUDE.mdの行です。
   • new_ways — エージェントの新しい活用方法です。
   • on_the_horizon — ワークフローが今後どのように進んでいくかです。 また、お世辞を言わず、何が妨げになっているかを明示したsummaryも作成します。

3. レンダリング 自己完結型のHTMLを作成します：

   uv run --no-project python ~/.claude/skills/mentor/scripts/render_report.py \
     --stats /tmp/mentor-stats.json --analysis /tmp/mentor-analysis.json \
     --out ~/.claude/usage-data/mentor-report.html
   

4. ファイルを渡します。 ~/.claude/usage-data/mentor-report.htmlを開くか、ユーザーに渡します： Claude Codeでは、表示モードをrenderにしてSendUserFileを使います。Codexまたはシェルでは、ファイルを開き（open <path>）、パスを表示します。その後、口頭で伝えるのは最大2行までとし、最も効果の高い修正策を1つだけ伝えます。詳細はレポートに記載し、チャットでは繰り返しません。

クイック単一セッションモード（明示的に依頼された場合のみ）

ユーザーが1つのセッションを明示的に指定した場合（「このセッションを分析して」）に限り、収集とレンダリングを省略してセッションごとのダイジェストを実行し、短い分析（要約、うまくいったこと、足を引っ張ったこと、1つの習慣）を返します。「自分のセッションを分析して」や「/mentor」の場合は、必ず上記のレポートパイプラインを使います。

uv run --no-project python ~/.claude/skills/mentor/scripts/digest.py <path|last> --agent <claude|codex>

ルール

• report.html が回答です。8 つのセクションをチャットメッセージとして貼り付けないでください。
• 作成されたコードではなく、プロセスを分析してください。作成したものを再レビューしないでください。
• 根拠がなければ事実ではありません。すべてのセクションを統計ダイジェスト（数値、プロジェクト、プロンプト）に結び付けてください。一般論にしないでください。
• Codex はほとんどすべてを 1 つの exec ツール経由で実行するため、exec の使用頻度が高いのは通常です。ツール名ではなく、編集前に読み取っているかを評価してください。
• 一部の判断（満足度、テーマ）はモデルによる推定です。レポートのフッターですでにその旨を明示しているため、断定しすぎないでください。
• レポートの本文はユーザーの言語で書き、指定がなければ英語を使ってください。分析の lang フィールドを ("en" | "ru") に設定し、静的な表示要素の言語も一致させてください。文章は明快で具体的にし、AI らしい空疎な表現は避けてください。ロシア語の場合は、humanizer-ru の基準を守ってください。
• 摩擦点のセクションが要です。それぞれの摩擦点に、コピーしてすぐ使える具体的な対策（CLAUDE.md の 1 行、フック、習慣）を示してください。