用途#
clip-to-wiki 是用于处理网页剪藏 Markdown 的 Claude Code skill。它的目标不是简单移动文件,而是把网页剪藏作为“证据层资料”读完后,自动判断应该进入哪个 LLM Wiki 主库,并完成基础归库更新。
从外部平台直接提供 URL 时,使用 $hz-link-to-wiki <URL> 获取正文并建立笔记;已经保存为 Clippings/*.md 的本地 Markdown 继续使用 /clip-to-wiki Clippings/xxx.md。
Skill 文件位置:.claude/skills/clip-to-wiki/SKILL.md
调用方式#
常用写法:
/clip-to-wiki Clippings/xxx.md
整理这个网页剪藏
把这个 clip 自动归库
识别这个网页剪藏属于哪个知识库并更新
处理刚刚剪藏的 md
如果没有提供路径,skill 会优先检查:
Clippings/*.md中最新修改的 Markdown,排除README_已迁移.md。- 各库
00_inbox/*.md中最新修改的 Markdown。 - 若候选不止一个,会先询问确认,不自动批量处理。
分流规则#
| 推荐归属 | 典型内容 | 默认位置 |
|---|---|---|
| 01 口腔生信研究库/index | 牙周炎、OSCC、口腔微生物、口腔免疫、项目分析计划 | 00_inbox/ 或项目 sources |
| 02 文献精读与汇报库/index | DOI、PMID、Abstract、论文页面、PubMed/PMC、Nature/Cell/Science | 00_inbox/ 或 01_sources/papers/web_clips/ |
| 03 生信教程与工具库/index | Seurat、Scanpy、GEO/TCGA/SRA、pipeline、conda、Linux、生信教程 | 01_sources/web_clips/ |
| 04 AI_API与自动化库/index | Claude Code、MCP、API、LLM、agent、skill、自动化脚本 | 01_sources/web_clips/ |
| 05 个人事务与系统库/index | 报销、行政、Windows、代理、个人任务、系统安装 | 02_wiki/事务/ 或 02_wiki/电脑与系统/ |
| 99 待确认归档/index | 来源不明、内容太短、主题混杂、敏感信息、无法判断 | 00_未判定文件/ |
置信度规则#
confidence >= 0.75:直接归入推荐库并更新日志。0.45 <= confidence < 0.75:进入推荐库00_inbox/,标注待复核。< 0.45:进入 99 待确认归档/index。- 命中 API key、token、cookie、password、证件号等敏感信息时,不做详细摘要扩散,优先待确认或脱敏后处理。
每次会做什么#
- 读取原始剪藏全文。
- 解析 frontmatter、标题、链接、论文 ID、关键词和敏感信息。
- 输出“分类判断”:推荐归属、置信度、证据、目标路径、后续更新。
- 检查
kb_id:保留来源笔记已有编号;若缺失,先用npm run kb:assign-ids -- --file "源文件相对路径.md" --apply分配永久编号,再移动并保留在目标笔记 frontmatter。绝不按标题或路径自行造号。 - 补充或创建 frontmatter:
type: web_clip、kb_id、source_url、classified_to、classification_reason、classification_confidence、processed、processed_at。 - 添加 5-10 行 LLM 归库摘要块。
- 移动到目标库证据层或 inbox。
- 更新目标库
05_logs/ingest_log.md;日志记录同一kb_id;低置信度则更新99 待确认归档/05_logs/clip_triage_log.md。
安全边界#
- 不处理
.obsidian/、.claude/、配置文件或依赖目录中的文件。 - 不批量处理多个未知剪藏,除非明确要求。
- 不默认下载外部图片;需要“本地化图片”时才下载到同目录
attachments/。 - 不大规模改写旧链接。
- 论文类剪藏只做初步归库;深度文献整理继续使用
paper-import-workflow。
后续可扩展#
第一版是“手动调用、半自动执行”。如果以后需要每次网页剪藏后自动触发,可以再配置 hook 或外部文件监听脚本,例如 .claude/scripts/clip_to_wiki_scan.py,由脚本负责扫描候选,最终分类与写入仍交给 Claude 执行。