Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

/insights がレスポンスからレポートファイルリンクを省略することがある問題を修正しました。

原文（英語） ​

Fixed /insights sometimes omitting the report file link from its response

概要 ​

/insights コマンドはプロジェクトやセッションに関するインサイト（洞察）レポートを生成しますが、このレポートへのファイルリンクがレスポンスに含まれないことがあるというバグがありました。このアップデートにより、レポートが正常に生成された場合は常にファイルリンクが表示されるようになりました。

基本的な使い方 ​

bash
# インサイトを生成
/insights

# 修正前: ファイルリンクが省略される場合がある
# Generated insights for your project.
# （ファイルリンクが表示されないことがある）

# 修正後: ファイルリンクが常に表示される
# Generated insights for your project.
# Report saved to: ~/.claude/insights/2026-04-10_project-insights.md

実践例 ​

プロジェクトインサイトの活用 ​

bash
# セッション終了前にインサイトを生成
/insights

# 修正後: レポートリンクが確実に表示される
# Report: ~/.claude/insights/2026-04-10_14-30-00_insights.md

# レポートを確認
cat ~/.claude/insights/2026-04-10_14-30-00_insights.md

定期的なインサイト収集 ​

bash
#!/bin/bash
# 毎日のインサイトレポートを収集するスクリプト

generate_daily_insights() {
  echo "日次インサイトを生成中..."
  
  # /insights コマンドを実行（実際のClaude Codeセッション内で実行）
  # 修正後: レポートリンクが常に取得できる
  
  # レポートファイルを確認
  latest_report=$(ls -t ~/.claude/insights/*.md 2>/dev/null | head -1)
  
  if [ -n "$latest_report" ]; then
    echo "レポートが生成されました: $latest_report"
    
    # レポートを確認
    cat "$latest_report"
    
    # バックアップ
    cp "$latest_report" ~/Documents/claude-insights/
  else
    echo "レポートが見つかりません"
  fi
}

generate_daily_insights

インサイトレポートの分析 ​

bash
# 複数のインサイトレポートを比較
ls ~/.claude/insights/

# 最新のレポートを確認
cat $(ls -t ~/.claude/insights/*.md | head -1)

# 特定の期間のインサイトを確認
ls ~/.claude/insights/ | grep "2026-04-"

# レポートからキーワードを検索
grep -l "パフォーマンス" ~/.claude/insights/*.md

チーム共有用のインサイト管理 ​

bash
#!/bin/bash
# チーム共有用にインサイトを整理するスクリプト

organize_insights() {
  local output_dir="$1"
  local insights_dir="${HOME}/.claude/insights"
  
  mkdir -p "$output_dir"
  
  # 最新のインサイトをコピー
  for report in $(ls -t "$insights_dir"/*.md | head -10); do
    filename=$(basename "$report")
    cp "$report" "$output_dir/$filename"
    echo "コピー: $filename"
  done
  
  # サマリーを生成
  echo "# インサイトサマリー" > "$output_dir/SUMMARY.md"
  echo "生成日: $(date)" >> "$output_dir/SUMMARY.md"
  echo "" >> "$output_dir/SUMMARY.md"
  
  for report in $(ls "$output_dir"/*.md | grep -v SUMMARY); do
    echo "## $(basename $report)" >> "$output_dir/SUMMARY.md"
    head -5 "$report" >> "$output_dir/SUMMARY.md"
    echo "" >> "$output_dir/SUMMARY.md"
  done
  
  echo "インサイトを整理しました: $output_dir"
}

organize_insights "/tmp/team-insights"

インサイトの活用パターン ​

bash
# 週次レビュー用のインサイト
# 週に一度、セッションのインサイトを確認して改善点を把握

# プロジェクト開始時
/insights  # ベースラインを確認

# 実装後
/insights  # 進捗と変化を確認

# 修正後: リンクが確実に表示されるため、レポートを見逃さない
# ~/.claude/insights/2026-04-10_insights.md が作成される

注意点 ​

  • このバグは /insights がレポートを生成したにもかかわらず、リンクの表示を省略していた問題です
  • 修正後は、レポートが正常に生成されれば常にファイルリンクが表示されます
  • レポートの生成自体に失敗した場合は、引き続きエラーメッセージが表示されます
  • インサイトレポートは ~/.claude/insights/ ディレクトリに保存されます
  • 古いレポートは定期的にクリーンアップされる場合があります（cleanupPeriodDays 設定による）

関連情報 ​