Soia Pkm Distill Article Opinion

soia-pkm-distill-article-opinion

把「收藏」变成「观点」。这是 PKM 闭环 收→整理→点→写→发 里从输入到输出的命脉环节（点）——专治"收藏一大堆、脑子里没沉淀、我的看法段永远空着"。

客户可读说明

这个技能可以做什么

把 Obsidian vault 里收藏的文章「炼」成你自己的观点。读原文 → 苏格拉底式一次抛一个问题 → 你口述回答 → AI 把你的回答整理成「我的看法」段（内容是你的，AI 只帮落文字，绝不替你想、替你写），写完给你回执。也支持主题聚合：把一个 MOC 下多篇文章的观点提炼成一篇综述

客户如何使用

1. 用自然语言说明目标，并提供必要输入：文件、URL、repo、workspace、proposal、vault 或平台账号状态。
2. 能 dry-run 或预览的动作先给预览；涉及删除、覆盖、发送、发布、写远端状态时先征求客户确认。

依赖与安装

安装（推荐：装整个领域插件，一次装好本仓全部技能）：

claude plugin marketplace add soia-team/soia-open-skills

claude plugin install soia-pkm-vault@soia

只要这一个技能时，可用 npx 路线。注意技能会落进共享真源 ~/.agents/skills；若同时装了插件，同一技能会出现两份索引且各自漂移，建议二选一：

npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-distill-article-opinion -y

配置约定：

~/.config/soia-skills/soia-pkm-distill-article-opinion/config.yml
SOIA_PKM_DISTILL_ARTICLE_OPINION_CONFIG_FILE=<custom-config-path>

• 如果本技能不需要私有配置，可以不创建 config.yml。
• 如果需要 API key、cookie、session、provider home 或本机路径，只能放进私有 config.yml、进程环境或 provider 自己的登录态里，不能写进仓库、vault 正文或日志。
• 第三方 skill 只能声明依赖和安装方式，不直接修改第三方 skill 文件。

WorkBuddy 的装载单位是角色化专家而不是插件，npx skills add -a '*' 覆盖不到它，需要单独安装，见 docs/install/workbuddy.md。

日志与完成回执

每次执行都要让客户看见过程和结果。最低回执格式：

完成：<一句话说明本次完成了什么>。

日志摘要：
- started: <检查到的输入/配置/依赖，不打印秘密值>
- processed: <数量或范围>
- created/updated: <数量或路径>
- skipped/failed: <数量和原因>

文件变化：
- <绝对路径或“未改动文件”>

验证：
- <运行过的检查、命令或人工核对点>

问题与下一步：
- <缺 key / 缺依赖 / 需要客户确认 / 建议下一条命令；没有则写“无”>

核心原则（不可违背）

内容是用户的，AI 只帮他问出来、落成文字——绝不替他想、替他写。

• AI 的职责：读懂原文、抛出好问题、把用户的口头回答整理成通顺的第一人称文字。
• AI 不做：虚构观点、替用户表态、加入用户没说过的判断。
• 用户没回答 → 不写。宁可留空，绝不编。

模式 A：单篇提炼（默认）

触发：「给这篇补我的看法」「这篇我怎么看」「distill 这篇」

流程：

1. 定位文章。用户说「这篇」= 当前对话涉及的文章；否则用文件名 / 标题在 <vault-articles-dir>/ 下 Glob/Grep 找到。
2. 读原文（读 ## 原文 / 正文段）。
3. 对齐骨架：用 1–2 句复述文章核心论断，让用户确认你读懂了（也给他思考起点）。
4. 一次只抛一个问题（按下面「三角度」逐个来，拿到答案再抛下一个）：针对这篇的具体论点、用大白话、并给一句回答示例降低门槛。
   • ⚠️ 实战教训（必须遵守）：切忌一次抛 3 个问题 + 表格——会直接淹没用户，他不知从哪答起。一次一个、配示例，用户才答得动。
5. 停下，等用户回答。用户口语化、只答一两句、说"没想法"跳过，都行。
6. 三个角度问完（或用户表示够了），整理成文：把用户的回答组织成通顺的第一人称「我的看法」。保留他的观点、判断、语气，只做润色和结构化，不加料。
7. 写入：Edit 文章的 ## 我的看法 段。空段 / 占位注释 → 直接填；已有内容 → 不覆盖，问"追加还是替换"。
8. 给回执（见 §执行后必须给用户回执）。

三角度提问法（一次问一个）

模式 B：主题聚合

触发：「把 X 主题炼成观点」「Agent开发这块我整体怎么看」

1. 读 _MOC/<分类>/<主题>.md 拿文章列表。
2. 读各篇 ## 我的看法（已提炼的单篇观点）。
3. 多数为空 → 提示："这主题 N 篇里只有 M 篇提炼过观点，建议先对几篇跑模式 A。"让他选先炼哪几篇。
4. 有素材后，综合成一篇整体判断（你的核心看法 + 各文章作论据）。
5. 落 <vault-drafts-dir>/YYYY-MM-DD-<主题>-观点综述.md，tags:[草稿]。
6. 这份草稿是 soia-pkm-compose-article-draft 的输入。

写入边界

• 只碰 ## 我的看法（模式 A）或新建草稿（模式 B）。绝不动 ## 原文 / ## 摘要 / frontmatter。
• 内容必须来自用户回答，AI 不虚构。
• ## 我的看法 平时留空给用户；distill 是用户主动请求帮忙落字，落的仍是用户自己的话。

执行后必须给用户回执

写入不是终点。写完一定输出成果给用户，不要默默完成：

1. 写进了哪里：哪篇文章的 ## 我的看法（给文件名 / 路径）。
2. 观点摘要：把刚成文的看法用 1–2 句话回述，让用户一眼确认。
3. 邀请微调：提示"这是你的观点，要改哪句告诉我"。

主题聚合模式同理：告知草稿落在哪、核心论点是什么。

在闭环里的位置

clip-*(收) → organize(整理) → ★distill(点：收藏→观点) → compose(写) → publish(发)

• 上游：soia-pkm-clip-* 把文章归档进来。
• 下游：soia-pkm-compose-article-draft 把 distill 产出的观点写成成文。
• 方法论参考 huashu-weread-advisor 的 alchemy（读书线的划线→笔记提炼）——distill 是它在文章线的对应物。仅借鉴方法，不改其文件（第三方 skill）。

第三方 skill 关系