デュアルアクシス・スキルレビュアー

デュアルアクシスレビュアースクリプトを実行し、レポートを reports/ に保存します。

スクリプトは以下をサポートしています：

• ランダムまたは固定のスキル選択
• オプションでテスト実行を含む自動アクシススコアリング
• LLMプロンプト生成
• LLM JSON レビューマージと加重最終スコア
• --project-root による複数プロジェクト間のレビュー

利用場面

• skills/*/SKILL.md の1つのスキルに対して再現可能なスコアリングが必要な場合。
• 最終スコアが90未満の場合に改善項目が必要な場合。
• 決定論的なチェックと定性的なLLMコード/コンテンツレビューの両方が必要な場合。
• 別のプロジェクト のスキルをコマンドラインからレビューする必要がある場合。

前提条件

• Python 3.9+
• uv（推奨 — インラインメタデータ経由で pyyaml 依存関係を自動解決）
• テスト用：ターゲットプロジェクトで uv sync --extra dev または同等の処理
• LLMアクシスマージ用：LLMレビュースキーマに従うJSONファイル（リソースを参照）

ワークフロー

コンテキストに基づいて正しいスクリプトパスを決定します：

• 同じプロジェクト：skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py
• グローバルインストール：~/.claude/skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

以下の例では REVIEWER をプレースホルダーとして使用しています。一度設定してください：

# 同じプロジェクトからレビューする場合：
REVIEWER=skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

# 別のプロジェクトをレビューする場合（グローバルインストール）：
REVIEWER=~/.claude/skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py

ステップ1：自動アクシスを実行してLLMプロンプトを生成

uv run "$REVIEWER" \
  --project-root . \
  --emit-llm-prompt \
  --output-dir reports/

別のプロジェクトをレビューする場合は、--project-root をそれに指定してください：

uv run "$REVIEWER" \
  --project-root /path/to/other/project \
  --emit-llm-prompt \
  --output-dir reports/

ステップ2：LLMレビューを実行

• reports/skill_review_prompt_<skill>_<timestamp>.md に生成されたプロンプトファイルを使用します。
• LLMに厳密なJSON出力を返すよう指示します。
• Claude Code内で実行する場合は、Claudeをオーケストレーターとして機能させます：生成されたプロンプトを読み、LLMレビュー JSONを生成し、マージステップ用に保存します。

ステップ3：自動アクシスとLLMアクシスをマージ

uv run "$REVIEWER" \
  --project-root . \
  --skill <skill-name> \
  --llm-review-json <path-to-llm-review.json> \
  --auto-weight 0.5 \
  --llm-weight 0.5 \
  --output-dir reports/

ステップ4：オプション制御

• 再現性のための固定選択：--skill <name> または --seed <int>
• すべてのスキルを一度にレビュー：--all
• クイックトリアージのためテストをスキップ：--skip-tests
• レポートの場所を変更：--output-dir <dir>
• より厳密な決定論的ゲーティングのため --auto-weight を増加。
• 定性的/コードレビューの深さが優先される場合、--llm-weight を増加。

出力

• reports/skill_review_<skill>_<timestamp>.json
• reports/skill_review_<skill>_<timestamp>.md
• reports/skill_review_prompt_<skill>_<timestamp>.md（--emit-llm-prompt が有効な場合）

インストール（グローバル）

このスキルを任意のプロジェクトから使用するには、~/.claude/skills/ にシンボリックリンクを作成します：

ln -sfn /path/to/claude-trading-skills/skills/dual-axis-skill-reviewer \
  ~/.claude/skills/dual-axis-skill-reviewer

その後、Claude Code はすべてのプロジェクトでスキルを検出し、スクリプトは ~/.claude/skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py でアクセス可能になります。

リソース

• 自動アクシスは、メタデータ、ワークフローカバレッジ、実行の安全性、アーティファクトの存在、テストヘルスをスコアリングします。
• 自動アクシスは knowledge_only スキルを検出し、スクリプト/テスト期待値を調整して不公正なペナルティを回避します。
• LLMアクシスは深いコンテンツ品質（正確性、リスク、欠落ロジック、保守性）をスコアリングします。
• 最終スコアは加重平均です。
• 最終スコアが90未満の場合、改善項目が必要であり、マークダウンレポートにリストされます。
• スクリプト：skills/dual-axis-skill-reviewer/scripts/run_dual_axis_review.py
• LLMスキーマ：references/llm_review_schema.md
• ルーブリック詳細：references/scoring_rubric.md