針對 schematic PDF、GPIO table、BOM、datasheet 做可追溯的電路分析。 可建立 signal alias / canonical net、跨頁與跨 PDF 跟線、解析 IC 型號與規格、 必要時用 web_fetch / agent-browser 補 public spec,並把分析結果收斂成結構化 table、 VERIFIED / INCOMPLETE / EXCLUDED facts 與主動提問清單。
這不是「DTS skill」。
這是一個 讀 PDF、找線、辨識器件、理解電氣語義、把電路事實整理成可重用資料結構 的 skill。
它的輸出可以拿去做 DTS、spec、table、review note、bring-up checklist, 但 skill 本身應該停留在 電路分析層。
若要把這些已收斂的證據直接轉成 DTS,應交給 ../gen-dts/SKILL.md。
這個 skill 必須能做:
讀 PDF / OCR fallback
找線 / 跟線
Signal alias / canonical net normalization
SDA 經過電阻後變 SDA_0canonical_signal 與 aliasesIC 型號解析
web_fetch / agent-browser 補 public spec電氣語義判讀
行為理解
表格化輸出
主動提問
Evidence first
Canonical before semantic
Separate identity from meaning
GPIO_26 = RBR_FB 成立,不等於 GPIO_26 = wakeup-trigger-pin-gpio。Public spec is allowed, answer key is not
Status must be explicit
VERIFIED / INCOMPLETE / EXCLUDED 必須分清楚。先列:
每張 PDF 都要有:
對每條線,建立:
canonical_signalaliasespath_segmentsbridges常見 bridge 類型:
SDA -> SDA_0)跟線時要能辨識:
trace 斷掉時,標 INCOMPLETE,不要補猜。
優先順序:
web_fetch / agent-browser 查 public datasheet / product page若使用 web 工具,必須記錄:
skill 必須能從線路關係判定:
至少要能輸出兩類表:
canonical_signalaliasessource_refsink_refpath_segmentsswap_statusswap_detailelectrical_traitspopulation_statestatusprovenancerefdespart_numbernormalized_compatiblebusaddresspins_usedstatusprovenance只有在以下情況問:
問題要明確指出:
預設輸出四段:
VERIFIED factsINCOMPLETE factsEXCLUDED claimsQuestions for user每個 fact 至少包含:
whatstatuswhywhere provedconfidence若題目是單一主題盤點(例如 UART count/usage、SoC power rails、LED topology),
可在上述四段之外,再輸出一份 topic report,建議骨架為:
Title / ScopePrimary evidence sourcesSummaryPer-instance or per-rail breakdownOpen questions / unresolved points其中 Per-instance or per-rail breakdown 應盡量包含:
此外,skill 可以使用兩種中介格式幫助分析收斂:
適合在「先把電路意圖整理乾淨,再決定下游輸出」時使用。
建議欄位:
object_typeinstancesignal_or_pinfunctionactive_levelconnection_targetpopulation_stateevidence適合在證據不足、但已經能明確描述缺口時使用。
至少包含:
questionmissing_evidencecurrent_candidatesdownstream_impactweb_fetch / agent-browser 只拿來補:
references/analysis-playbook.md