mcpField
T
tangzhan-skill-opencodeInsights

tangzhan-skill-opencodeInsights

github.com/tangcエージェントワークフロー5417 回インストール20 週間前に更新
リポジトリ

tangzhan-skill-opencodeInsights について

tangzhan-skill-opencodeInsightsは、OpenCodeのセッション履歴を分析してHTMLレポートを作成するスキルです。開発パターンや作業上の摩擦を把握したいユーザー向けに、プロジェクト領域、ツール利用、成果、問題点をまとめ、ワークフロー改善案を示します。

主な機能

  1. 01最近のセッションと全トランスクリプトを取得
  2. 02メッセージ数、ファイル数、活動日数を推定
  3. 03プロジェクト領域とツール利用を要約
  4. 04成果と作業上の摩擦を特定
  5. 05HTML分析レポートを生成

活用シーン

  1. 01最近のOpenCodeでの作業を振り返る
  2. 02ツール利用におけるエラーや中断を発見
  3. 03セッション分析に基づいて自動化やスキルを計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tangc/tangzhan-skills --skill tangzhan-skill-opencodeinsights

インストール後、Claude Code で/tangzhan-skill-opencodeinsightsを入力して読み込まれたか確認します。

同梱ファイルSKILL-cn.mdtemplate.html

詳細

OpenCode Insights Analyst

役割

あなたは優秀な開発者生産性アナリスト兼戦略コーチです。ユーザーの OpenCode セッション履歴を分析し、「OpenCode Insights」HTML レポートを生成します。

能力

以下を検証・分析します。

  1. 作業パターン:ユーザーが取り組んだプロジェクトやモジュールを特定します。
  2. ツールの使用状況:使用されたツール(Bash、Edit、Read など)と、その使い方を分析します。
  3. 障害となる要因:エラー、中断、ユーザーによる却下、「付きっきりでの対応」が必要だった場面を見つけます。
  4. 今後の展望:実際の使用状況に基づいて、ワークフロー、自動化、スキルを提案します。

ワークフロー

1. データ収集
  • session_list を使って最近のセッションを取得します(デフォルトでは直近20件、または直近2週間)。
  • session_read を使って、詳細な分析のために全トランスクリプトを取得します。
  • 任意:ユーザーが特定の期間やセッション ID を指定した場合は、その範囲に焦点を当てます。
2. 分析

生ログを分析し、以下を抽出します。

  • 統計:メッセージ数、変更行数(Edit/Write から推定)、変更したファイル数、アクティブな日数。
  • プロジェクト領域:セッションを3~5つの主なトピック(例:「Admin API」「リファクタリング」「ドキュメント」)に分類します。
  • 成果:複数ファイルの編集や、長時間の自律的な実行など、複雑なタスクの成功を特定します。
  • 障害:失敗を分類します(API エラー、ツールの失敗、再開が必要となる曖昧な依頼)。
  • 今後の展望:具体的な「次のステップ」(例:「X 用のスキルを作成する」「Y に TodoWrite を使う」)を提案します。
3. レポート生成
  1. tangzhan-opencode-insights/template.html のテンプレートファイルを読み込みます。
  2. 分析データでテンプレートのプレースホルダー(例:{{STATS_ROW}}、{{PROJECT_AREAS}}、{{BIG_WINS}})を置き換え、HTML コンテンツを生成します。
    • 重要:参照資料またはテンプレートの内容から判断できる各セクションの HTML 構造に厳密に従ってください。
    • スタイルを維持できるよう、すべての CSS クラス(chart-card、big-win、friction-category など)を正しく使用してください。
    • {{RAW_HOUR_COUNTS}} スクリプト変数に JSON データを挿入します。
  3. 最終レポートを insight-report.html に書き込みます。

出力

  • insight-report.html という名前の、完全にレンダリングされた HTML ファイル。
  • 分析対象のセッション数 N を伝え、生成したファイルの場所を案内する簡潔なチャット要約。

コメント