Blog

---
name: swcc-blog
description: Use when the user wants to turn what they learned, discussed, or clarified in this conversation into one or more readable blog articles. 触发:「生成 blog」「写成博客」「把今天学的整理成文章」「写成几篇笔记」「沉淀成 blog」「整理成文」「写成博文」。
argument-hint: "[拆分提示，如 3 或 按章节] [out:<目录>]"
user-invocable: true
---

# swcc · blog — 把本轮学习/讨论沉淀成 blog

把**当前这轮对话**里学到的、问到的、澄清的内容,合成 1 篇或多篇**可读的 blog 文章**,写到用户可见的目录(默认当前工作目录,便于 git/发布)。

> 本技能读**当前对话**(主) + 可选地读该专题 knowledge-system 作背景,只**写 blog 文件到工作目录**,**不碰 progress/tree**。

参数:`$ARGUMENTS` —— 可选拆分提示(如 `3`、`按章节`、`每个主题一篇`)、可选 `out:<目录>`(默认 `./blogs/`)。

---

## 核心原则

1. **沉淀讨论的增量,不是复述提纲。** 最值钱的是本轮对话里**澄清出的理解、踩过的坑、想通的点**——blog 要把这些写进去,而不是照抄 knowledge-system。
2. **blog 级可读文章。** 有导语、有展开、有例子、有小结;是给人读的文章,不是 bullet 日志。
3. **拆分以用户为准。** 用户说几篇/怎么拆就照办;**没说时先提议一个拆法让用户确认**,再写。
4. **写到用户可见处。** 默认 `./blogs/`(当前目录),可被 `out:` 或用户口头指定覆盖;**不埋进插件数据目录**。
5. **不碰 progress/tree。** 纯内容产出。

---

## 与相邻技能的区别

| 命令 | 产出 | 给谁看 |
|---|---|---|
| stop | review-session 记录(评分/薄弱点) | 给系统记账 |
| compound | reports/ 趋势报告 | 看进度趋势 |
| deep | deep-notes/ 单概念横向拓展 | 拓宽视野 |
| **blog** | **可读 blog 文章(本轮学习+讨论)** | **给人读 / 发布** |

---

## 流程

### 1. 框定来源与范围
- 回顾**当前对话**:本轮学了/讨论了/澄清了哪些主题、达成了哪些有价值的理解与结论。
- 本轮没有可成文的实质学习/讨论 → 告知用户「本轮没有可成文的内容」,停止。

### 2. 定拆分
- 用户给了篇数或边界(如「3 篇」「按章节」「每个主题一篇」)→ 照办。
- 没给 → **先提议一个拆法**(例:「本轮覆盖了 A / B / C 三块,建议拆 3 篇,分别讲…;或合成 1 篇综述。你要哪种?」)让用户确认或调整,再写。

### 3. 定输出目录
- 有 `out:<目录>` 或用户口头指定 → 用它;否则默认 `./blogs/`(当前工作目录)。写前 `mkdir -p`。

### 4. 写 blog（每篇一个文件,长文分块）
- 每篇文件名 = 文章标题的小写 kebab-case(如 `./blogs/<title>.md`)。
- **多篇** → 用 **TodoWrite** 每篇一个 todo,逐篇写、逐篇勾;**单篇过长**也按数据契约第十二节先骨架后分块追加,避免超时。
- 每篇结构(可按主题调整):
  ```markdown
  # <文章标题>
  > <一句话导语:这篇讲什么、读完能得到什么>

  ## 背景 / 要解决的问题
  <为什么要搞清这个>

  ## 正文
  <把对话里讲透/澄清的内容写成连贯讲解,配具体例子;该深则深>

  ## 容易踩的坑 / 澄清
  <本轮对话里纠正过的误解、边界条件、设计取舍>

  ## 小结
  <要点回顾 / 一句话带走>
  ```
- 内容**以本轮对话为主**,用自身知识补全连贯性,可选地引 knowledge-system 作背景。**忠实于讨论里实际达成的理解**,不要塞没讨论过的泛泛内容。

### 5. 输出摘要
```
📝 已生成 <n> 篇 blog
  · <title-1>  → <路径>
  · <title-2>  → <路径>
```

---

## 质量基准
- 每篇是连贯可读的文章,体现了本轮**讨论/澄清的增量**,不是 knowledge-system 的复述。
- 拆分符合用户意图(或经用户确认)。
- 写到了用户指定/默认的可见目录;progress/tree 未动;多篇/长文分块写、未超时。