用途
soia-pkm-interpret-article-analysis 属于 SOIA 个人知识管理域（soia-pkm-*）的“解读”环节。它的定位是：对 vault 里 clip 进来的长文/论文，由 AI 直接给出结构化解读，帮你在深挖（distill）前先判断这篇内容值不值得投入。
解读产物是决策辅助——帮客户判断“这篇值不值得进 distill 深挖”，不是观点本身，也不应被误当成客户的观点。
主要能力
技能输出固定的五段式解读结构：
- 内容总览：文章讲了什么、核心结论是什么。
- 核心要点：分条目提炼文章主干信息，通常 4-8 条，每条给出处（如“见第 3 节”/“见引言部分”）。
- 关键启发：至少 3 条，每条说明“是什么 → 为什么重要 → 对你可能怎么用”。
- 批判视角：至少 1 条“这篇可能错在哪”，如论证漏洞、证据不足、以偏概全、时效性问题等。
- 延伸阅读：2-4 条值得继续探索的方向或值得对照读的资料；vault 内已有相关文章/MOC 时用双链标出。
不确定内容一律显式标注“原文未明确/需核对”，不编造原文没写的数据、实验、结论。引用原文时给出处段落，方便回原文核对。
两档深度
- 快读（默认）：未明确要求精读时使用。五段式，每段 2-3 句，覆盖全文但不逐节展开。
- 精读：触发词为“精读”“深度解读”“逐节核查”。在五段式基础上逐节展开，并做论证链核查。
精读模式的论证链核查
精读时，在“批判视角”段之前先做一次逐节论证链核查，逐个论点确认：这一节的核心论点是什么；支撑论点的证据/数据/引用出自原文哪一段；论点到证据之间是否有跳跃（证据只能支持更弱结论而原文喊出更强结论）；原文没有交代清楚的前提/定义/边界条件标注“原文未明确/需核对”，不替原文补全。核查结果作为“批判视角”段的依据。
使用方式
提供要解读的文章：说“这篇”（即当前对话涉及的文章）或给出文件名/标题，Agent 在 vault-articles-dir 下定位。读文章的 ## 原文 段（clip 家族统一正文结构为 ## 摘要 / 原文 / 我的看法 / 关联）；只有摘要没有全文时，会先告知“本次基于摘要而非全文，结论置信度较低”，并在解读文件的“内容总览”里注明。不读、不改客户已有的 ## 我的看法 段。
单篇文章直接执行，不需要额外确认。批量（同一请求涉及超过 3 篇）时先列出清单（文件名 + 一句话主题猜测），等待客户确认解读范围（全部/挑选/暂停），再逐篇执行。2-3 篇视为小批量，可直接执行，但开始前用一句话报告将处理哪几篇。
解读永远先落盘、后汇报：产出 <原文件名>-AI解读.md 落在原文件同目录，正文双链回原文，绝不改动或覆盖原文件。最终回复必须给出完整回执：深度、篇数、产出文件路径、标注了几处“原文未明确/需核对”、剩余风险。
新建独立 frontmatter，至少包含：interpreted_from、interpret_depth（quick 或 deep）、interpreted_at。同名解读文件已存在时，先告知客户并等待确认是否覆盖。
安装命令：
npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-interpret-article-analysis -y
配置约定路径为 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-interpret-article-analysis/config.yml，也可用环境变量 SOIA_PKM_INTERPRET_ARTICLE_ANALYSIS_CONFIG_FILE 指定自定义路径。该技能通常不需要 config.yml；如需固定“默认深度”“批量确认阈值”等偏好可建此文件。该技能不读取、也不应读取任何 API key、cookie、session、账号凭据，只读取客户提供的文本文件。
与 soia-pkm-distill-article-opinion 的分界
这是本技能最容易被混淆之处：
- 解读主体：本技能由 AI 通读全文给出判断；distill 由用户口述，AI 只帮问、帮落文字。
- 交互方式：本技能一次性生成五段式解读，不逐问逐答；distill 是苏格拉底式，一次只抛一个问题等用户回答。
- 产出内容：本技能产出 AI 的总览/要点/启发/批判/延伸；distill 产出用户自己的立场、经验、判断。
- 落地位置：本技能落在独立文件
<原文件名>-AI解读.md；distill 落在原文件内的## 我的看法段。 - 使用时机：本技能用于刚归档、还没读完、想先判断值不值得深挖；distill 用于已决定要表态、要炼观点。
红线：绝不写入原文 ## 我的看法 段，绝不替用户表态。客户在解读过程中说“我怎么看这篇”“帮我提炼观点”时，一律提示这是 distill 的职责。
适用场景
- 快速判断一篇长文/论文值不值得细读。
- 精读重要文章，逐节核查论证。
- 批量解读同一批文章。
- 客户想把某篇炼成自己观点时，提示改用 soia-pkm-distill-article-opinion。
依赖与限制
Obsidian vault（任意结构）为方法参考、非强依赖；本技能可解读任意 Markdown/纯文本文章，不要求文件必须在 vault 内。soia-pkm-clip-* 系列为上游来源、非强依赖。soia-pkm-distill-article-opinion 为下游/平行 skill、非依赖。
限制：不代替 distill（不写 ## 我的看法 段，不以第一人称冒充客户表态）；不编造原文未提供的信息；不做外部检索核实，若批判视角依赖外部事实核查只提示客户自行核实；不做翻译/转换，外文文章需先经 soia-pkm-translate-article-zh 或客户自行理解后再解读，也不覆盖 soia-pkm-transform 的产物转换职责。本技能是纯文档/纯 prompt 技能，不带任何脚本。
闭环位置
clip(收) → organize(整理) → ★interpret(AI 解读，辅助判断) → distill(点：你的观点) → compose(写) → publish(发)。上游主要输入来源为 soia-pkm-organize-article-moc 整理好的文章库，也可直接解读刚 clip 进来、还没整理的单篇文章；下游在客户决定“值得深挖”后转 soia-pkm-distill-article-opinion。本技能产出不是 distill 或 compose 的必需输入，只是决策参考。