@topmindspace/topmind-skills 4.15.6 → 4.15.7

package/topmind/SKILL.md

@@ -1,174 +1,58 @@
 ---
 name: topmind
 description: >-
-  topmind 总入口与多意图路由（类别/专题/笔记/待办/交付）。Use when 用户说 topmind、意图模糊、
-  待办/有什么要做的/todo list、或需要收→整→写 分步。单意图明确时直接用 topmind-capture|organize|write|memory|maintain|loop|weread|x|ledger。
-  Do NOT invent parallel front doors; do NOT skip a matching sub-skill.
+  topmind 工作区入口：处理模糊请求、待办查询和多动作任务。Use when topmind、有什么要做的、收集并整理成稿。Do NOT intercept a clear single-action sub-skill.
 license: MIT
 compatibility: >-
   topmind workspace with {NN-Name}/ categories. Host file tools primary; UTR optional.
   Install with shared/ sibling for progressive disclosure links.
 metadata:
-  version: "4.15.6"
+  version: "4.15.7"
   action_category: "router"
   entrypoint: "true"
   triggers: "topmind, 知识库, 工作区, 待办, 有什么要做的, 要做的事, todo, todo list"
   tags: "router, entrypoint, topmind"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-24"
+  updated: "2026-10-26"
   degradation: "../shared/capability-degradation.md"
 ---
 
-# topmind Router
+# topmind
 
-唯一日常入口：`topmind`。子 skill 是**实现模块**（可被 host 单独激活），不是产品第二前台。
+用户日常入口是 `topmind`；单意图明确时直接使用对应子技能。不要让用户选择内部模块。
 
-## Activation checklist（激活后立即做）
+## 识别与执行
 
-1. 确认工作区根（host 提供；不硬编码绝对路径）  
-2. 扫 `{NN}[- ]{Name}/` 或 UTR `list-categories`（WorkspaceModel：role / hidden / source）  
-3. 读 `topmind.yaml`（contract_version **4**）若存在  
-4. 推断：**category · topic · object · action · writeback_mode**（auto|confirm）  
-5. 派生子 skill 语义（逻辑路由；不假装进程内调用 API）  
-6. 回执含路径；**不**自动链式下一 skill；L1 建议默认准备、L2 须用户确认（[`../shared/auto-suggest.md`](../shared/auto-suggest.md)）
+确认当前工作区根，按需读 `topmind.yaml` 与真实目录；已有本轮上下文不重复扫描。根据用户目标选择动作，缺少会影响结果的信息才询问。默认不加载整工作区。
 
+| 目标 | 技能 / 操作 |
+|---|---|
+| 记链接、摘录、想法、记一下要做某事 | `topmind-capture`；动态周期本 / 专题 / Inbox，显式待办进 `memory/todo.md` |
+| 待办有哪些、完成/更新某条待办 | 直接读写 `memory/todo.md`，不启动整理流程 |
+| 整理本周、总结/对比已有材料、开/并专题 | `topmind-organize`；临时问答按需回复，持久整理写回 |
+| 起草、润色、成稿、交付 | `topmind-write` |
+| 记住我、更新我的情况、周期反思 | `topmind-memory` |
+| 结构体检、修复、恢复 | `topmind-maintain` |
+| 全工作区语义巡检、长任务断点恢复 | `topmind-loop` |
+| 微信读书 / X / 记账 | 可选 `topmind-weread` / `topmind-x` / `topmind-ledger` |
 
-## Quick Reference
+外部检索研究、公众号、X 长文/短帖、封面/海报、幻灯片、交接的可选技能与容易混淆的请求，按需读 [路由消歧](../shared/trigger-disambiguation.md)。仅使用宿主实际可用的技能和工具；未安装专用技能时完成通用可行部分并说明限制。
 
