engineersoheinsahani-ai/skill

SKILL.md — journal-arena ENB-Pro v4.0（獨家投稿前版本）

目的：在提交到 Energy and Buildings（編碼方法）之前，由真實代理在本地模型上執行稿件的完整科學計量學審查 — 原始 16 組劃分，不超過 100 個執行者，每次呼叫分開並帶有時間戳。全部為英文。保留所有 v3.1 能力（雙重錨定、分類帳、語料庫、矩陣、委員會、工具包、守衛），再加上 input/ 上的機器波（地圖、預檢、圖形品質控制、數字差異比對）和包含圖形專家的後委員會寫作團隊。

0. 法律（每個智能體、每個模型、每個階段）

1. 一職一責法 — 每個智能體只負責唯一的部分（其在 groups/16-group-playbooks.md 中的 G 組卡片）；職責之外的觀察結果最多以一個轉發註記（嚴重性 style）的形式出現。
2. 雙重錨定法 — 每個評估判斷必須有兩個錨點：(a) 來自研究文獻的確切引用，帶有來源 ID 和定位器（來自 work/ledger.jsonl 的 [L:e4-012 ...]），以及 (b) 僅在映射某個主張時才需要的確切稿件引用。沒有 (a) 的判斷將被隔離，永不計入。例外：確定性規則遵循發現（anchor_type: rulebook|machine，lit_quote_id: L:rule-<id>，其中 id 存在於 checklists/ 或引擎執法器中）是事實 — 由 matrix3.py rule_exists 機器驗證。
3. 決策價值法 — 判決 + 最多 3 個可操作行動 + 引用。不允許僅有釋義的摘要。分類帳會去重；沒有決策的活動是浪費。
4. 證據層級法 — 正文=1.0 > 摘要=0.5 > 規則手冊=1.0（確定性）> 元數據=0（隔離）。每個引用都帶有其層級。
5. 驗證授權 — 對來源和 input/ 唯讀；稿件從未離開所有者的機器，除非所有者明確的 --attach 決定（線上模型的 POL-AI-5；本地模型豁免）。
6. PRIV-1…PRIV-6 — engine/humanize.py 是私有衍生模組：切勿發布；在任何套件離開此機器之前，guard_private.py scan 必須列印乾淨（公開構建排除它 — 請參閱 NOTICE.md）。
7. 無偽造法 — 切勿編造數字；缺失值 = [需要數字]，僅由作者解決。沒有檢測器分數可以決定。
8. 無誇大法 — 主張不能大於其證據；主張膨脹將被評分並可被否決（G11 元審計 + 競技場評估標準權重）。
9. 執行誠實法 — 每個產物都記錄了誰執行它：indep: machine（確定性工具 — 事實）· harness（通過 engine/harness.py 的獨立模型呼叫，僅所有者環境中的金鑰）· human（所有者或貼回）· single（一個模型扮演多個角色 — 標記的模擬）。「100 個智能體」只有在 100 次獨立呼叫（campaign.py）時才為真 — 否則為 single。單一執行者的發現絕不能單獨確認 P0：P0 需要機器確認、>=2 個獨立執行者或所有者的簽核。
10. 產物差異法（新增，所有者決定 2026-10-12） — 智能體從不執行研究管道（耗時；屬於所有者的工作）。所有者將管道自己的輸出存入 input/results/（清單、審計 JSON、表格、CSV、日誌）和代碼存入 input/pipeline/（唯讀靜態審查）。engine/diffnum.py 根據產物（已追蹤 / 未追蹤）篩選每個稿件的數字；未追蹤的數字成為 G8 的機器發現和 [需要數字] 的候選項。UNTRACED 標誌是篩選命中，而非錯誤證明 — 誠實地建構。

1. 記錄在案的決定

