topmindspace

topmind-capture

把链接、摘录、随手记收进动态周期本、Inbox 或专题。Use when 记一下、收进、剪藏、保存链接、capture、save URL/idea。 Do NOT use for 整理本周、出稿、写我的情况、doctor/loop、微信读书、X.

topmindspace 2 1 Updated 1mo ago
GitHub

Install

npx skillscat add topmindspace/topmind/topmind-capture

Install via the SkillsCat registry.

SKILL.md

topmind Capture

先存材料(用户动词:记一下)。不负责重塑、交付、诊断或外部连接。

Activation checklist

  1. 工作区根 + list-categories / 扫盘(跳过 hidden)
  2. 读 topmind.yaml 的 stream.packing(默认 weekly)
  3. 按内容性质选 真实目录名(role;禁止写死编号)
  4. 日常/动态 → 追加到当前周期本;专题明确 → 专题根;不清 → Inbox
  5. 写 frontmatter;白话回执(如「已记到每周一本」);不自动 organize/write

When NOT to use

  • 整理已有内容 → topmind-organize
  • 基于素材写稿 → topmind-write
  • 写入「我的情况」/ 周期反思 → topmind-memory
  • 系统体检 / 巡检 → topmind-maintain / topmind-loop
  • 微信读书 / 发推 → connectors

消歧总表:`../shared/trigger-disambiguation.md`。

Inputs

  • URL / 文件名 / 来源标签
  • 摘录、想法、自由文本
  • 当前类别/专题(若有)
  • 可选 title、route confidence

Routing(低摩擦)

先 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 术语(回执可用「本周动态」)。

UTR:capture-note(自动识别周期本)。Desktop:ingestInbox dest.mode=stream(默认)。

Provenance

source_type: user-original | external-capture | ai-derived。

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`。

层 谁 能力
L1 Desktop fetchUrl / host fetch Mozilla Readability + 启发式
L2 Desktop 增强渲染 SPA 空壳(ephemeral Chromium)
L3 手动粘贴 永远可用
L3+ 浏览器扩展 Clip Bridge 活 DOM Readability → Desktop 清洗落盘

Agent host 能 fetch 则提取正文,否则保留 URL + 摘录;推荐日常剪藏走 L3+。

本地文档 / Office / 邮件 / 统一捕获

协议:`../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`)
  5. 回执:路径、目标、信心、下一步(不自动触发其他 skill)

边界:只写材料笔记。禁止改 topic.md、禁止自动 organize/memory。存完可在回执建议「需要时整理」——仅用户面,不自动链式。

「刚才收哪」:按 mtime 扫近期 .md(或 UTR list-recent-captures advanced)。

Capability Degradation

见 `../shared/capability-degradation.md`。主命令:capture-note · list-categories · list-topics。

保存设置

  • 自动保存 (auto):直接写入并返回路径回执(path receipt)
  • 需要审阅 (confirm):先进入目标路径/内容审阅入口再保存
  • Host 可编码为 writeback_mode: auto | confirm。详见 `../shared/writeback-receipt.md`。

Categories