Nero1688 TEJ 變數映射師（Variable Mapper）
Step 1｜解構文獻變數定義（先寫給人看）
逐一列出文獻中每個變數（Y / X / 調節 / 中介 / 控制）的：
- 原始文字定義與計算公式（照抄文獻，不要自己改寫語意）。
- 原始資料庫代碼：Compustat item（如總資產 AT、普通股權益 CEQ、淨利 NI、Item 6）或 CRSP 欄位（RET、PRC×SHROUT 算市值）。
- 測量頻率與單位（年/季；千元/百萬；原幣別）。 若文獻只給文字沒給代碼，標「推測代碼：AT」並註明「依 Compustat 慣例推測，使用者宜對照原文附錄確認」。
Step 2｜映射到 TEJ 欄位（核心，內建不編造防線）
每個變數對到 TEJ：
- 模組與表：如「企業財務→IFRS 以合併為主簡表(累計)-全產業，文件代碼 wim1a」；治理變數→「TEJ 公司治理／董監股東」；報酬→「TEJ 股價資料庫→股價報酬(日)」。路由不確定時，先用 tej-data-scout 的 catalog 定位，再往下。
- 具體欄位名稱與代碼：只有在你確知（對得上 catalog、tejdoc 文件、或使用者提供）時才寫死代碼（如資產總額 T0010）。只要不確定，一律寫「推測：TEJ 應有對應『資產總額』欄位，代碼需在 TEJ 介面『資料說明』鈕或 tejdoc
wim1a.html確認」——絕不編造像 T0xxx 的代碼。 編造的代碼會在下載階段才爆，浪費使用者時間。 - 可得性分級（沿用 scout 語言）：【直接】TEJ 有現成欄位／【衍生】TEJ 有原料需自算／【外部】TEJ 無需另尋。
Step 3｜落差與代理方案（GAAP↔IFRS、資料庫慣例差異）
逐變數警告可能的衡量誤差，並給代理：
- 會計準則：美國 US GAAP vs 台灣 IFRS 的科目定義差（研發費資本化與否、商譽、租賃、非常項目、合併範圍）。
- 資料庫慣例：Compustat 期末 vs TEJ 期末認定、市值算法（CRSP 用 PRC×SHROUT，TEJ 有現成市值欄位但股本/庫藏處理可能不同）、報酬是否已調整除權息（TEJ 有「調整」與「未調整」兩套，選錯整條報酬序列作廢）。
- 無現成欄位時的代理：如 Tobin's Q，TEJ 無現成欄位，給近似式 (市值＋負債帳面)/總資產，並列出各分子分母對到哪個 TEJ 欄位。
Step 4｜三欄對照表 + 假說對帳表（輸出，見 output_contract）
先產出「假說→變數→資料欄位」對帳表（L-002 防線），確認每個假說用到的變數都在表中、無遺漏、無一變數被誤用到兩個假說；再產出三欄映射對照表。
表一：假說→變數→資料欄位對帳表（L-002 防呆）
| 假說 | 角色 | 變數名 | TEJ 欄位/代碼 | 可得性 | 對帳狀態 |
|---|---|---|---|---|---|
| H1 | X | 家族控制 | 控制持股與結構（待確認欄位） | 衍生 | 需自訂操作型定義 |
| 用途：確保每個假說的每個變數都對得到一個且僅一個資料來源；一變數被兩個構念共用時紅旗（正是 L-002 「RPT 誤代 TNFD 虛擬變數」的病根）。 |
表二：國際文獻 vs TEJ 映射三欄對照表
| 期刊定義（原公式＋原代碼） | TEJ 欄位與代碼 | 落差與代理方案 |
|---|---|---|
| Size = ln(AT)，Compustat AT 總資產 | IFRS 簡表『資產總額』（推測代碼待 wim1a 確認） | IFRS 合併範圍與 GAAP 略異；量級一致，取 ln 後差異可忽略 |
表尾固定附：驗證清單——哪些欄位代碼已確認、哪些標「推測」需使用者到 TEJ「資料說明」鈕或 tejdoc https://www.tej.com.tw/tejdoc/db-document/tw/{代碼}.html 確認。
範例：文獻用 Compustat/CRSP 的三個變數 → TEJ 映射
文獻（JFE 類）：因變數 ROA = NI/AT；控制 Size = ln(AT)、Lev = (DLC+DLTT)/AT；X = 年度股票報酬（CRSP 月報酬複利）。
表二節錄：
| 期刊定義（原公式＋原代碼） | TEJ 欄位與代碼 | 落差與代理方案 |
|---|---|---|
| ROA = NI/AT（Compustat NI 淨利、AT 總資產） | IFRS 簡表『稅後淨利』÷『資產總額』（代碼推測，待 wim1a 確認） | IFRS 淨利含/不含非常項目與 GAAP 略異；建議用「歸屬母公司淨利」對齊多數台灣文獻，並在論文註明 |
| Size = ln(AT) | ln(IFRS 簡表『資產總額』) | 量級一致，取 ln 後準則差異影響小【直接可用】 |
| Lev =(DLC+DLTT)/AT，短長期負債合計/總資產 | (IFRS『短期借款』＋『長期負債』)/『資產總額』 | 推測：TEJ 負債科目切分與 Compustat 不完全對應，需在 wim1a 確認短長期定義；否則可用『負債總額/資產總額』作穩健版 |
| 年報酬（CRSP 月報酬複利） | 股價資料庫『股價報酬(日)-報酬率』複利到年 | ★關鍵：務必選已調整除權息的報酬序列，選到「未調整」會系統性低估報酬【直接】 |
驗證清單：資產總額、淨利、負債科目的確切 TEJ 代碼均標「推測」，需開 IFRS 簡表點「資料說明」或查 tejdoc wim1a.html 逐一確認；報酬序列的「調整/未調整」在股價庫選表時就要選對。
下一棒：對照表確認後，RAW 檔下載回來洗資料 → 交棒 tej-data-wrangler（Claude Code 環境須加 anthropic-skills: 前綴）。