從 v3.1 繼承（所有者，2026-10-09/11）：code_scope=research_code · tier1_journals=[Energy and Buildings (primary), Applied Energy, Building & Environment, Energy, Journal of Building Engineering, Energy and AI] · corpus_axis=manuscript-derived (work/corpus/axis.json) · corpus_counting=body-access-only · corpus_ceiling=20 + 充分性（研究在 E6 128 / E2 82 / E4 76 可計數時關閉；錨點存儲在 work/ledger.jsonl） · humanizer_mode=distilled-brief。 新增（所有者，2026-10-12）：ENB-Pro 獨家版本 — 全部英文 · 智能體劃分完全是原始 v2 拓撲（16 個職責組，每波 10 個，最多 100 個真實執行者） · 在本地模型上執行（目前：qwen3.5:4b；代碼為 4B 級別優化） · 智能體從不執行管道（法律 10） · input/ 放置區合約 · 寫作團隊包括 FIG-MPL + FIG-GV 圖形專家 · 圖形必須符合最高 ENB 工藝水準（附帶範本）。

2. 拓撲 — 原始 16 組劃分（單一來源：groups/16-group-playbooks.md）

G1 標題 · G2 摘要 · G3 關鍵詞-亮點-GA · G4 引言-差距 · G5 文獻回顧 · G6 方法論-編碼 · G7 資料 · G8 結果-一致性 · G9 統計-UQ · G10 討論-主張 · G11 建議+元審計（否決權） · G12 參考文獻-完整性 · G13 倫理-政策 · G14 格式-工具包 · G15 語言-風格 · G16 審稿人模擬。 劃分運算（campaign.py）：N=100 => G1–G4 x7 + G5–G16 x6 = 恰好 100 個插槽（v2 使用 ceil => 112；Pro 尊重所有者的 <=100 法），每波 10 個，智能體 ID G6-a03。後委員會寫作團隊（6 個固定角色）：WR-TEXT-1/2/3、FIG-MPL、FIG-GV、STAT-CHECK。

3. 管道（波次，可中斷恢復）

W-machine   run.py prep --work work --input input        （地圖、預檢、圖形品質控制、
                                                          數字差異比對、庫存 — 無需金鑰）
W-division  run.py campaign run --work work [--agents 100] （真實執行者，法律 9；
            可中斷恢復；每組後設置檢查點：check + matrix + council）
  或 智能體模式（無需金鑰；根據 AGENTS.md 進行 GitHub 克隆與執行）：campaign 簡報 ->
            克隆智能體回答 work/answers/<slot>.txt -> campaign ingest-dir --indep single
            （誠實印記：一個模型，100 個角色）
W-aggregate run.py check/matrix/council work/findings.jsonl ...
W-writers   run.py campaign run --stage writers --work work （委員會判決後）
W-apply     task/05 + apply_revisions.py （所有者批准；可追溯性：僅複本）
W-kit       kit.py strip --src input/manuscript.txt --out <submission-copy> + figureqc clean
W-release   LICENSE / Zenodo DOI / 資料存放 / GenAI 聲明

4. 錨點與池

分類帳行保留其 v3.1 E-gid；活動將職責組映射到池： G2,G7,G8 -> E6（完整性 319 個錨點） · G4,G5 -> E2+E4（新穎性/方法論 412 個） · G6,G9 -> E4（+E5 倉庫行） · 所有其他組：來自 checklists/ 的規則手冊錨點（L:rule-*）。簡報嵌入最多 20 個錨點（120 字元截斷） — 這是唯一可引用的池（法律 2）。

5. 小型模型合約（4B 類別本地模型）

提示詞：法律摘要約 700 字元 + 職責卡片 + 最多 20 個錨點 + 僅與職責相關的稿件摘錄（最多 6000 字元，按章節映射）+ 機器事實 + 一個少樣本 JSONL 範例。生成：max_tokens 1200，溫度配置 0.2–0.5，qwen3-family 使用 /no_think（預設），一次解析重試，穩健提取（柵欄/尾部逗號/連接物件）。預期閘門會積極隔離 — 這是系統在運作，而非失敗；4B 上的實際產出：每個執行者 2–4 個存活發現。

6. 佈局與命令

checklists/ engine/ groups/ input/ sources/ task/ templates/ demo/ work/ 進入點：python3 engine/run.py prep|campaign|diffnum|figureqc|harness|map|precheck|matrix|council|check|validate|ledger|corpus|kit|apply|guard|stage — RUNNER.md 是連接指南（Ollama/API/貼回）。NOTICE.md：隱私、授權狀態、環境變數。