本技能定义了一套从原始参考资料中提取视觉证据、形成可复用设计依据的方法论，主要由 reference-analyst 智能体使用。其背景是：项目曾三次重做 10 个韩国高级参考包，每次原因都是成品与原件不像，而真正有效的流程从未被文档化。本技能旨在成为该流程的单一事实来源（SSOT）。
【用途】 本技能用于把「原件」转化为「可复现的视觉原则说明」，而非简单照搬。它要求先确定参考模式，再对候选原件做合格性判定，然后逐页精读、提取标志性母题、撰写转换契约，并记录页面映射关系。
【参考模式】 每个包必须先选定一种 reference_mode：
- exact_document：针对某一份公开演示文稿（如部门工作报告 PPT、企业 IR 演示文稿），要求必须取得原始文件，按页面与转换契约评估保真度。
- official_system：针对官方设计系统（如 Material、HIG、Carbon 等），要求官方文档与组件截图，评估组件与令牌一致性。
- historical_canon：针对历史风格（如包豪斯、风格派、瑞士字体等），要求学术或博物馆一手资料，评估原理与母题清单一致性。
- style_synthesis：针对多份二手资料的合成（如「咨询报告美感」），允许二手资料，只评估风格一致性，不得声称忠实于原文。 重要约束：style_synthesis 不得使用 source_depth: full，且不得在任何地方声称「复现了原件」；若仅有二手资料却标为 full，属于出处伪造。
【原件合格性门槛】 仅 exact_document 模式适用，在精读前先机械判定，依次检查：
- G-A 获取：必须实际下载文件并用 curl -sL -o 保存后验证有效性，仅链接存在不算。
- G-B 媒介形态：PPT 轨道要求纵横比 ≥ 1.6（16:9 = 1.778），需实测第一页 mediabox。
- G-C 篇幅：页数 ≥ 8。
- G-D 设计密度：渲染前 5 页并由人或智能体目视判断是否存在视觉语言。
- G-E 权利：须为公开发布物且出处为一手。 G-B 是最常失败的环节，曾因把 A4 竖版韩文文档（纵横比约 0.71）误判为演示文稿而废弃多个包，故须先测比例。每个候选的判定结果（含淘汰原因）都要保留。
【原件获取记录】 通过门槛的原件须可复现地固定：记录实际下载成功的 canonical_url、retrieved_at、sha256、media_type、page_count、page_box、aspect_ratio、local_path。原件不提交到仓库，仅提交标识符；sha256 相同可复用以往分析。
【逐页清单】 用 pdftoppm 把原件全部页面渲染为 PNG 后逐页查看，不得只看样本。每页记录 page（整数）、role、observed（对象）与 inferred（数组），二者必须分离，后续保真度校验只认 observed。
【标志性母题】 提取 3 到 7 个「让人认出这份演示文稿」的母题并排序，每项包含 rank、name、evidence_pages（必填，须为实际观察页）、where、uniqueness、must_preserve。evidence_pages 为空则视为创作而非观察，应删除；must_preserve 为 true 的母题若未复现，保真度直接驳回。
【转换契约】 把原件各元素按四种处置之一记录：preserve（原样复现）、adapt（保留角色、调整取值，如付费字体换成度量兼容的公开字体）、substitute（保留角色、替换受保护资产，如部门徽标换成同位置同尺寸的中性字标占位）、drop（不复现，如特定人物照片、原件专有插画）。受保护资产分四类：trademark（商标、徽标、字标）、proprietary_image（原件照片、插画）、licensed_font（付费字体）、slogan（政府或企业官方口号）；这四类不得 preserve，只能 substitute 或 drop。
【页面映射与命名】 将原件 N 页映射到包 M 页时，须写入 page_mirror_plan（固定字段名），包含 original_pages、pack_pages、compression（identity、selected、merged）、map（每项含 pack_page、source_pages、kind、rationale）与 not_selected。命名须诚实：compression 为 merged 时不得称为 1:1 镜像，而应称为 transformed-principle fidelity。
【产出物】 _workspace/{batch}/ 下包括：01_scout_candidates.json（含门槛判定与淘汰记录）、pdf/{code}.pdf（本地专用、不提交）、pages_src/{code}/p-NN.png（原件全页渲染）、visual_spec/{code}.json（全页清单、标志性母题与参考清单）、transform_contract/{code}.json（元素处置契约）。
【固定键名】 visual_spec 顶层键：schema_version、code、reference、pages_unreadable（无则 []）、page_inventory、signature_motifs、page_mirror_plan、palette_measured（建议）、contrast_measured（建议）。page_mirror_plan 子键：original_pages、pack_pages、compression、map、not_selected。transform_contract 顶层键：schema_version、code、reference_sha256、elements（元素数组，按各原素的 class 与 action 区分，不拆成 protected_assets 或 preserved_principles）。page_inventory 每项：page（整数）、role、observed（对象）、inferred（数组）；页码一律用整数数组，禁止字符串。若需新键，应先修改本表而非临时创造。
【禁止事项】 不得只看几页样本就下结论；不得把推断混入 observed；不得在未取得原件时声明 exact_document（那属于 style_synthesis）；不得用一般设计常识填补观察空白（原件若违反规则，以原件为准，这种偏离正是其身份）；不得将受保护资产处置为 preserve。