-```text
-用户说什么              → 路由到哪            → 目标位置
-─────────────────────────────────────────────────────────────
-记/存/收/链接/想法       → topmind-capture     → 动态周期本 / 专题 / Inbox
-记一下要做 X / 别忘了 X  → topmind-capture     → 材料落盘 + 待办写入/建议（memory/todo.md）
-待办 / 有什么要做的/todo → 本 router           → 读 memory/todo.md 活跃项（卫星，非新概念）
-X 做完了 / 这条不用了    → 本 router           → 勾掉/归档对应待办（可恢复）
-整理本周/理顺流水        → topmind-organize    → 活动窗口就地理顺 + 建议（确认后写）
-整理/分析/研究/总结/对比 → topmind-organize    → 当前专题 / Inbox 路由 / 活动窗口（对象是已存材料）
-对外检索/论文/AI 动态    → topmind-research*   → 专题 / Inbox（*外部可选；未装 → organize）
-写/改/稿/交付/导出       → topmind-write       → delivery 或专题根
-公众号/微信排版/定稿发稿  → topmind-wechat-post* → 公众号交付包（*外部可选；未装 → write）
-X 长文 / 短文 / 引流帖   → x-article / briefs / viral-posts* → 稿件（*外部可选；未装 → write）
-记住我/更新我的情况      → topmind-memory      → memory/profile.md（主 memory）
-周期反思                 → topmind-memory      → memory/periodic/{YYYY}/（周期反思）
-开/并专题（内容夹）      → topmind-organize    → {大类}/{YYYY-主题}/（非 memory/topics）
-记住/专题语义记忆        → topmind-memory      → 仅用户明说 → 可选 memory/topics/
-快速体检/诊断/修复/清理  → topmind-maintain    → 工作区确定性检查
-loop/整体体检/巡检       → topmind-loop        → .topmind/loop/ 可恢复
-微信读书/同步划线        → topmind-weread      → connector 解析类别
-发推/推特/x.com          → topmind-x           → connector 解析类别
-记账/记一笔/花了/存入    → topmind-ledger      → memory/ledgers/（默认自己）
-研究报告做成幻灯片       → topmind-presentation* → HTML/PPTX（*外部可选；未装 → write）
-跨工具交接/导出记忆包    → topmind-handoff*    → 交接包（*外部可选；未装 → 回执说明）
-不确定 / 多意图          → 本 router 拆步      → 先 capture 再建议
-```
+用户一次要求多步，按依赖连续完成到最终交付；不因切换技能重复确认。用户未请求的延伸只给建议，见 [多意图](references/multi-intent.md) 与 [授权及建议](../shared/auto-suggest.md)。
 
