knowledge-compile

name	knowledge-compile
description	把一堆 raw markdown（抓取/笔记/文章）压成 Obsidian 风格 wiki —— 有 TOC、有按主题聚合、有日简报
allowed-tools	["Read","Write","Glob","Grep","Bash"]
triggers	["整理","编译","compile","wiki","知识库","digest","简报","归档","沉淀","llm-wiki","日报","周报","obsidian"]
tags	["knowledge","compile","wiki","obsidian","digest"]
priority	7

知识编译技能：把 raw markdown 变 wiki

把一个目录下的散装 markdown（抓取的推文、知乎回答、文章笔记 ...）整理成结构化 wiki。产出在 Obsidian 里双链可用。

何时用

• 用户说"整理今天抓的内容"、"把 X 目录编译成 wiki"、"生成日报/周报"
• 和 browser-scrape 技能配套：先抓后编
• 和 cron 任务配套：定时 pipeline 的最后一环

输入

一个目录，里面可能有：

• 多个 *.md 文件（来自不同来源：twitter、zhihu、bilibili、read...）
• 可选的 raw/*.json（原始抓取数据，用作溯源）

产出（约定）

写回同一个目录下：

<input-dir>/
├── index.md              # TOC + 一览表
├── daily-digest.md       # 一屏内看完：一句话总览 + 100 字摘要 + 今日亮点
├── topics/
│   ├── <topic-slug>.md   # 按主题聚合，内部用 Obsidian 双链 [[source-file]] 回引原文
│   └── ...
└── raw/                  # 保留原始文件（若已有）

硬约束：

• 只新增 / 覆盖上面四类文件；不要删 .md 原文或 raw/
• 原文保留在原路径，通过 [[文件名]] 双链引用
• 所有时间用 ISO 格式（2026-04-22T17:05:00+08:00）
• 中文优先，技术术语保留英文原词

工具选择（很关键）：

• 创建新文件（index.md、daily-digest.md、topics/<slug>.md）：必须用 Write 工具，它会自动 mkdir -p 父目录。
• 修改已存在文件：用 Edit 或 HashlineEdit。
• HashlineEdit / Edit 对不存在的路径会报 File not found —— 不要用它们写新文件。

标准执行流程

步骤 1：扫描输入目录

Glob: <input-dir>/*.md
Glob: <input-dir>/raw/*.json   # 可选

读每个 .md，抽取 frontmatter（至少 source / url / scraped_at 可能存在），取第一段作为摘要候选。

步骤 2：聚类成主题

• 用内容相似性 + 关键词共现，把文件分成 3-7 个主题
• 主题名短、名词化、中文：如 模型发布、AI 工具、工程实践、安全与对齐
• 每篇文章归入一个主主题（避免重复计数带来的膨胀）
• 主题 slug 用拼音或英文短语：model-releases、ai-tools、engineering、safety-alignment

步骤 3：写 topics/<slug>.md

模板：

---
topic: 模型发布
slug: model-releases
article_count: 5
generated_at: 2026-04-22T17:05:00+08:00
---

# 模型发布

## 本期概要
<2-3 句话说明本主题下的整体动态>

## 条目

### [[twitter-17xxx]] — Anthropic 发布 Claude Opus 4.7
- 来源：X @AnthropicAI
- 时间：2026-04-22 09:30
- 要点：
  - <bullet 1>
  - <bullet 2>

### [[zhihu-abc123]] — <标题>
...

关键点：

• [[文件名]] 不带 .md 后缀，指向原文件 stem
• 一条一个 H3，不要堆成长段落
• 要点用 bullet，每条 ≤ 30 字，严禁复述原文

步骤 4：写 index.md

---
generated_at: 2026-04-22T17:05:00+08:00
article_count: 23
topic_count: 5
---

# 索引 · 2026-04-22

## 主题一览

| 主题 | 条目数 | 入口 |
|---|---|---|
| 模型发布 | 5 | [[topics/model-releases]] |
| AI 工具 | 8 | [[topics/ai-tools]] |
...

## 原始文件

- [[twitter-17xxx]]
- [[zhihu-abc123]]
- ...（按时间倒序）

步骤 5：写 daily-digest.md

硬约束：一屏能看完。用户在微信日报里看到的就是这份。

---
date: 2026-04-22
article_count: 23
topic_count: 5
---

# 今日简报 · 2026-04-22

## 一句话总览
<15 字以内的主线，例如：Anthropic 发 Opus 4.7，社区讨论集中在长上下文成本>

## 100 字摘要
<精炼到 3-4 句话>

## 今日亮点
1. **模型发布**：Opus 4.7 上线，上下文 1M tokens（[[topics/model-releases]]）
2. **AI 工具**：Cursor 推出背景 Agent（[[topics/ai-tools]]）
3. **工程实践**：...

## 报告位置
- 完整索引：[[index]]
- 原始归档：`<input-dir>`

步骤 6：返回摘要给用户

简要告诉用户：

• 扫描到多少文件、聚成多少主题
• 产出的 index.md / daily-digest.md / topics/* 路径
• 如果后续要推送（Notify 工具 / cron 的 notify_channel），提示用户要把 daily-digest.md 的内容作为通知 body

和其他技能的接力

上游	本技能	下游
browser-scrape 抓到 <dir>/*.md	编译成 wiki	Notify 工具把 daily-digest.md 发到飞书
用户手动往目录里丢 markdown	同上	同上
cron 定时触发	输入目录由 date 决定	cron 的 notify_on=success 自动触发

常见错误与对策

• 聚类过细：20 篇文章分出 15 个主题 → 主题变"标签"。合并成 3-7 个主主题
• 主题间重复：同一篇在多个主题里出现 → 每文只归一个主主题
• digest 太长：超过一屏就不叫 digest。限制：总览 15 字、摘要 100 字、亮点最多 5 条
• 忘了双链：用 [原文](file.md) 写法 Obsidian 不能双向跳转；必须用 [[file]]
• 误删原文：本技能只写不删，原文件保持不动

不做的事

• 不做事实核验（Fact-check 不是本技能职责）
• 不做翻译（除非用户明确要求）
• 不加广告/情绪评价（保持中立）
• 不抓新内容（抓取是 browser-scrape 的事）