Expand note

Skill Criss404/agent-kb-toolkit/skills/expand-note

Turn any coding-agent harness into a disciplined personal knowledge-base builder — curation + transcription skills over plain Markdown. 双线知识库工具包:策展+转录,无需向量库。

Install

npx -y skills add Criss404/agent-kb-toolkit --skill expand-note

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

12 days oldThe repository was created 12 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

把知识库中一篇既有笔记深化为教材级学习内容(原理系统展开、多示例+反例、常见误区 FAQ、练习自测题),或对一个新主题做深度研究后写成教材级笔记。触发场景:用户说"深化/拓展某篇笔记"、"拓展某主题"、"写成教材/深度笔记/expand note/deepen this note"等。需要联网多来源交叉研究,一次只处理一个主题。

SKILL.md

3.2 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

Expand Note(教材级深化)

Overview

把一篇"概要级"笔记升级为教材级学习内容,或对新主题直接产出教材级笔记。与 save-to-kb 的分工:save 管快速记录(会话策展),本 skill 管深度成文(联网研究)。一次只深化一篇,可以长,但只讲一个主题。

安装配置

知识库根目录:由环境变量 KB_ROOT 指定(与 save-to-kb 共用)。
系列组织:与 save-to-kb 相同约定(主题系列子文件夹 + 前缀-NN 编号 + MOC 索引)。
写作规范复用同一工具包内 save-to-kb/references/standards.md。

执行流程

读原笔记(若是新主题则跳过):明确它已覆盖什么、缺什么
联网研究:官方文档、survey 论文优先,至少交叉核对 3 个来源;时效性论断必须当场验证
重写为教材级结构(见下),在原文件上扩写(保留 frontmatter,状态 改为 教材级,补 更新日期)
来源标注:每个关键论断标 [训练集] / [联网:链接] / [知识库:文件]
遵循同一工具包内 save-to-kb/references/standards.md 的全部写作与排版规范(术语英文(中文)、中英空格、表格优先)
若产生新概念,检查是否需要 [[wikilink]] 到其他笔记;必要时更新 MOC
向用户报告:文件路径、扩写前后字数、新增了哪些板块、引用了几个来源

教材级结构(四大板块,缺一不可)

# 标题
> 一句话定义
## 摘要                ← 3~5 条核心结论 bullets,自足可读(等价论文 Abstract;未来向量化时作为 Summary Index(摘要索引) 的检索层)
## 动机(解决什么问题)
## 原理系统展开        ← 不止结论:为什么、机制、推导;联网补对话中没讲透的部分
## 示例与反例          ← 每个核心概念 ≥2 个正例 + ≥1 个"什么时候不成立"的反例
## 常见误区与 FAQ      ← 新手易错点、易混概念辨析(如 RAG≠向量库)
## 练习与自测          ← 3~5 道检验理解的问题(附简答,用 Obsidian 折叠语法或文末统一给)
## 边界与局限
## 相关笔记
## 参考来源            ← 本次研究的全部来源,带链接

质量红线

禁止不联网就扩写——教材级的增量知识必须来自研究,不能靠模型脑补;无法验证的写"推断"
一次只深化一篇;用户说"批量"时也要逐篇执行、逐篇报告
扩写是增强不是替换:原笔记的正确结论必须保留,发现原文有错要显式指出并修正
篇幅服务于理解,不凑字数;每个板块都要有实质内容

Resources

写作规范复用:同一工具包内 save-to-kb/references/standards.md(Diátaxis、排版、来源标注)

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.