@topmindspace/topmind-skills 4.15.0 → 4.15.1

package/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill_name": "topmind",
   "daily_entry": "topmind",
-  "version": "4.15.0",
+  "version": "4.15.1",
   "evals": [
     {
       "id": 1,
@@ -252,6 +252,29 @@
       "primary_skill": "topmind-organize",
       "extra_skills": [],
       "expected_output": "Organize 整理本周 on the activity window: tidies the period note in place, then L1-suggests todo maintain diff (add/complete/update vs memory/todo.md) and optional memory/topic candidates per shared/auto-suggest.md. User accepts before writing todo/memory changes. No auto memory writes, no INDEX.md."
+    },
+    {
+      "id": 35,
+      "prompt": "对比一下 Claude 和 Gemini 最新发布的技术报告，要带一手来源。",
+      "primary_skill": "topmind",
+      "extra_skills": [
+        "topmind-organize"
+      ],
+      "expected_output": "Router applies the 研究 / 分析 / 对比 row in shared/trigger-disambiguation.md: the request needs external primary sources, so it hands off to the optional external skill topmind-research (analyze) when installed. When topmind-research is not installed, falls back to topmind-organize 研究分析 and states in the receipt that only workspace materials and host search were used. Output lands in a topic or Inbox per shared/writeback-receipt.md with source_type: ai-derived. No auto memory writes, no auto chaining to briefs or write."
+    },
+    {
+      "id": 36,
+      "prompt": "对比一下 20-研究/2026-示例研究 专题里已经存的几篇笔记的观点。",
+      "primary_skill": "topmind-organize",
+      "extra_skills": [],
+      "expected_output": "Routes through topmind-organize 研究分析 because the objects are notes already saved in the workspace; does not hand off to topmind-research even if it is installed. Builds a comparison table with provenance, writes the synthesis to a topic-root note per writeback_mode (leave-a-trace), and only L1-suggests memory candidates."
+    },
+    {
+      "id": 37,
+      "prompt": "这周 AI 大厂有什么新的官方动态？顺便看看社区怎么评价。",
+      "primary_skill": "topmind",
+      "extra_skills": [],
+      "expected_output": "Router splits into ordered steps per shared/trigger-disambiguation.md: official announcements, technical reports and papers → optional external topmind-research (collect); community discussion → optional external last30days. Does not route to topmind-organize 整理本周 (that phrase means the workspace stream category) and does not use TopStream每日精选 unless the user asks for the daily digest. Any skill that is not installed falls back to topmind-organize on saved workspace materials, and the receipt says so. Each step returns its own receipt; no auto chaining."
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-skills",
-  "version": "4.15.0",
+  "version": "4.15.1",
   "description": "topmind Agent Skills pack — portable markdown skills for capture, organize, write, memory, maintain, loop.",
   "type": "module",
   "license": "MIT",

package/shared/trigger-disambiguation.md

@@ -1,7 +1,8 @@
 # Trigger Disambiguation（路由消歧真源）
 
 > Router（`topmind`）与各子 skill 的「When NOT」必须与本表一致。  
-> 子 skill **不得**自动链式 dispatch 下一 skill；「下一步」仅用户面建议。
+> 子 skill **不得**自动链式 dispatch 下一 skill；「下一步」仅用户面建议。  
+> 外部可选技能（`topmind-research`、`topmind-briefs`、`last30days`、`TopStream每日精选`）不随本包发布：仅在宿主已安装时按表路由；未安装按该行写明的回退处理，回执可提示可选安装，不报错。
 
 ## 碰撞词裁决
 
@@ -21,6 +22,9 @@
 | 归档 | capture vs maintain | 「归档材料」→ capture。「归档专题 / archive topic」→ maintain |
 | 笔记 / note | capture vs write | 未限定 → capture。「写作 / 起草 / 续写」→ write |
 | 记账 / 记一笔 / 花了 / 存入 | ledger vs capture | 「记账 / 记一笔 / 花了 / 存入 / 查看账单 / 账户余额」→ `topmind-ledger`（记忆平面账本）。「记一下」仍 → capture |
+| 研究 / 分析 / 对比 | organize vs topmind-research（外部可选） | 对象是工作区里已存的笔记、专题内材料 → `topmind-organize`。需要对外检索一手资料（论文、技术报告、官方公告、模型或产品横向对比）、AI 前沿深挖 → `topmind-research`（analyze）；未安装 → `topmind-organize`「研究分析」 |
+| AI 动态 / 大厂动态 / AI 周报 / 最近有什么新的 | topmind-research vs last30days vs TopStream每日精选（均外部可选） | 官方公告、技术报告、论文的周度汇总 → `topmind-research`（collect）。社区讨论与口碑（X、Reddit、HN 等）→ `last30days`。每日精选例行 → `TopStream每日精选`。对应技能未安装 → `topmind-organize`（只用工作区已存材料，回执注明）。「整理本周 / 理顺本周动态」指工作区动态类别，仍 → organize「整理本周」 |
+| 读论文 / 论文解读 | topmind-research vs topmind-briefs（均外部可选） | 想弄懂内容、要带来源的研究报告 → `topmind-research`（analyze）；未安装 → `topmind-organize`「研究分析」。要直接出一篇短稿发布 → `topmind-briefs`（可附 research 产出的已核验事实表）；未安装 → `topmind-write` |
 | 公众号 / 微信排版 | wechat vs write | 「公众号 / 微信排版 / 公众号定稿 / 发公众号」→ `topmind-wechat`。通用「写一篇」仍 → `topmind-write` |
 
 **原则**：动作动词定 action；修饰词定 confidence。无法判定 → capture（先存后整）。
@@ -36,6 +40,7 @@
 | write | 稿件 / delivery | 为「补结构」空建 `topic.md` |
 | loop | 状态 / 可逆修复 | 代写记忆；建硬索引 |
 | ledger | `{memory.dir}/ledgers/` 追加一行 | 改 `topic.md`；发明 ClassFund/Giggs/Mom；当第六用户概念 |
+| topmind-research（外部可选） | 研究报告、周报、已核验事实表，按 `writeback-receipt.md` 落专题或 Inbox（frontmatter `source_type: ai-derived`） | 自动写记忆；自动改它自带的 `config/sources.yaml`；未经用户点名自动深挖；自动链式 briefs / write |
 
 ## 多意图顺序
 
@@ -46,6 +51,8 @@
 | organize + write | 先 organize（落盘综合），再 write |
 | organize + memory | 先 organize 候选与综合笔记，**用户接受建议后再** memory |
 | write + memory | 先 write，回执建议 memory |
+| research + write | 先 research 出报告与事实表，回执建议 briefs / write（不自动链式） |
+| research + memory | 先 research 落盘，回执建议 memory（须用户再确认才写） |
 | 整理 inbox | organize + plan-inbox-routing（不是 maintain/loop） |
 | 清理工作区 | maintain |
 

package/topmind/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind
-version: 4.15.0
+version: 4.15.1
 description: >-
   topmind 总入口与多意图路由（类别/专题/笔记/待办/交付）。Use when 用户说 topmind、意图模糊、
   待办/有什么要做的/todo list、或需要收→整→写 分步。单意图明确时直接用 topmind-capture|organize|write|memory|maintain|loop|weread|x|ledger|wechat。
@@ -23,7 +23,7 @@ compatibility: >-
 author: TopMindSpace
 license: MIT
 homepage: https://github.com/topmindspace/topmind
-updated: 2026-09-28
+updated: 2026-10-08
 degradation: ../shared/capability-degradation.md
 ---
 
@@ -51,7 +51,8 @@ degradation: ../shared/capability-degradation.md
 待办 / 有什么要做的/todo → 本 router           → 读 memory/todo.md 活跃项（卫星，非新概念）
 X 做完了 / 这条不用了    → 本 router           → 勾掉/归档对应待办（可恢复）
 整理本周/理顺流水        → topmind-organize    → 活动窗口就地理顺 + 建议（确认后写）
-整理/分析/研究/总结/对比 → topmind-organize    → 当前专题 / Inbox 路由 / 活动窗口
+整理/分析/研究/总结/对比 → topmind-organize    → 当前专题 / Inbox 路由 / 活动窗口（对象是已存材料）
+对外检索/论文/AI 动态    → topmind-research*   → 专题 / Inbox（*外部可选；未装 → organize）
 写/改/稿/交付/导出       → topmind-write       → delivery 或专题根
 公众号/微信排版/定稿发稿  → topmind-wechat      → 创作类 YYYY-公众号/ 交付包
 记住我/更新我的情况      → topmind-memory      → memory/profile.md（主 memory）
@@ -69,7 +70,7 @@ loop/整体体检/巡检       → topmind-loop        → .topmind/loop/ 可恢
 
 待办是 `memory/todo.md` **卫星**（与 profile 同层），不是第六概念。提取/维护语义见 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)。
 
-English: capture → capture · weekly review/organize (activity window) → organize · write → write · about me → memory/profile · period reflection → memory/periodic/{YYYY}/ · new topic folder → organize (content category) · doctor → maintain · loop → loop · bookkeeping/spent/deposited → ledger (`memory/ledgers/`, personal default).
+English: capture → capture · weekly review/organize (activity window) → organize · write → write · about me → memory/profile · period reflection → memory/periodic/{YYYY}/ · new topic folder → organize (content category) · doctor → maintain · loop → loop · bookkeeping/spent/deposited → ledger (`memory/ledgers/`, personal default) · external primary-source research / papers / official AI news → optional external `topmind-research` when installed, else organize.
 
 读配置：`stream.packing`（默认 weekly）· `stream.year_dir`（默认 true）· `memory.layers.global.file`（`profile.md`）。  
 **活动窗口**（Desktop/Kernel 与 organize 共用）：近期周期本 ∪ 近期改动笔记 ∪ 增补锚定的原文——不只「最新周期文件名」。
@@ -125,6 +126,7 @@ Which category? Which topic (or loose note)? Which object? Which action? Which s
 
 真源：[`../shared/trigger-disambiguation.md`](../shared/trigger-disambiguation.md)。  
 多意图：[`references/multi-intent.md`](references/multi-intent.md)。  
+外部可选技能（`topmind-research` 等）：不随本包发布，已安装才路由，未安装按真源表回退；不是第二前台。  
 Connector：[`references/connector-resolution.md`](references/connector-resolution.md)。
 
 ## Sub-Skill Receipt Chaining

package/topmind/references/multi-intent.md

@@ -11,6 +11,8 @@
 | organize + memory | 先 organize 候选，再 memory 落盘 | organize 产出列表 |
 | organize + todo | 整理本周后 L1 待办 diff 建议 | 不自动批量改清单 |
 | write + memory | 先 write，回执中建议 memory | 写作不改 memory/profile |
+| research + write | 先 research 出报告与已核验事实表，回执中建议 briefs / write | `topmind-research`、`topmind-briefs` 为外部可选；未装 research → organize「研究分析」，未装 briefs → write |
+| research + memory | 先 research 落盘专题或 Inbox，回执中建议 memory | research 不自动写记忆；用户确认后才走 memory |
 | 整理 inbox | `topmind-organize` + `plan-inbox-routing` | 不是 maintain/loop |
 | 清理工作区 | `topmind-maintain` | 系统健康 |
 

package/topmind-capture/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-capture
-version: 4.15.0
+version: 4.15.1
 description: >-
   把链接、摘录、随手记收进动态周期本、Inbox 或专题；行动语自动提取/建议待办。Use when 记一下、
   收进、剪藏、保存链接、记一下要做/别忘了、capture、save URL/idea、Note it。

package/topmind-ledger/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-ledger
-version: 4.15.0
+version: 4.15.1
 description: >-
   通用记账到记忆平面（默认个人/自己账本，用户自建账本与分类）。Use when 记账、记一笔、花了、存入、查看账单、账户余额。
   Do NOT use for 记一下到动态、待办、微信读书、发推、Feishu/lark-cli.

package/topmind-loop/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-loop
-version: 4.15.0
+version: 4.15.1
 description: >-
   可中断的工作区语义巡检（走专题/Inbox，.loop 断点续跑）。Use when 跑一遍 loop、巡检、整体体检、复盘、
   继续 loop、audit。Do NOT use for 快速 doctor（→maintain）、单专题整理、捕获、写作、仅记忆.

package/topmind-maintain/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-maintain
-version: 4.15.0
+version: 4.15.1
 description: >-
   确定性体检/清理/结构修复/回执恢复。Use when 快速体检、诊断、doctor、清理、修复、workspace check。
   Do NOT use for 整体巡检 loop、内容整理、捕获、写作、记忆.

package/topmind-memory/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-memory
-version: 4.15.0
+version: 4.15.1
 description: >-
   更新「我的情况」或周期反思。Use when 记住这个、更新我的情况、加到专题记忆、沉淀结论。
   Do NOT use for 捕获、仅总结（→organize）、整理本周正文、出稿、开/并专题、doctor/loop.

package/topmind-organize/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: topmind-organize
-version: 4.15.0
+version: 4.15.1
 description: >-
   整理本周动态、专题内整理/研究/分析/路由 Inbox。Use when 整理本周、整理、分析、研究、对比、总结要点、organize、summarize。
-  Do NOT use for 首次捕获、最终出稿、仅写我的情况、快速 doctor、全库 loop.
+  Do NOT use for 首次捕获、最终出稿、仅写我的情况、快速 doctor、全库 loop、对外检索一手资料与 AI 前沿深挖（已装外部 topmind-research 时）.
 action_category: organize
 triggers:
   - 整理本周
@@ -37,7 +37,7 @@ compatibility: topmind workspace with stream period notes, topics, or Inbox.
 author: TopMindSpace
 license: MIT
 homepage: https://github.com/topmindspace/topmind
-updated: 2026-09-28
+updated: 2026-10-08
 degradation: ../shared/capability-degradation.md
 ---
 
@@ -59,6 +59,7 @@ degradation: ../shared/capability-degradation.md
 - 交付最终报告/文章 → `topmind-write`  
 - 只写「我的情况」/ 周期反思 → `topmind-memory`  
 - doctor / 全库巡检 → `topmind-maintain` / `topmind-loop`  
+- 对外检索一手资料（论文、技术报告、官方公告、模型或产品横向对比）、AI 前沿深挖、周度官方动态 → 外部可选 `topmind-research`（已安装时）；未安装仍由本 skill「研究分析」接手，回执注明来源范围（见 [`../shared/trigger-disambiguation.md`](../shared/trigger-disambiguation.md)）  
 
 ## 动作入口判断
 
@@ -110,6 +111,8 @@ degradation: ../shared/capability-degradation.md
 
 证据链：来源 → 事实 → 推断 → 待验证。对比用表；保留 URL/日期；区分确认与假设。有价值的对比/结论同样**默认落盘**（专题根 md），避免只留在聊天里。
 
+对象是工作区已存材料。需要对外检索一手资料时，已装外部可选 `topmind-research` 则交给它；未安装时本节接手，回执写明只用了工作区材料和宿主可用的检索。
+
 ### 实体提取（非默认）
 
 仅显式要求时。实体附证据；不建默认子目录。

package/topmind-pack.json

@@ -4,8 +4,8 @@
   "label": "topmind",
   "description": "topmind skill pack: single daily entry topmind + progressive disclosure (shared/ + references/), Agent Skills open-standard aligned, capture-first template-driven categories, optional connectors topmind-weread and topmind-x, optional topmind-ledger (记账), optional write sub-skill topmind-wechat. None of the optional skills is an extra user concept. File-system-first content truth; UTR optional.",
   "daily_entry": "topmind",
-  "version": "4.15.0",
-  "updated": "2026-09-28",
+  "version": "4.15.1",
+  "updated": "2026-10-08",
   "license": "MIT",
   "locales": {
     "default": "zh-CN",

package/topmind-wechat/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-wechat
-version: 4.15.0
+version: 4.15.1
 description: >-
   公众号文章全生命周期子技能（write 族）：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。
   支持 forward（底稿→公众号）、reverse（选题原创→回推）、站外拉取（在线精选站→reverse+pending）三条路径；

package/topmind-weread/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-weread
-version: 4.15.0
+version: 4.15.1
 description: >-
   同步微信读书划线/想法/统计到专题。Use when 微信读书、划线同步、weread、读书笔记。
   Do NOT use for 普通 URL 捕获、仅整理、出稿、X.

package/topmind-write/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-write
-version: 4.15.0
+version: 4.15.1
 description: >-
   写作/润色/出稿到专题或交付层（role:delivery）。Use when 写、起草、续写、润色、出稿、交付、write、draft、deliver。
   Do NOT use for 仅捕获、仅结构整理、只写记忆、doctor/loop、社交连接器.

package/topmind-x/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-x
-version: 4.15.0
+version: 4.15.1
 description: >-
   X/Twitter：归档/搜索（Bearer）、发帖（xurl）、Agent 可用官方 MCP。Use when 发推、推特、twitter、x.com。
   Do NOT use for 微信读书、非 X 捕获、doctor、长文交付.