official-article-ingestlisted
Install: claude install-skill codingSamss/all-my-ai-needs
# Official Article Ingest
用于把官方来源文章收录到 Sam 的 Obsidian Vault,并尽量保持来源页面的原始结构、视觉层级和阅读美感。默认先读取 `orbit-os` 规则,遵守 Vault 路径、媒体本地化、外部写入后 `touch "<file>"` 等约束。
## 先判定模式
如果用户没有明确说明,先问要哪一种;不要把两种混用。
### 模式 A:原文 1:1
适用表达:`原文1:1`、`只要原文`、`原始英文保存`、`按官网原文排版`。
- 保留来源语言正文,不插入中文翻译。
- 保留源站信息架构:hero、标题、副标题/摘要、日期、作者、Quick links/TOC、正文层级、列表、表格、媒体、图注、labels、acknowledgments、source link。
- 在 Obsidian 中做“近似官网排版”,可以用少量内联 HTML;不新增全局 CSS,除非用户明确要求做模板化复用。
- 如果来源是公开受版权保护文章,避免在最终回复中贴出长段原文;本地落盘前优先确认用户是否已有合法来源/是否已在 Vault 中存有原文。无法确认时,采用结构对齐的摘录与自有整理,并说明边界。
### 模式 B:英文中文对照 1:1
适用表达:`英文中文对照1:1`、`中英对照1:1`、`逐段对照翻译`、`逐段补中文`。
- 保留英文原文顺序,在每个英文段落、列表项、图注、标题或表格块后紧贴中文翻译。
- 中文默认使用普通段落,除非原文自身是引用块、callout、列表、表格或代码块。
- 不把译文集中放到文末,不改写成摘要,不额外添加编辑说明或观点,除非用户要求。
- 标题、日期、作者、摘要、Quick links、媒体说明也要双语化,并尽量保持源站首屏节奏。
## 版式原则
- 以官方页面原始排版为第一参考,而不是套通用 Markdown 模板。
- 先识别来源页面首屏:品牌/栏目、hero 标题、中文/英文标题、封面或主图、日期、作者、dek/摘要、Quick links。
- 正文保持原顺序:不要重排章节,不合并独立段落,不移动图片/视频到文末。
- 对 Google/OpenAI/Anthropic 等官方文章,优先保留“官网阅读感”:大标题、充足留白、媒体靠近对应段落、caption 紧贴媒体。
- Obsidian 近似排版可以使用内联 HTML,但必须在当前笔记内自包含;不要污染全局主题或其他笔记。
## 媒体与链接
- 正文图片、视频、动态图默认本地化到同级 `assets/<slug>/`,正文使用相对路径。
- 保留原文链接;外部 source 放 frontmatter 的 `source`。
- 媒体必须做三数校验:预期正文媒体数 = 下载成功数 = 文内引用数。缺失时不要宣称完成。
- 图注/视频说明按模式处理:原文 1:1 只保留原语言;中英对照 1:1 保留原文 caption + 中文 caption。
## Vault 收尾
- Frontmatter 必须在第一行,`---` 分隔符只用于 frontmatter;正文分隔线用 `***`,避免校验混淆。
- 写入后执行 `test -s "<file>"`。
- 写入后执行 `touch "<file>"`,路径必须加引号。
- 抽查 Obsidian Reading/Preview:首屏 hero、Quick links、正文列表、媒体 caption 是否美观可读;如果标题被挤到逐字断行