tangzhan-skill-opencodeInsights について
tangzhan-skill-opencodeInsightsは、OpenCodeのセッション履歴を分析してHTMLレポートを作成するスキルです。開発パターンや作業上の摩擦を把握したいユーザー向けに、プロジェクト領域、ツール利用、成果、問題点をまとめ、ワークフロー改善案を示します。
主な機能
- 01最近のセッションと全トランスクリプトを取得
- 02メッセージ数、ファイル数、活動日数を推定
- 03プロジェクト領域とツール利用を要約
- 04成果と作業上の摩擦を特定
- 05HTML分析レポートを生成
活用シーン
- 01最近のOpenCodeでの作業を振り返る
- 02ツール利用におけるエラーや中断を発見
- 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 レポートを生成します。
能力
以下を検証・分析します。
- 作業パターン:ユーザーが取り組んだプロジェクトやモジュールを特定します。
- ツールの使用状況:使用されたツール(Bash、Edit、Read など)と、その使い方を分析します。
- 障害となる要因:エラー、中断、ユーザーによる却下、「付きっきりでの対応」が必要だった場面を見つけます。
- 今後の展望:実際の使用状況に基づいて、ワークフロー、自動化、スキルを提案します。
ワークフロー
1. データ収集
session_listを使って最近のセッションを取得します(デフォルトでは直近20件、または直近2週間)。session_readを使って、詳細な分析のために全トランスクリプトを取得します。- 任意:ユーザーが特定の期間やセッション ID を指定した場合は、その範囲に焦点を当てます。
2. 分析
生ログを分析し、以下を抽出します。
- 統計:メッセージ数、変更行数(Edit/Write から推定)、変更したファイル数、アクティブな日数。
- プロジェクト領域:セッションを3~5つの主なトピック(例:「Admin API」「リファクタリング」「ドキュメント」)に分類します。
- 成果:複数ファイルの編集や、長時間の自律的な実行など、複雑なタスクの成功を特定します。
- 障害:失敗を分類します(API エラー、ツールの失敗、再開が必要となる曖昧な依頼)。
- 今後の展望:具体的な「次のステップ」(例:「X 用のスキルを作成する」「Y に TodoWrite を使う」)を提案します。
3. レポート生成
tangzhan-opencode-insights/template.htmlのテンプレートファイルを読み込みます。- 分析データでテンプレートのプレースホルダー(例:
{{STATS_ROW}}、{{PROJECT_AREAS}}、{{BIG_WINS}})を置き換え、HTML コンテンツを生成します。- 重要:参照資料またはテンプレートの内容から判断できる各セクションの HTML 構造に厳密に従ってください。
- スタイルを維持できるよう、すべての CSS クラス(
chart-card、big-win、friction-categoryなど)を正しく使用してください。 {{RAW_HOUR_COUNTS}}スクリプト変数に JSON データを挿入します。
- 最終レポートを
insight-report.htmlに書き込みます。
出力
insight-report.htmlという名前の、完全にレンダリングされた HTML ファイル。- 分析対象のセッション数 N を伝え、生成したファイルの場所を案内する簡潔なチャット要約。
コメント
Markdown 対応