mirror of
https://github.com/xtone/ai_development_tools.git
synced 2026-09-14 20:07:12 +08:00
masaya ishihara
d9747eaf60
* feat: add evaluate-session skill (by Gunshima) to common-development 郡嶋開発のセッション効率評価Webツールをcommon_developmentプラグインに追加。 Node.js Web UIでセッションログを7観点100点満点でスコアリングし、改善提案を出力する。 利用ガイド（docs/session-evaluator-guide.md）も作成。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: address security review findings in session-evaluator - Critical: Add path traversal prevention (validate ~/.claude/ prefix) - Major: Use unique temp file names to prevent race conditions - Major: Remove unnecessary shell: true from spawn Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: validate both jsonlPath and folderPath individually, add sessions endpoint path validation - Critical: Validate jsonlPath and folderPath separately to prevent bypass - Major: Add path traversal protection to /api/sessions/:projectEncoded Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Common Development Skills
プラットフォーム非依存の汎用開発スキル集。Android, iOS, Web, バックエンドなど、あらゆるプロジェクトで使える共通ツールです。
インストール
# マーケットプレイスを追加
/plugin marketplace add xtone/ai_development_tools
# プラグインをインストール
/plugin install common-development@xtone-ai-development-tools
スキル一覧
| スキル | 説明 |
|---|---|
| video-keyframe-analyzer | 動画からキーフレームを抽出してコスト効率的に分析（API コスト93%削減） |
| lessons-md-manager | CLAUDE.mdの「Lessons Learned」セクションを管理。セッション中の学びを自動抽出・蓄積 |
| review-feedback-learner | PRレビューで受けた指摘をCLAUDE.mdのルールとして蓄積。レビュアーの暗黙知をチーム資産に |
| evaluate-session | セッションの効率を7観点100点満点でスコアリング。Web UIでセッション選択→分析→改善提案（郡嶋 開発） |
スキル詳細
video-keyframe-analyzer
動画を全フレーム読み込むと高コストになるため、差分検出により重要なフレームのみを抽出。
使い方:
/video-keyframe-analyzer
画面遷移の動画を分析したい。
動画: ~/Downloads/screen_recording.mp4
コスト削減効果:
| 方法 | フレーム数 | コスト |
|---|---|---|
| 全フレーム（30fps、5秒） | 150枚 | 約450円 |
| キーフレーム抽出 | 8-10枚 | 約24-30円 |
詳細: skills/video-keyframe-analyzer/README.md
lessons-md-manager
Boris Cherny氏のTip #3「CLAUDE.mdへの投資」を仕組み化したスキル。
使い方:
/lessons # セッション中の学びをCLAUDE.mdに追記
/lessons review # 既存ルールのレビュー・整理
特徴:
- セッション中の修正・失敗・発見を自動抽出
- カテゴリ分類・重複チェック付きで蓄積
- チーム全員が即座に恩恵を受けられる知見共有
詳細: skills/lessons-md-manager/README.md
review-feedback-learner
PRレビューで受けた指摘をCLAUDE.mdのルールとして蓄積するスキル。lessons-md-managerと補完関係にあり、「自分の気づき」＋「他者の指摘」の両方を蓄積できます。
使い方:
/review-learn # 直近のマージ済みPRから学ぶ
/review-learn #123 # 指定PRのレビューから学ぶ
lessons-md-managerとの補完関係:
| スキル | 学びの源泉 | タイミング |
|---|---|---|
/lessons |
自分で気づいた失敗・修正 | セッション終了時 |
/review-learn |
他者からの指摘 | PRマージ後 |
詳細: skills/review-feedback-learner/README.md
evaluate-session
郡嶋が開発した、Claude Codeセッションの効率を分析・スコアリングするWebツール。セッションログ（JSONL）を解析し、7観点100点満点で「無駄の有無」を評価する。
起動方法:
cd <plugin-dir>/skills/evaluate-session/app && npm install && npm start
評価の7観点:
| 観点 | 配点 | 内容 |
|---|---|---|
| A. 重複作業 | /15 | 同一ファイル重複読み込み、書き直し、subagent重複 |
| B. トークン効率 | /15 | トークン量、キャッシュ活用率 |
| C. 目的外作業 | /20 | ユーザー指示と無関係な操作 |
| D. 初動の的確さ | /15 | タスクに適した初手か |
| E. エラー回復効率 | /10 | 原因分析なしの即リトライ |
| F. 不要な探索 | /15 | 不要なファイル読み込み・過剰検索 |
| G. モデル選定 | /10 | タスクに対するモデル適切性 |
スコア目安: 平均50〜65点。70点超えは本当に無駄のないセッションのみ。
必要環境:
- Node.js 18以上
- Claude CLI（Analyzeモードのみ。Stats Onlyは不要）
詳細: skills/evaluate-session/SKILL.md
ディレクトリ構造
common_development/
├── .claude-plugin/
│ ├── marketplace.json # マーケットプレイス設定
│ └── plugin.json # プラグイン基本情報
├── skills/
│ ├── video-keyframe-analyzer/
│ │ ├── SKILL.md
│ │ ├── README.md
│ │ ├── extract_keyframes.py
│ │ └── requirements.txt
│ ├── lessons-md-manager/
│ │ ├── SKILL.md
│ │ └── README.md
│ ├── review-feedback-learner/
│ │ ├── SKILL.md
│ │ └── README.md
│ └── evaluate-session/
│ ├── SKILL.md
│ └── app/ # Node.js Webアプリ
│ ├── package.json
│ ├── bin/cli.js
│ ├── src/
│ └── public/
└── README.md