"工具鏈"
- 跨 surface 鏡像的連結轉換 mapping 要窮盡、不能靠猜
skill 鏡像從 .claude/skills/ 複製到 content/skills/ 時，references/principles/ 的相對連結要轉成 /report/ 的真實路徑。mapping table 不完整會讓 CI 反覆 broken link，每次修一批漏一批。窮盡 mapping 的方法是列出所有 principle 檔案再逐一找對應 report 卡，不是靠 slug 精確匹配碰運氣。
- 檢查規則的作用域要顯式列舉：零 error 可能是沒被檢查
新增與既有受檢目錄同類的內容目錄時、或工具鏈長期零 error 卻累積出違規時使用。規則的作用域由路徑常數決定、該常數常同時被多個檢查共用，擴作用域會連帶擴語意；作用域是獨立於規則內容的 fact，驗收方式是先確認新規則對已知違規報錯。
- 等比縮放不管空間分配：用了 sizing 套件、版面仍會擠壓
用了響應式 / 等比縮放套件、版面仍然溢出或內容被壓縮，懷疑套件失效時使用。換算工具工作在常數層、空間分配發生在 layout 協商層，兩層獨立 — 工具靜默不等於該層無問題，「有用 X 套件」不構成該維度的品質保證