# Kb Inbox Digest

> ---

- Skill: `jiyangnan/kb-inbox-digest-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jiyangnan/kb-inbox-digest-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiyangnan/kb-inbox-digest-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jiyangnan (https://skillmd.com/u/jiyangnan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jiyangnan/kb-inbox-digest-2

---

---
name: kb-inbox-digest
description: Convert shared links into KB workflow: fetch -> normalize -> QA -> route to Obsidian -> deliver digest summary.

## Use When
- 用户说"跑 KB 闭环"、"处理链接"、"我又塞了链接"
- 需要把链接批量入库时
- 构建/调试 KB/Skills/Cron 管道时
- 需要检查为什么链接没被摄入时
- 需要手动触发每日 Digest 时

## Don't Use When
- 只有单个链接不需要批量处理（直接用 kb-fetch + kb-normalize + kb-qa-score 即可）
- 用户只想预览不想入库（分别调用子 skill 不要跑完整流程）
- 链接是文件下载而非网页（无法抓取内容）
- 链接是内部系统无法访问（会失败）
- 大量链接需要去重预处理（先手动清理）
- 用户只想检查哪些链接已处理（查 processed-links.md 即可）
- 只需要抓取不需要入库（只用 kb-fetch）
- 只需要结构化不需要评分（只用 kb-normalize）
- 只需要评分不需要入库（只用 kb-qa-score）
- 系统资源紧张无法处理大批量（分批处理）


# KB Inbox Digest（链接→知识沉淀）

把「我看到一篇好文章 → 直接把链接发给你」变成稳定的自动化：

**输入（Links）→ 抓取（Fetch）→ 结构化（Normalize）→ 评审（QA）→ 路由（Router）→ 沉淀（Obsidian KB）→ 返回摘要（由系统投递到 Telegram 私聊）**

## 固定路径（V0）

### 沉淀区（最终输出，Obsidian Vault）
- Vault 根：`$VAULT_ROOT/`
- KB：`Obsidian Vault/KB/`
  - `KB/inputs/inbox-links.md`：收链接（每行一个 URL，可在后面加备注）
  - `KB/inputs/processed-links.md`：已处理列表（防重复）
  - `KB/notes/`：verdict=keep 才能进
  - `KB/queue/`：verdict=queue/needs_context 进

### 执行区（小南瓜系统内，工作台）
- 规则库（执行用双份）：`$WORKSPACE/KB/rules/`
- 状态文件：`$WORKSPACE/KB/state/digest.json`

## 核心规则（不要走样）

1) **Obsidian KB 只沉淀最终输出**
- keep → notes
- queue/needs_context → queue
- discard → 不入库

2) **模块化调用（铁律）**
- 抓取统一走 `kb-fetch`
- 结构化统一走 `kb-normalize`
- 评分裁决统一走 `kb-qa-score`
- 落盘/状态更新统一走 `kb-router`

3) **默认 B（补全研究）**
- 用户只丢链接也能跑完整流程
- 如果用户随手加了备注（A：意图/想法），把备注写进最终笔记 frontmatter 或「可复用点」中

4) **输出摘要不要写"已发送到群/已发送到私聊"**
- 执行器只输出摘要文本；投递由系统处理

## 触发方式（事件驱动）

支持两种触发：

1) **用户直接发链接**（默认）
- 从 Telegram / 飞书 / Discord 任意渠道收到 URL → 立即按本流程处理。
- 用户可选在同一条消息里追加一句备注（A：意图/想法），形如：
  - `<URL> // 一句话想法`

2) **用户发口令**
- 口令示例：`处理一下这个链接`
- 若口令消息里未包含 URL：优先使用"上一条包含 URL 的消息"；仍没有则向用户索要。

## 执行步骤（处理一批链接）

当被触发时：

1. 从当前消息中抽取 URL（允许一条消息多链接）；若没有则回退到 `KB/inputs/inbox-links.md` 作为兜底输入源。
2. `read` digest.json，过滤已处理
3. 选取新 URL（**每轮最多 10 条**；剩余留到下一轮由用户确认继续）
4. 对每条：
   - 抓取：用 `kb-fetch`
   - Normalize：用 `kb-normalize`
   - QA：用 `kb-qa-score`
   - Router：用 `kb-router`（写入 notes/queue + 更新 processed-links 与 digest.json）
5. 输出 1 条简短摘要：
   - 本轮处理 N 条；keep/queue/discard 数量
   - keep：标题 + 一句话结论 + notes 路径
   - queue：卡点 + 需要 boss 做什么

## 自动化（Cron 推荐配置）

- **每日模式（9:00）**：兜底汇总（防漏/防失败），不要做高频轮询。

> 备注：具体 cron 任务由主代理用 `cron` 工具维护（避免在技能里硬编码 jobId）。

## 常见故障排查

- **微信抓不到正文**：用 browser 回退；如果出现登录/验证码，提示 boss 在 openclaw profile 登录一次。
- **重复提醒/刷屏**：检查是否启用了高频轮询类任务（应禁用）；摘要中禁止"已发送到群"之类误导语。
- **路径混用**：确认只有 keep/queue 才写入 Obsidian Vault；其他中间产物留在 workspace。