dev-trace は何をしますか？
メールアドレスを元に、公開情報源の固定ウォーターフォールを実行して構造化された公開プロフィールを生成します。各層は、対応するAPIキーが存在する場合にのみ実行されます。公開データのみを使用し、信頼度の閾値を下回る場合は候補を返す（推測は行いません）。依存関係ゼロ（Node 18+）。APIキーは自分で用意してください。
実行方法
node scripts/dev-trace.mjs <email> [--pretty] [--json <path>] [--max-depth N] [--deep] [--tier low|medium|high] [--no-bio] [--bio-mode fast|balanced|deep|max]
--pretty— 人間が読みやすいJSONで出力します（ユーザーに表示する際に使用）。--json <path>— 生のオブジェクトを標準出力ではなくファイルに書き込みます。--max-depth N— 高速な層の深さN（0〜4）で停止します。デフォルトは4。--deep— 深さ5（SixtyFour）も実行します。低速（数分）で高コストです。SIXTYFOUR_API_KEYが必要です。--tier low|medium|high— SixtyFourの調査深度（デフォルトはlow）。数値が大きいほど詳細、低速、高クレジット消費となります。--no-bio— Tabstack/researchによる経歴（bio）ステップをスキップします（名前が解決され、TABSTACK_API_KEYが設定されている場合、デフォルトで実行されます）。--bio-mode fast|balanced|deep|max— 経歴（bio）の調査深度（デフォルトはfast）。
ウォーターフォール
| 深さ | 層 | ソース | キー | 実行条件 |
|---|---|---|---|---|
| 0 | 検証 | 構文 + MX + 使い捨てメール判定 | なし | 常時、無料 |
| 1 | 表面情報 | Gravatar + ドメインスクレイピング | なし | 常時、無料 |
| 1 | 検証 | Hunterメール検証 | HUNTER_API_KEY | キーがあれば |
| 2 | プロフィール | GitHub ID + ICP基本情報 | GITHUB_TOKEN（推奨） | 常時、無料 |
| 3 | 充実 | Tabstack ウェブ/企業情報 | TABSTACK_API_KEY | キーがあれば |
| 4 | 深堀 | Hunter人物情報充実 | HUNTER_API_KEY | キーがあれば |
| 5 | 最深 | SixtyFour人物インテリジェンス（LinkedIn検索） | SIXTYFOUR_API_KEY | --deep 指定時のみ |
HUNTER_API_KEY は検証（深さ1、0.5クレジット/コール）と人物情報充実（深さ4、0.2クレジット/コール）の両方を有効にします。注意：検証の方が充実よりもコストが高いです。深さ5（SixtyFour）はオプトインの深堀りで、--deep 指定時のみ実行され、時間がかかり（非同期Web調査）、メールアドレス自体と、上流で見つかった名前/企業/LinkedInを起点とします。使い捨てメールや配信不能なメールの場合はスキップされます（meta に記録）。
キー
このスキルディレクトリ内で .env.example を .env にコピーし、使用するキーを追加します（エンジンはスキルルートまたは scripts/ から .env を読み込みます）。すべてオプションです。検証、表面情報、GitHubの各層はキーがなくても実行されます。キーがない層は、静かにスキップされます。キーはスキルにバンドルされることはありません（.env はgitignoreされています）。
コストと利用ポリシー（エージェント向け）
このスキルは、無料で有用なプロフィールを取得でき、有料の各プロバイダーはオプトイン方式となっています。リードに価値がある場合のみ支出します。
コスト層（安い順）:
- 🟢 無料、アカウント不要 — 検証、表面情報（Gravatar + ドメイン）、GitHub ID。キーなしで実行。
- 🟢 無料キー、オプション —
GITHUB_TOKEN（無料で生成可能）はGitHubのレート制限と信頼性を向上させます。 - 🟢 無料アカウントで十分 — Tabstack（
TABSTACK_API_KEY）：企業情報充実（深さ3）+ 引用付き/research経歴。無料のTabstackアカウントでかなりの範囲をカバーできます。 - 🟡 従量課金、無料枠あり — Hunter（
HUNTER_API_KEY）：メール検証（0.5クレジット）+ 人物情報充実（0.2クレジット）。 - 🔴 プレミアム、高額 — SixtyFour（
SIXTYFOUR_API_KEY、--deep）：最深の人物 + LinkedIn検索。高価値ターゲット向けの最終手段です。
層ごとの詳細:
| 層 | コスト | 実行条件 |
|---|---|---|
| 1 検証（Hunter） | 0.5 Hunterクレジット | HUNTER_API_KEY が存在する場合 |
| 3 Tabstack企業情報 | Tabstackクレジット | TABSTACK_API_KEY が存在する場合 |
| 4 Hunter人物情報 | 0.2 Hunterクレジット | HUNTER_API_KEY が存在する場合 |
経歴（Tabstack /research） | Tabstackクレジット（fast が最も安い） | 名前が解決された場合 |
| 5 SixtyFour | 高額（下記参照） | --deep 指定時のみ |
ポリシー：デフォルトでは無料および低コストの層を使用します。簡単な無料調査の場合は、--max-depth 2 でコストのかからない層のみを実行します。
SixtyFour（--deep）は高額でレート制限があります。 正確なコストは利用プランに依存します。エントリープラン（約100クレジット/月、$0.24/クレジット）で medium の人物インテリジェンス取得は約20クレジット（約$4.80、約2.5分）と見積もられ、月に約5回の実行が可能です。すべての --deep 実行を希少リソースとして扱ってください：
- 「念のため」に
--deepを実行しないでください。本当に高価値なターゲットにのみ使用します。 - より安価な層（Hunter人物情報充実、
/research経歴）で情報が不足した場合にのみ使用します。 - SixtyFourを使用する前にユーザーに確認し、デフォルトで
--tier lowを使用し、ユーザーからの指示なしにtierを上げないでください。 - 推奨ではなく、強制です：
--deepは、環境変数DEV_TRACE_ALLOW_DEEP=1が設定されているか、インタラクティブな確認が行われた場合を除き、実行を拒否します。自律的に起動することはできません。ヘッドレス使用の場合はDEV_TRACE_MAX_DEPTH=Nで深さを制限できます。README「ヘッドレス / 自律エージェント」セクションを参照してください。
--bio-mode を fast より上に設定する、および深さ3/4の実行は通常のクレジットを消費します。関連性がある場合は問題ありませんが、ユーザーからの指示なしに --bio-mode を上げないでください。
経歴（Tabstack /research）
ID層の後、名前が解決され TABSTACK_API_KEY が設定されている場合、Tabstackの /research 呼び出しによって、引用付きの専門的な bio がプロフィールに合成され、ソースURLが meta.bio_sources に追加されます。デフォルトモードは fast（最も安価）。--bio-mode で上げるか、--no-bio でスキップします。名前が必要なため、Hunter/GitHubで一致がない場合、--deep と一緒に実行される場合のみ動作します（SixtyFourが名前を提供します）。
結果を伝える際は、どの深さが実行されたか（meta.depths_run）と、どのキーがあればさらに情報が得られるかを報告してください。トレースで返されなかったフィールドを発明しないでください。
出力
{
"meta": { "email": "...", "depths_run": [0,1,2], "match_status": "probable", "generated_at": "..." },
"profile": { "<field>": { "value": "...", "confidence": 0.85, "sources": ["github"], "conflict": null } }
}
- すべてのフィールドは
value、confidence（0〜1）、sources、およびconflict（null、または層間で矛盾がある場合は競合する値）でラップされます。 meta.match_status：verified（確認済みID + 配信可能）、probable（IDが見つかったが未確認）、unverified_candidates（閾値未満）。- 失敗またはレート制限に達した層は
meta.errors/meta.rate_limitedに記録されます。ウォーターフォールは1つの層で中断されることはありません。
注記
- プロフィールのみを生成します。CRMレコードやブリーフなどの他の成果物に整形するのは、別の後続ステップです。
- スタンドアロンで配布可能：依存関係ゼロ（Node 18+）、外部のクローンやビルドは不要です。
- 公開データのみ。プロフィールをでっち上げることはしません。信頼度の閾値を下回る場合は、値を断定せずに候補を返します。