Trailmark Summary

ターゲットディレクトリに対して trailmark analyze --language auto --summary を実行します。

使用すべき場合

• Vivisect Phase 0 が分解前に簡単な構造概要が必要な場合
• Galvanize Phase 1 が検出された言語とエントリーポイント数が必要な場合
• より詳しい分析の前に、不慣れなコードベースを素早く理解する必要がある場合

使用してはいけない場合

• すべてのパスを含む完全な構造分析が必要な場合（trailmark-structural を使用）
• 詳細なコードグラフクエリが必要な場合（メインの trailmark スキルを直接使用）
• ホットスポットスコアまたはtaintデータが必要な場合（trailmark-structural を使用）

却下すべき根拠

根拠	なぜ間違っているか	必須アクション
"手動でコードを読めばいい"	手動読取はパーサベースの言語検出、依存性データ、エントリーポイント列挙を見落とす	Trailmarkをインストールして実行
"言語検出は重要ではない"	言語選択を間違うと分析結果が空または不完全になる	Trailmarkのパーサベース検出または --language auto を使用
"部分的な出力で十分"	3つの必須出力（検出言語、エントリーポイント、依存性）のいずれかが欠けると不完全な分析	3つすべてが揃っていることを確認
"ツールがインストールされていないのでスキップする"	このスキルはtrailmarkを実行するためにある	スキップせずにインストール状況を報告

使用方法

ターゲットディレクトリは args パラメータを通じて渡されます。

実行

ステップ 1: trailmark が利用可能であることを確認します。

trailmark analyze --help 2>/dev/null || \
  uv run trailmark analyze --help 2>/dev/null

どちらのコマンドも動作しない場合、「trailmark がインストールされていません」と報告して終了します。pip install、uv pip install、git clone、またはその他のインストールコマンドを実行しないでください。ユーザーが自分で trailmark をインストールする必要があります。

ステップ 2: Trailmark の parse API で言語を検出します。

python3 - "{args}" <<'PY'
import json
import sys

from trailmark.parse import detect_languages

print(json.dumps(detect_languages(sys.argv[1])))
PY

import が失敗する場合、同じスニペットを uv run python - "{args}" で再実行します。結果が [] の場合、「Trailmark はターゲット下でサポートされた言語を見つけられませんでした」と報告して終了します。

ステップ 3: 自動検出で summary を実行します。

trailmark analyze --language auto --summary {args} 2>&1 || \
  uv run trailmark analyze --language auto --summary {args} 2>&1

ステップ 4: 出力を検証します。

出力には次の 3 つすべてが含まれている必要があります：

1. ステップ 2 の検出言語リスト
2. summary 出力の Entrypoints: 行
3. summary 出力の Dependencies: 行

いずれかが欠けている場合は、その欠落について報告します。出力を作り上げないでください。

検出された言語リストと Trailmark summary 出力全文を返します。