| 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/)。
核心原则
- 沉淀讨论的增量,不是复述提纲。 最值钱的是本轮对话里澄清出的理解、踩过的坑、想通的点——blog 要把这些写进去,而不是照抄 knowledge-system。
- blog 级可读文章。 有导语、有展开、有例子、有小结;是给人读的文章,不是 bullet 日志。
- 拆分以用户为准。 用户说几篇/怎么拆就照办;没说时先提议一个拆法让用户确认,再写。
- 写到用户可见处。 默认
./blogs/(当前目录),可被 out: 或用户口头指定覆盖;不埋进插件数据目录。
- 不碰 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（每篇一个文件,长文分块）
5. 输出摘要
📝 已生成 <n> 篇 blog
· <title-1> → <路径>
· <title-2> → <路径>
质量基准
- 每篇是连贯可读的文章,体现了本轮讨论/澄清的增量,不是 knowledge-system 的复述。
- 拆分符合用户意图(或经用户确认)。
- 写到了用户指定/默认的可见目录;progress/tree 未动;多篇/长文分块写、未超时。