-待办是 `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) · external primary-source research / papers / official AI news → optional external `topmind-research` when installed, else organize · WeChat (公众号) package → optional external `topmind-wechat-post` (topmind-writing-skills) when installed, else write.
+- 文件是内容真源。类别动态发现，跳过 hidden；名字取真实目录，低信心落 role:buffer，不访谈分类。
+- 动态默认按 `stream.packing` 追加周期本，`stream.year_dir` 默认 true；专题明确才进入专题。`topic.md` 有则按需读，不为补结构强建。
+- 我的情况默认 `memory/profile.md`，反思在 `memory/periodic/{YYYY}/`；开专题是在内容大类下建目录，只有明说语义专题记忆才用 `memory/topics/`。
+- 复利纪律：持久整理与稿件按意图落盘；临时问答不强存。不建 `INDEX.md` 硬索引或平行 wiki，不把会话当内容真源。
+- 内容与路径细节：[工作区模型](../shared/project-model-brief.md)；类别角色：[模板类别](references/template-categories.md)；连接器：[解析](references/connector-resolution.md)。
 
-读配置：`stream.packing`（默认 weekly）· `stream.year_dir`（默认 true）· `memory.layers.global.file`（`profile.md`）。  
-**活动窗口**（Desktop/Kernel 与 organize 共用）：近期周期本 ∪ 近期改动笔记 ∪ 增补锚定的原文——不只「最新周期文件名」。
+## 保存设置与交付
 
-## Core Model
+`writeback_mode: auto | confirm`，自动保存 auto 直接写 + 回执；confirm 内容编辑直接落盘，删除/归档走审阅入口。完整写闸、locked 首写快照和恢复语义见 [writeback-receipt](../shared/writeback-receipt.md)。用户的明确授权只覆盖请求范围，不能绕过程序围栏。
 
-```text
-User experience:     capture-first
-Data organization:   category-first + topic-emerges
-Object model:        category → topic → object
-Actions:             capture | organize | write | memory | maintain | loop | connector | ledger (optional)
-Save settings:       auto | confirm
-```
+主路径是宿主文件工具，UTR 可选；不编造 shell 或不存在的工具。工具不足时参照 [能力降级](../shared/capability-degradation.md)，失败不得伪装成功。仅操作当前 active 工作区。
 
-内容约定：[`../shared/project-model-brief.md`](../shared/project-model-brief.md)（**6 条核心规约**）。  
-输出语言：[`../shared/output-language.md`](../shared/output-language.md)（文档 AI：用户要求 → 原文 → 工作区 locale；产品 AI 建议条/待办：用户要求 → 宿主 UI → 工作区 locale）。  
-类别角色 / 扩展：[`references/template-categories.md`](references/template-categories.md)。  
-Host 加载说明：[`../shared/host-loading.md`](../shared/host-loading.md)。
-
-## Routing Question
-
-```text
-Which category? Which topic (or loose note)? Which object? Which action? Which save setting?
-```
-
-不要让用户选内部模块名。从自然语言推断。
-
-### Capture-first
-
-- 高信心类别+专题 → `{大类}/{专题}/`  
-- 高信心类别、中信心专题 → 写入专题 + 回执 `route_reason`  
-- 高信心类别、无专题 → `{大类}/*.md`，建议是否升级专题  
-- 低信心类别 → **role:buffer**（常为 `00-Inbox/`）+ L1 分类备选（最多 3）  
-- 跳过 `hidden` 类别  
-- 行动语 / 稳定个人信息 → 不打断落盘；写入或建议只按 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)
-
-### Minimum Context
-
-1. 扫描 `{workspace-root}/` → `{NN}[- ]{Name}/`  
-2. 读 `topmind.yaml`（template · `categories.extensions` · `categories.overrides` · separator）  
-3. 有 UTR → 优先 `list-categories`  
-4. 强推断专题时再读 `topic.md`（出稿/问答同样：**有则先读首页**，不强制创建）  
-5. **默认不加载整工作区**  
-
-### 复利纪律（不改结构）
-
-- **organize**：整理/总结默认落盘专题笔记，不只回话  
-- **write**：先 `topic.md`（若有）再必要笔记  
-- **memory**：仅用户明确沉淀；capture **禁止**改 topic.md  
-- **禁止**硬索引 `INDEX.md`、平行 wiki 树、entities/ 默认目录 
-
-## Disambiguation & Multi-Intent
-
-真源：[`../shared/trigger-disambiguation.md`](../shared/trigger-disambiguation.md)。  
-多意图：[`references/multi-intent.md`](references/multi-intent.md)。  
-外部可选技能（`topmind-research`、写作包 `topmind-wechat-post` / `topmind-x-article` / `topmind-briefs` / `topmind-viral-posts` / `topmind-cover` / `topmind-poster`、`topmind-presentation`、`topmind-handoff`）：不随本包发布，已安装才路由，未安装按真源表回退；不是第二前台，也不代用户发布。  
-Connector：[`references/connector-resolution.md`](references/connector-resolution.md)。
-
-## Sub-Skill Receipt Chaining
-
-- 子 skill **不得**自动 dispatch 下一 skill  
-- 下一步由 Router 再裁决或用户显式发起  
-- 例外：回执可**建议**「稍后 organize / loop」——仅用户面  
-- L1 建议（待办 / 记忆 / 分类 / 专题）同样只挂在回执上，不是链式调用  
-
-## Tool Boundary
-
-主路径：host 文件工具 + project-model-brief。Skills pack **不依赖** Pi / `pi-agent-core`；不要编造 bash / shell。宿主若有唯一片段替换，中段改稿优先用它。  
-降级：[`../shared/capability-degradation.md`](../shared/capability-degradation.md)。
-
-UTR 可选（MCP primary+danger 共 29；注册表 38 = 8 域 / 38 命令，见 TOOLS.md）：`list-categories` · `list-topics` · `inspect-topic` · `list-topic-files` · `list-inbox` · `create-topic` · `capture-note` · `save-output` · `contract.validate` · `contract.reseed` · `memory.promote` · `memory.digest` · `memory.append-profile` · `memory.append-topic` · `memory.retire-profile` · `memory.update-profile` · `memory.compact-history` · `memory.restore-profile` · `memory.list-todos` · `memory.add-todo` · `memory.toggle-todo` · `memory.update-todo` · `memory.set-todo-due` · `memory.delete-todo` · `doctor-workspace` · `plan-inbox-routing` · `archive-topic` · `archive-stream-year` · `restore-safety-receipt`。
-
-字段始终独立 **`category` + `topic`**（真实目录名，非写死编号）。
-
-## 保存设置
-
-- **自动保存 (auto)**：直接写 + 路径回执（危险动作可逆）  
-- **需要审阅 (confirm)**：分级——内容直接落盘；仅删/归档待确认  
-- `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。  
-
-
-## Error Handling
-
-写入失败不得静默丢数据。优先级与 locked 语义见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。工作区没有 `topmind.yaml` 时按默认契约解释，回执标注「默认契约」。
-
-
-
-`source_type`: `user-original` | `external-capture` | `ai-derived`。可选 `status` / `priority` / `method`。
-
-## Workspace Shape
-
-```text
-{workspace-root}/
-├── topmind.yaml             # v4 行为契约
-├── memory/                 # 语义平面（profile / periodic/{YYYY}/ / topics / todo.md / 可选 ledgers/）
-├── .topmind/               # 系统平面（index / loop / logs，可重建）
-├── {NN}-{Name}/               # buffer / loose-stream / deep-work / …
-├── {NN}-Outputs/              # role: delivery（常 88-交付）
-└── {NN}-Archive/              # role: system（常 99-归档）
-```
-
-专题：`topic.md?` + `*.md` + `images/?`。散记可在大类根。
-
-## Multi-Workspace
-
-只操作**当前 active** 工作区根。切换由 Desktop/host 负责。
+回复只需结果与实际路径；只有能帮助用户决策时才附建议，不固定列出信心、模式、理由等模板字段。输出语言按 [output-language](../shared/output-language.md)。宿主加载与安装问题才读 [host-loading](../shared/host-loading.md)。

package/topmind/references/multi-intent.md

@@ -1,21 +1,15 @@
-# Multi-Intent Resolution
+# 多意图：按用户最终目标执行
 
-当用户请求包含多个意图时，按以下矩阵裁决（与 `../../shared/trigger-disambiguation.md` 一致）：
+一次请求中的多个动作按依赖连续完成；只读出“下一步建议”不能替代用户已要求的交付。共享授权规则见 [auto-suggest](../../shared/auto-suggest.md)，路由边界见 [trigger-disambiguation](../../shared/trigger-disambiguation.md)。
 
-| 意图组合 | 裁决 | 说明 |
-|---------|------|------|
-| capture + organize | 先 capture，回执中建议 organize | 先确保材料落地 |
-| capture + memory | 先 capture，回执中建议 memory | 先存笔记再更新我的情况 / 周期反思 |
-| capture + todo | 先 capture；显式行动语同轮写 `memory/todo.md`，隐含则 L1 建议 | 见 `../../shared/auto-suggest.md` |
-| organize + write | 先 organize 提炼，再 write 输出 | 分两步 |
-| 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` | 系统健康 |
+| 用户已要求的组合 | 执行 |
+|---|---|
+| capture + organize / write | 先保存材料，再整理或成稿 |
+| capture + memory | 保存原材料，再把明确要求记住的稳定事实更新到记忆 |
+| organize + write | 提炼证据后直接交付稿件；不强制额外建综合笔记 |
+| research + write / presentation | 研究并核验来源，再完成文章或幻灯片；专用技能未装时完成可行部分并说明限制 |
+| organize + memory | 只有明确要求沉淀记忆的事实才写；推测候选先提案 |
+| organize + todo | “看看”给差异；“同步/更新”执行明确变化，保持真实写闸 |
+| write + memory | 先成稿，再写用户明确指定的稳定事实 |
 
-**三个以上意图**：分解为顺序步骤，逐步执行，每步返回回执。
-
-子 skill 回执里的「下一步」**不构成**自动链式触发。  
+三步以上同样按依赖执行。单个技能结束不是整项任务结束；未请求的附加工作留为建议。外部发布和不可逆动作仍遵守各自权限。

package/topmind-capture/SKILL.md

@@ -1,135 +1,46 @@
 ---
 name: topmind-capture
 description: >-
-  把链接、摘录、随手记收进动态周期本、Inbox 或专题；行动语自动提取/建议待办。Use when 记一下、
-  收进、剪藏、保存链接、记一下要做/别忘了、capture、save URL/idea、Note it。
-  记下/Log it 是动态主区「写入当前周期本」——路由仍进本 skill，但不作 frontmatter 触发词（见 shared/trigger-disambiguation.md）。
-  Do NOT use for 整理本周、出稿、写我的情况、doctor/loop、微信读书、X.
+  把链接、摘录、随手记保存到 topmind 动态、专题或 Inbox；显式行动同时记入待办。Use when 记一下、收进、capture、save URL/idea。Do NOT use for only editing existing notes or updating profile.
 license: MIT
 compatibility: topmind workspace. Host file tools or optional UTR capture-note.
 metadata:
-  version: "4.15.6"
+  version: "4.15.7"
   action_category: "capture"
   entrypoint: "false"
   triggers: "收集, 收进, 保存, 剪藏, 记一下, 临时存放, 随手记, 想法, 灵感, 暂存沉淀, 记录, 备忘, 存一下, 暂存, 笔记, 抄下来, 摘录, 记一下要做, 别忘了, 要做, capture, note, save, Note it"
   tags: "capture, inbox, note, material"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-24"
+  updated: "2026-10-26"
   degradation: "../shared/capability-degradation.md"
 ---
 
 # topmind Capture
 
-先存材料（用户动词：**记一下**）。不负责重塑、交付、诊断或外部连接。  
-**想记就记 / 随用随记**：材料默认零提问落盘。分类、待办、记忆的写入或建议只按 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)，本文件不另写一套阶梯，也不弹多选。
+把用户给的材料存下来，保留原文、来源和可找回的位置。用户说“记一下”时不访谈分类。多意图请求仍按 [授权及建议](../shared/auto-suggest.md) 完成已要求的后续工作。
 
-## Activation checklist
+## 路由与写入
 
-1. 工作区根 + `list-categories` / 扫盘（跳过 hidden）  
-2. 读 `topmind.yaml` 的 `stream.packing`（默认 **weekly**）  
-3. 按内容性质选 **真实目录名**（role；禁止写死编号）  
-4. **日常/动态** → 追加到当前周期本；专题明确 → 专题根；不清 → Inbox  
-5. 写 frontmatter；白话回执（如「已记到每周一本」）；**不**自动 organize/write  
-6. **同轮建议阶梯**：行动语 / 稳定个人信息 / 低信心分类只按 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)（不在这里复述）  
+从当前工作区上下文与 `topmind.yaml` 确定真实类别；已有本轮证据不重复扫描。跳过 hidden，不写死编号。
 
-## When NOT to use
+- 日常动态 → 当前周期本 append；`stream.packing` 默认 weekly，支持 daily/monthly/atom；`stream.year_dir` 默认 true。
+- 明确专题 → 专题根新笔记；类别清楚而无专题 → 大类根。
+- 不清楚 → role:buffer（常为 Inbox），先保证落盘；有用时附最多 3 个分类备选。
+- 待办 `memory/todo.md` 的显式写入与隐含提案，统一见 [auto-suggest](../shared/auto-suggest.md)。
 
-- 整理已有内容 → `topmind-organize`  
-- 基于素材写稿 → `topmind-write`  
-- 写入「我的情况」/ 周期反思 → `topmind-memory`  
-- 系统体检 / 巡检 → `topmind-maintain` / `topmind-loop`  
-- 微信读书 / 发推 → connectors  
+新材料记录适用的 `title`、`source_type`、来源 URL / captured_at；`source_type` 为 user-original / external-capture / ai-derived。保留引用与用户想法的区别，正文截断须说明。不为周期本每次追加重写全文件。
 
-消歧总表：[`../shared/trigger-disambiguation.md`](../shared/trigger-disambiguation.md)。
+禁止因 capture 顺手改 `topic.md` 或静默写 `memory/profile.md`、`memory/topics/`。只有用户明确要求更新记忆时才进入 memory。
 
-## Inputs
+## 特殊输入按需处理
 
-- URL / 文件名 / 来源标签  
-- 摘录、想法、自由文本  
-- 当前类别/专题（若有）  
-- 可选 title、route confidence  
+- 长 URL / 网页 → [long-url-capture](../shared/long-url-capture.md)，其中 L1/L2/L3 是抓取档，不是建议阶梯；有 fetch 则取正文，失败保留 URL/摘录并标明限制。GitHub Markdown 优先 raw/README。
+- 本地 Office / PDF / 邮件 / 文件夹 → [document-ingest](../shared/document-ingest.md)。有转换能力则转 MD；否则记录原文件位置，不冒充已读正文。
+- 用 UTR 时 `capture-note`；Desktop 对应 ingestInbox 的 stream 目标。没有这些工具时用宿主可用文件工具，不要求安装运行时。
 
-## Routing（低摩擦）
+## 保存与回执
 
-```text
-先 list-categories / 扫盘 + 读 topmind.yaml（schema v4）
-跳过 hidden；按 role + 内容性质选 directory（真实目录名）
-读 stream.packing（atom|daily|weekly|monthly，默认 weekly）
-
-high cat + high topic     → {大类}/{专题}/*.md（新文件）
-high cat + med topic      → 专题 + route_reason
-loose-stream + 无专题     → 当前周期本 append（packing≠atom）
-  packing weekly          → {动态类}/[YYYY/]YYYY-Www.md 今日段落下追加（year_dir 默认 true）
-  packing daily           → {动态类}/[YYYY/]YYYY-MM-DD.md 追加
-  packing monthly         → {动态类}/[YYYY/]YYYY-MM.md 追加
-  packing atom / forceAtom→ {大类}/YYYY-MM-DD-标题.md 新文件
-low cat                   → role:buffer（Inbox）
-```
-
-默认不访谈分类。存完可移动。禁止写死类名编号。用户只要「记一下」——不要解释 packing 术语（回执可用「本周动态」）。
-
-**低信心时不要只丢 Inbox 就完事**：仍落 buffer，回执附分类备选（最多 3 个，真实目录名），如「更像 ① 20-研究 ② 10-动态，说一声即可移」。详见 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)。
-
-### 待办与记忆（不打断捕获）
-
-捕获正文只写材料。待办、记忆、分类备选的 L0/L1/L2 只以 [`../shared/auto-suggest.md`](../shared/auto-suggest.md) 为准，**不**为分类/待办向用户提问。
-
-清单是语义平面卫星（`memory/todo.md`），**不是**新概念、**不**新建顶层 `todo/`。去重按文本；拒绝过的条目不要反复再提。**禁止**静默写 `memory/profile.md` 或 `memory/topics/`。
-
-UTR：`capture-note`（自动识别周期本）。Desktop：`ingestInbox` dest.mode=`stream`（默认）。
-
-## Provenance
-
-`source_type`: `user-original` | `external-capture` | `ai-derived`。
-
-```yaml
-title: …
-source_type: external-capture
-captured_at: 2026-07-13T15:30:00+08:00
-topic: {专题名}
-category: {大类目录名}
-route_confidence: medium
-route_reason: …
-status: todo
-```
-
-长 URL / 网页：[`../shared/long-url-capture.md`](../shared/long-url-capture.md)。那里的 L1/L2/L3 是**抓取档**，不是建议阶梯。
-
-Agent host 能 fetch 则提取正文，否则保留 URL + 摘录。GitHub 仓库 / Markdown 文件优先走 raw/README，不 HTML scrape。
-
-### 本地文档 / Office / 邮件 / 统一捕获
-
-协议：[`../shared/document-ingest.md`](../shared/document-ingest.md)。
-
-| 入口 | 能力 |
-|------|------|
-| **Desktop 统一捕获** | ⌘N 层 / ⌘⇧N 全局便签；智能粘贴文件；笔记+文档复合提交 |
-| **Desktop 知识加工 Hub** | 队列、批文件夹、转换器检测/安装；默认 anydoc（docx·doc·pdf·xlsx·pptx·odt·rtf·epub·csv）+ 内置 eml/html；可选 markitdown/pandoc |
-| **Agent** | 有转换能力则转 MD 后按 capture 写回；否则路径说明进 Inbox |
-
-默认 **md-only**；失败 original-fallback。不新增并列 skill 入口——仍走 `topmind` → `capture`。
-
-## Workflow
-
-1. 按内容性质推断类别（动态发现），再推断专题  
-2. 类别不清 → Inbox（+ 分类备选建议）  
-3. 保留 provenance；长文标注截断  
-4. 按保存设置写入（见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)）  
-5. 回执：路径、目标、信心、下一步（不自动触发其他 skill）  
-6. 待办 / 记忆 / 分类备选：只按 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)，不在回执外再写一套阶梯
-
-**边界**：只写材料笔记。**禁止**改 `topic.md`、禁止自动 organize、禁止静默写 memory/profile 或 memory/topics。存完可在回执**建议**「需要时整理 / 记入待办 / 更新我的情况」——仅用户面，不自动链式。
-
-「刚才收哪」：按 mtime 扫近期 `.md`（或 UTR `list-recent-captures` advanced）。
-
-## Capability Degradation
-
-见 [`../shared/capability-degradation.md`](../shared/capability-degradation.md)。主命令：`capture-note` · `list-categories` · `list-topics`。
-
-## 保存设置
-
-- **自动保存 (auto)**：直接写入并返回路径回执（path receipt）
-- **需要审阅 (confirm)**：分级——内容新建/更新/编辑直接落盘；仅删除/归档待确认
-- `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
+按 [writeback-receipt](../shared/writeback-receipt.md) 写入：auto 内容直接保存；confirm 内容编辑仍直接保存，仅删除/归档待审阅。回复保存结果和实际路径；失败保留材料并说明失败，不报告虚假成功。
 
+写回之外的细节：[工作区模型](../shared/project-model-brief.md)、[能力降级](../shared/capability-degradation.md)。

package/topmind-ledger/SKILL.md

@@ -1,19 +1,18 @@
 ---
 name: topmind-ledger
 description: >-
-  通用记账到记忆平面（默认个人/自己账本，用户自建账本与分类）。Use when 记账、记一笔、花了、存入、查看账单、账户余额。
-  Do NOT use for 记一下到动态、待办、微信读书、发推、Feishu/lark-cli.
+  在 topmind 记账、查账和更新账本，默认个人账本。Use when 记一笔、花了、存入、余额、bookkeeping。Do NOT use for generic reminders, note capture, or financial recommendations.
 license: MIT
 compatibility: Host file tools or Kernel writeback. Desktop optional mini-app. Feishu/lark-cli is not required.
 metadata:
-  version: "4.15.6"
+  version: "4.15.7"
   action_category: "memory"
   entrypoint: "false"
   triggers: "记账, 记一笔, 花了, 存入, 查看账单, 账户余额, bookkeeping, log expense"
   tags: "ledger, bookkeeping, memory, optional"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-24"
+  updated: "2026-10-26"
   degradation: "../shared/capability-degradation.md"
 ---
 

package/topmind-loop/SKILL.md

@@ -1,19 +1,18 @@
 ---
 name: topmind-loop
 description: >-
-  可中断的工作区语义巡检（走专题/Inbox，.loop 断点续跑）。Use when 跑一遍 loop、巡检、整体体检、复盘、
-  继续 loop、audit。Do NOT use for 快速 doctor（→maintain）、单专题整理、捕获、写作、仅记忆.
+  对 topmind 多专题或全工作区做语义巡检，长任务可断点续跑。Use when 整体巡检、全面复盘、跑一遍 loop、继续 loop。Do NOT use for a quick doctor check or organizing one topic.
 license: MIT
 compatibility: topmind workspace. Progress under .topmind/loop/*. Host LLM runs the walk; UTR optional.
 metadata:
-  version: "4.15.6"
+  version: "4.15.7"
   action_category: "loop"
   entrypoint: "false"
   triggers: "跑一遍 loop, loop 一下, 整体体检, 工作区复盘, 把工作区跑一遍, 巡检, 继续 loop, 从断点继续, 全面检查, 复盘, review, audit, walk"
   tags: "loop, audit, walk, resumable, cyclic"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-24"
+  updated: "2026-10-26"
   degradation: "../shared/capability-degradation.md"
 ---
 
@@ -27,19 +26,19 @@ topmind-loop = SKILL.md + agent host LLM + .topmind/loop/*.md
 
 ## Activation checklist
 
-1. 确认是**整体/可恢复**巡检（非快速 doctor）  
-2. 读/建 `.topmind/loop/*.md` 进度；可中断续跑  
-3. 步内可调用 capture/organize/… **语义**，不改类别名  
-4. 结束写摘要回执  
+1. 确认是**整体/可恢复**巡检（非快速 doctor）
+2. 范围长、需跨会话或用户要续跑时读/建 `.topmind/loop/*.md`；小范围单轮检查可直接完成
+3. 步内可调用 capture/organize/… **语义**，不改类别名
+4. 结束写摘要回执
 
 ## When NOT to use
 
-- 快速体检 / doctor / 修复索引 → `topmind-maintain`  
-- 整理当前专题笔记 → `topmind-organize`  
-- 存新材料 → `topmind-capture`  
-- 出稿 → `topmind-write`  
-- 沉淀「我的情况」/ 周期反思 → `topmind-memory`  
-- 发推 / 微信读书 → connectors  
+- 快速体检 / doctor / 修复索引 → `topmind-maintain`
+- 整理当前专题笔记 → `topmind-organize`
+- 存新材料 → `topmind-capture`
+- 出稿 → `topmind-write`
+- 沉淀「我的情况」/ 周期反思 → `topmind-memory`
+- 发推 / 微信读书 → connectors
 
 ## When to Invoke
 
@@ -53,29 +52,29 @@ loop 一下 {类别名}          → 该大类专题
 
 ## Three Pieces
 
-1. **本 skill** — 规约  
-2. **Agent host** — 执行与语义判断（无第二套 LLM 配置）  
-3. **`.topmind/loop/*.md`** — 进度真账  
+1. **本 skill** — 规约
+2. **Agent host** — 执行与语义判断（无第二套 LLM 配置）
+3. **`.topmind/loop/*.md`** — 进度真账
 
-Scopes、walk、guardrails 细节：[`references/scopes-and-walk.md`](references/scopes-and-walk.md)。  
-状态文件格式与 resume：[`references/state-file.md`](references/state-file.md)。  
+Scopes、walk、guardrails 细节：[`references/scopes-and-walk.md`](references/scopes-and-walk.md)。
+状态文件格式与 resume：[`references/state-file.md`](references/state-file.md)。
 设计取舍：[`DESIGN.md`](DESIGN.md)。
 
 ## Minimal Workflow
 
-1. 解析 scope（默认全跑）  
-2. 读或创建 `.topmind/loop/{scope}.md`（缺失则首次运行，不报错）  
-3. 从 `cursor` 起逐项：Read → Decide → Apply/Preserve/Escalate → Record  
-4. 更新 `last_run` / `done/total` / `cursor` / Receipts  
+1. 解析 scope（默认全跑）
+2. 需断点时读或创建 `.topmind/loop/{scope}.md`（缺失则首次运行，不报错）；单轮短检查不强制建台账
+3. 从 `cursor` 起逐项：Read → Decide → Apply/Preserve/Escalate → Record
+4. 更新 `last_run` / `done/total` / `cursor` / Receipts
 
 ## What Loop Does NOT Do
 
-- 不写交付正文（write）  
-- 不改专题目标/记忆（memory）  
-- 不 capture 新材料  
-- 不重复 maintain 的确定性检查（可调用其结果作证据，再加语义层）  
-- 不擅自改类别名、不自动升专题  
-- **不**为「补知识结构」自动写 topic.md / 建 INDEX.md / 建实体目录  
+- 不写交付正文（write）
+- 不改专题目标/记忆（memory）
+- 不 capture 新材料
+- 不重复 maintain 的确定性检查（可调用其结果作证据，再加语义层）
+- 不擅自改类别名、不自动升专题
+- **不**为「补知识结构」自动写 topic.md / 建 INDEX.md / 建实体目录
 
 材料多而首页空时：只在日志/回执**建议** organize 或 memory（见 scopes-and-walk），不代写。
 

package/topmind-maintain/SKILL.md

@@ -1,19 +1,18 @@
 ---
 name: topmind-maintain
 description: >-
-  确定性体检/清理/结构修复/回执恢复。Use when 快速体检、诊断、doctor、清理、修复、workspace check。
-  Do NOT use for 整体巡检 loop、内容整理、捕获、写作、记忆.
+  检查和修复 topmind 工作区结构、配置与恢复轨迹。Use when 体检、doctor、诊断、修复、恢复误删。Do NOT use for content synthesis or a resumable semantic workspace review.
 license: MIT
 compatibility: topmind engine and/or workspace. Prefer read-only diagnostics first.
 metadata:
-  version: "4.15.6"
+  version: "4.15.7"
   action_category: "maintain"
   entrypoint: "false"
   triggers: "快速体检, 体检, 诊断, doctor, 健康检查, 清理, 修复, 快速检查, 检查, 状态, workspace check, scan, fix, maintain"
   tags: "maintain, doctor, cleanup, audit, health-check"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-skills"
-  updated: "2026-10-24"
+  updated: "2026-10-26"
   degradation: "../shared/capability-degradation.md"
 ---