summary-template

deep-read

把官方长文 → 中文深度解读（MD + 精排 HTML）。本 skill 与 leo-insight 同构：多模态/取材前段用脚本，提炼与生成留给宿主模型——这是质量命门，不外包。

输入 / 输出

输入（缺啥问啥）：

原文：官方文章 URL 或全文（必须是发布方的一手来源；给到二手解读时先回溯官方原文）。
元信息：标题、发布方、日期、材料类型（prompt.md 的 SOURCE_* 参数区）。
EXTERNAL_RESEARCH：默认 off；on 时新增事实必须带可访问来源 URL。

输出：digest.md（4,500–7,000 中文字符的深度解读）+ 自包含单文件 .html（CSS 内联、仅外链 Google Fonts、零 JS 依赖库、移动端自适应、深浅色自动适配）。

资产（务必复用，别重写）

assets/prompt.md = MD 解读的完整质量规格：输入完整性检查、四类事实标签（SOURCE FACT / VENDOR CLAIM / EDITOR ANALYSIS / RECOMMENDATION）、证据边界声明、观点式图注、独立分析章、落地七要素、输出前静默自检。整体作为指令执行，不要摘抄改写。
assets/styles.css = 设计系统皮肤，逐字内联进产物 <style>。三态主题结构（light 全量 / prefers-color-scheme / data-theme 显式切换）不得破坏：任何颜色不得只在 media 或 [data-theme] 块内定义。
assets/skeleton.html = 页面外壳。复制它，内联 styles，填 `` 占位。
参考实现 = examples/ai-native-sdlc/（本 skill 从该次实跑反编译而来）。拿不准某模块长相时，对照它。

流水线（6 步）

① 取材

python3 scripts/fetch_article.py <URL> source.md

403 时脚本已带浏览器 UA；命中付费墙标记时只提取免费部分并在输出头部声明缺失范围——绝不绕过，绝不复原第三方会员内容。若页面本身是二手解读，从”阅读原文”类链接回溯官方原文，以官方原文为唯一输入。已给全文则跳过本步。

② 核对与填参

核对 source.md：目录承诺的章节是否齐全、关键表格代码是否完整（prompt 的输入检查会二次兜底，但先手动确认省一轮返工）。填 prompt.md 顶部的 SOURCE_TITLE / SOURCE_URL / SOURCE_PUBLISHER / SOURCE_DATE / SOURCE_TYPE / EXTERNAL_RESEARCH。

③ 生成 MD 解读（质量命门，宿主模型自己做）

将 prompt.md 全文 + source.md 全文一起执行 → digest.md。生成后抽查三件事：每个重要数字能否溯源到原文；beta/preview 等限定语是否保留；厂商主张与编辑分析的措辞是否可区分（”原文提出 / 这意味着 / 落地时建议”）。

④ 定设计语义

为本篇主题定一对语义色（styles.css 的 --machine / --gate 两组 token 的含义），全部图表沿用同一编码，并写进 hero 图例。示例实跑用”绿 = 机器证据 / 琥珀 = 人类闸门”；换主题时换含义不换机制。SVG 图示两条纪律：currentColor + CSS 变量做主题自适应，字面色只给承载论点的元素；编码即信息（虚线=建议、实线=强制之类），图内不写长句，观点放 figcaption。

⑤ 生成 HTML

复制 skeleton.html，内联 styles.css，把 digest.md 的内容排进版面模块（见下），另写”一页纸”视图（核心一句 + 闭环公式 + 总览表 + 3–4 张卡片 + 证据边界）。必做件：速览卡、总览矩阵表、1–2 个手写 SVG 机制图、来源与证据说明、页脚注明”独立解读”并链接官方原文。

⑥ 交付

单文件 HTML（可发 Claude Artifact 或静态托管）+ digest.md。可选：用仓库 build/render_cards.mjs 把”一页纸”视图切成竖版分享卡。

版面模块（何时用）

模块	类/结构	何时用
速览卡	`.tldr`	恰好 3 条：问题趋势 / 方法核心 / 落地忠告
闭环公式	`.formula`	原文核心流程可压缩成一行 `→` 链时
阶段轨道	`.loop` + `.stagecard`	多阶段流程；每卡 = 工件（语义色 A）+ 决策点（语义色 B）
总览矩阵	`.tablewrap > table`	全景责任表；宽表自带横向滚动
机制图	`figure > svg` + `figcaption`	只画论证依赖的机制；图注必须是观点句
侧栏定性	`.callout` / `.note`	原文关键定性 / 证据边界 / 编辑补充
试点清单	`.pilot`	落地路径的可勾选清单
一页纸	`.op-one` `.op-grid` `.op-card`	浓缩转发版；也是切卡素材
推广位	hero `.chip` + 页脚链接（默认）；`.promo` 卡（慎用）	作者自有服务导流；默认只用 chip 和页脚等低噪形态，链接带 utm；`.promo` 卡视觉太重，仅在明确需要时用且每页至多一张、标注 AD

红线

付费墙：检测到即止步，产物声明缺失范围；不复原、不声称等同第三方会员内容。
品牌隔离：不使用被参考站点的名称、品牌、特色句式；页面注明独立解读并链接官方原文。
事实纪律：无法溯源到原文的主张删除或标为推断；不编造数字、案例、因果；限定语必须保留。
版权：官方原文全文仅作生成输入，不随（public）repo 分发；examples 只放链接 + 必要节选。

输入契约

开始前确认：① 原文 URL 或全文（一手来源）；② 发布方 / 日期 / 材料类型；③ 是否允许联网补充（默认否）；④ 目标读者有无特殊侧重（默认：中国工程师、技术管理者和 AI 从业者）。缺 ① 则停止并索要；②③④ 可用默认值继续，但在产物”来源与证据说明”中如实记录。