THE LINEAGE
写真が入力されます。スキルはユーザーのマシン上で10の特性を測定し、その特性がどの十年に属するかを読み取り、写真の家系図を構築します。1930年代から2020年代までのトランク上に各十年ごとに一つのルック、その隣に枝としてさらに二つのルックが配置されます。それぞれは名前付きの映画、撮影監督、写真家、キャンペーン、またはプロセスであり、それが属する理由も示されます。次に、トランクの方向性を研究し、ライブラリにルックがまったく存在しない場所に2027年の枝を成長させます。名前、レシピ、誰から何を継承したか、そしてそれがギャップであることの証明（「107のルックのうち、これほど暖かくてこれほど粒子が粗いものはない」）が含まれます。このギャップ文が署名です。それが、その枝がまだ誰も作ったことのないルックであり、単なる推測ではないことを示します。
枝までのすべてはローカルな計算であり、コストはかかりません。生成されるのは、ユーザー自身の写真をその枝に最終的に再照明する処理だけであり、それはユーザーが承諾した後にHiggsfieldアカウントで実行されます。
インストール
bash install.sh # スキル、スタジオフォルダ、オプションツールの確認
bash install.sh --higgsfield # Higgsfield CLI + MCPもインストール。自身のアカウントで生成する場合
標準ライブラリはPythonのみです。JPEGとHEICはsips（macOS）またはffmpegで開きます。PNGは追加のツールは不要です。
実行方法
ユーザーが要求したとき、Claudeは以下の手順を実行します。
- 写真をトレースします。
python3 scripts/lineage.py trace "<photo>" --project "<project>"（任意のJPG、PNG、HEIC。プロジェクトはデフォルトでthe-lineage）。光、粒子、フレーミング、色の4つの読み取り値、スコアのシェアと次点を持つ十年、そして1930年代から現在までのトランク（各ルックが写真と共有するもの）を出力します。最初に十年をユーザーに伝え、次に最も重要な2〜3のトランクルックを伝えます。「接戦」と表示された場合は、両方の十年を伝えます。それが正直な読み取りです。 - 枝を成長させます。
python3 scripts/lineage.py grow latest --project "<project>"。2027年の枝を出力します。名前とステートメント、レシピ（光、色、黒、粒子、光学、フォーマット）、どのルックから何を継承したか、およびギャップが含まれます。ユーザーが別のオプションを希望する場合は、--seed 1（2、3...）で同じルールに従って別のギャップを見つけます。 - エクスポートします。
python3 scripts/lineage.py export latest --project "<project>"はtrees/<id>.svg（印刷可能なポスター：1930年から上るトランク、上部の深紅色の2027年の芽）、trees/<id>.json（すべての数値）、trees/<id>-branch.md（レシピ付きの枝カード）を書き込みます。ポスターを開き（Macではopen <file>）、最初に見るべき箇所を一言で伝えます。つまり、芽とそのすぐ下のトランクルックです。 - 生成前に停止して確認します。 ユーザーが自身の写真に枝を適用したい場合のみ：
python3 scripts/lineage.py request latest --project "<project>"は1つの画像編集リクエストを書き込みます。それが1世代であり、ユーザーのHiggsfieldプランでいくらコストがかかるかを伝え、承諾を待ちます。その後、下記を実行し、python3 scripts/lineage.py status latest --project "<project>"で確認します。
ノードの説明：python3 scripts/lineage.py node <id> はルックの詳細（なぜ系統に含まれるか、何を継承するか、人物、所在、親）を出力します。python3 scripts/lineage.py library --decade 1970 は特定の十年のリストを表示します。ユーザー自身のリファレンス：python3 scripts/lineage.py add --name "..." --year 1994 --why "..." --image ref.jpg は画像を測定し、そのルックを以降すべてのツリーに追加します（リファレンスはマシン全体でグローバル、プロジェクト単位ではありません。--project は受け付けられますが無視されます）。
バンドルされたサンプルで試す（費用はかかりません）：python3 scripts/lineage.py example --project demo（または2番目の静止画として --photo pool）。このマシンで正常に動作するか確認するには：python3 scripts/selftest.py。
結果の判断方法
- 弱い根拠について警告します。 人物、可視光源、またはスタジオライトがない場合、メーターは捉えるものが少なくなります。トランク全体で30パーセント未満の一致は、写真が適切でないことを意味するため、ユーザーがツリーを歴史として読む前にそれを伝えます。
- 十年は読み取り値であり、断定ではありません。 25パーセントを超えるシェアで次点との明確な差がある場合は確実な読み取りです。5ポイント未満の差は接戦であり、両方の十年が妥当です。写真を再圧縮すると粒子が変化し、結果が変わることがあります。
- トランクルックがその位置を獲得するのは、写真と2つの特徴的な特性（
shares行）を共有する場合であり、単に色が似ているだけでは不十分です。50パーセント以上の一致は近縁です。30パーセント未満の場合は、単にその十年により近いルックがなかっただけなので、その旨を伝えます。 - 枝が優れているのは、そのギャップ文がライブラリ内のどのルックも同時に持たない強力な特性のペアを指定し、最も近い既存ルックが70パーセント以下であり、かつ写真のフレームを維持している場合です。レシピがフィルム上で矛盾する（白黒にスプリットトーニング）枝は拒否し、別のシードを成長させます。
- 実線は文書化された影響を示し、点線は特性の類縁性を示します。 点線を歴史として提示しないでください。
- ローカルな数値はツリーJSONで確認できる算術です。
references/method.mdですべての計算方法とその限界が説明されています。library/reading-card.mdは同じ読み取りを目視で行ったものです。
ユーザーのHiggsfieldアカウントでの生成
このスキル内で自動生成されるものはありません。request は ~/LOWLIGHT STUDIO/<project>/requests/<id>.json（プロンプト、リファレンスとしてのユーザーの写真、アスペクト比）を書き込みます。ClaudeはユーザーとしてログインしたHiggsfield MCPを通じてそれを実行し、結果を保存します。
python3 scripts/studio_bus.py requests <project>
python3 scripts/studio_bus.py receive <project> <id> <downloaded file>
これは画像編集です。プロンプトは枝の光、色、フィルム表面のみを説明します。ユーザーのプランが提供する編集モデル（Nano Banana Pro または Seedream 編集モデルが適しています）を使用します。何かを実行する前に、それが何世代で、ユーザーのプランでいくらコストがかかるかを伝え、承諾を待ちます。詳細は references/generation.md を参照してください。
他の部門との連携
references/studio.md を参照してください。The Eye が存在する場合、そこから taste を読み取ります（好みと拒否が2027年の枝の成長方向に影響を与え、枝は taste_used を表示します）。また、lineage（最新12ツリーとそのノードおよび枝）を公開し、The Eye が追加のデッキとして使用できます。他の部門がなくても同じように動作します。
ファイル
| パス | 説明 |
|---|---|
scripts/lineage.py | エンジンとそのコマンドライン：example、trace、grow、export、request、status、trees、library、node、add |
scripts/meter.py | 写真メーター：10特性、読み取り値、パレット、フォーマット（python3 scripts/meter.py photo.jpg --brief） |
scripts/demo_photo.py | コードから2つのサンプル静止画を描画します（誰の写真もバンドルされていません） |
scripts/selftest.py | 合成写真とサンプルを使用したドライラン：python3 scripts/selftest.py |
library/lineage.json | 1930年代から2020年代までの107のルック：人物、理由、特性、パレット、親 |
library/examples/ | コードから描画された2つのサンプル静止画（そのREADMEを参照） |
library/reading-card.md | 壁や電話上の写真に対する、目視による同じ読み取り方法 |
references/method.md | メーター、十年、トランク、ギャップの計算方法とその限界 |
references/library.md | ルックの書き方、追加・修正方法 |
references/generation.md | Higgsfieldのセットアップとリクエストの構築方法 |
references/studio.md | THE STUDIO部門間の共有バス |
出力は ~/LOWLIGHT STUDIO/<project>/ に保存されます：trees/、requests/、received/。