soia-pkm-interpret-article-analysislisted

# soia-pkm-interpret-article-analysis > 属 SOIA 个人知识管理域（`soia-pkm-*`）的"解读"环节：对 vault 里 clip 进来的长文/论文，AI 直接给出结构化解读，帮你在深挖（`distill`）前先判断这篇值不值得投入。 ## 客户可读说明 ### 这个技能可以做什么 对 vault 里 clip 进来的长文/论文，AI 直接给出解读：内容总览/核心要点/关键启发/批判视角/延伸阅读五段式。默认快读（各段 2-3 句），说"精读/深度解读"升级为逐节展开 + 论证链核查。产出独立 `<原文件名>-AI解读.md`，落原文件同目录并双链回原文，绝不碰原文、绝不写入原文的 `## 我的看法` 段。 | 客户想要 | 技能会做 | 客户能看到 | |---|---|---| | 快速判断一篇长文/论文值不值得细读 | 快读：五段式各 2-3 句的 AI 解读 | `<原文件名>-AI解读.md`，双链回原文 | | 精读一篇重要文章，要逐节核查论证 | 精读：逐节展开 + 论证链核查，标出原文未明确处 | 更详细的解读文件，批判视角至少一条 | | 批量解读同一批文章（超过 3 篇） | 先报清单（文件名 + 主题），等待确认范围 | 待解读清单 → 逐篇解读文件 + 汇总回执 | | 想把这篇炼成自己的观点，而不是看 AI 怎么想 | 提示这不是本技能职责，指向 `soia-pkm-distill-article-opinion` | 边界说明，不会被误当成你的观点 | ### 客户如何使用 1. 提供要解读的文章：说"这篇"（=当前对话涉及的文章）或给出文件名/标题，Agent 在 `<vault-articles-dir>/` 下定位。 2. 单篇文章：Agent 直接执行，不需要额外确认。批量（同一请求涉及超过 3 篇）：Agent 先列出清单（文件名 + 大致主题），等待客户确认解读范围（全部 / 挑选几篇 / 暂停），再逐篇执行。 3. 深度默认**快读**（五段式，各段 2-3 句）；客户说"精读""深度解读""逐节核查"时升级为**精读**（逐节展开 + 论证链核查，见 [两档深度](#两档深度)）。 4. 解读永远**先落盘、后汇报**：产出 `<原文件名>-AI解读.md` 落在原文件同目录，正文双链回原文，绝不改动或覆盖原文件（含 `## 我的看法` 段）。 5. 最终回复必须给客户完整回执：深度、篇数、产出文件路径、标注了几处"原文未明确/需核对"、剩余风险。 ### 依赖与安装 安装本技能（单个技能）： ```bash npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-interpret-article-analysis -y ``` | 依赖 | 类型 | 安装 / 配置 | 缺失时怎么处理 | |---|---|---|---| | Obsidian vault（任意结构） | 方法参考，非强依赖 | 不需要单独安装 | 本技能可以解读任意 Markdown/纯文本文章，不要求文件必须在 vault 内；只有涉及 vault frontmatter 和双链归位约定时才参考 vault 上下文 | | `soia-pkm-clip-*` 系列 | 上游来源，非强依赖 | 不需要安装，除非客户需要先归档再解读 | 只是常见的输入来源，本技能不调用也不修改这些 ski