顺带小知识 · 知识归档
把 AI 助手在每次任务结尾附的「💡 顺带小知识」(用大白话 + 生活类比讲的知识点),
归档成你个人的「顺带小知识」学习笔记,方便日后复习与回顾。
🔘 开关(Toggle)— 每次执行前先读这个
本 skill 有一个总开关,存在 skill 目录的 config.json 里:
{ "enabled": true }
每次开始执行任何「顺带小知识」相关行为前,先读这个文件:
enabled === true→ 正常模式:任务后显示「顺带小知识」并自动归档(见下)。enabled === false→ 完全静默模式:- 不在回复里追加任何「💡 顺带小知识」小节;
- 不自动把新小知识归档到日期文件;
- 仍保留归档规则知识,但不主动触发任何显示/归档动作。
- 例外:用户明确点名要归档某条知识(如"把这条存一下"),仍照常执行。
如何切换开关(用户说以下任一句即切换,改完 config.json 并口头确认):
| 用户意思 | 说的话举例 | 动作 |
|---|---|---|
| 关掉 | "关闭顺带小知识" / "暂停小知识" / "关掉学习模式" / "暂时不要小知识" | 写 {"enabled": false} |
| 打开 | "开启顺带小知识" / "恢复小知识" / "打开学习模式" / "继续学小知识" | 写 {"enabled": true} |
> 写文件用 Edit/Write 工具改 config.json 的 enabled 字段即可,不要碰别的字段。
🆕 首次使用前必做(重要,面向新用户)
本 skill 不会"自己冒出小知识"——它依赖助手养成「每次任务结尾附一段顺带小知识」的习惯。
新用户装上 skill 后,必须在自己的用户级记忆文件 ~/.workbuddy/MEMORY.md 末尾补一句话:
> 每次完成任务后,结尾追加一个「💡 顺带小知识」小节(用大白话 + 生活类比,讲一个与用户兴趣领域相关的、容易看懂的知识点;兴趣领域见 xiaozhishi skill 的 config.json 的 topic 字段,默认"编程"),并按 xiaozhishi skill 的归档规则存入当日文件。
- 没补这句话 → 助手不会自动产出小知识,skill 看起来"没反应"(这是最多人踩的坑)。
- 补完开个新对话即可生效,无需改本 skill。
- 详细说明见本 skill 目录下的
README.md。
> 若用户首次触发本 skill 时,从对话上下文判断他可能还没做这一步(例如他说"我用这个 skill 怎么没东西"),
> 先温和提醒他补上面那句话,并给出完整文本;同时主动提议:"要我直接帮你写进 MEMORY.md 吗?"
> 用户同意(如回"加""好的""帮我加")后,用 Edit/Write 工具把上面那句话追加到 ~/.workbuddy/MEMORY.md 末尾,
> 并告知"已写好,开个新对话就生效"。不要未经确认就改用户的 MEMORY.md;也不要直接报错中断。
🎯 兴趣领域(可配置,默认"编程")
本 skill 不只会讲编程。用户可以让小知识围绕自己感兴趣的任意领域展开(烹饪、摄影、理财、历史、心理学……)。
- 领域来源:skill 目录
config.json的topic字段,默认"编程"。 - 产出时读取
topic:每次要附「💡 顺带小知识」时,内容必须围绕topic所指领域,用大白话 + 生活类比讲清一个知识点;不要硬套编程。 - 例:
topic= "家常菜" → 讲"为什么煮面要等水开再下面"(用生活类比讲清一个烹饪原理)。 - 例:
topic= "摄影" → 讲"光圈越大背景越虚"(用生活类比讲清一个摄影概念)。 - 切换领域(用户说以下任一句即改
config.json的topic并口头确认):
| 用户意思 | 说的话举例 | 动作 |
|---|---|---|
| 换成某领域 | "我的兴趣是摄影" / "把小知识换成做饭" / "我想看理财相关的" | 写 topic: "<领域>" |
| 不想看编程 | "别讲编程了" / "不要编程小知识" | 写 topic: "<用户指定领域>" |
| 查询当前领域 | "我现在的小知识是什么领域?" | 读 config.json 的 topic 并告诉用户 |
- 改
topic后,后续所有小知识都按新领域产出;归档格式不变。 - 说明:
topic是内容方向,不是任务类型。用户让 AI 做任何任务,结尾的小知识都按topic走,与"本次任务"是否相关均可。
何时使用
- 先判定开关:读
config.json的enabled。若为false,除用户明确点名外,不做任何显示/归档,直接结束本 skill 流程。 - 用户完成一个任务后,对话里产出了新的「💡 顺带小知识」→ 追加归档(低摩擦,直接做)。
- 用户想回顾、补录、修订历史小知识。
归档规则
- 存储位置:项目目录下
shun-dai-xiao-zhishi/,每天一个 md 文件,文件名加xzs_前缀(如xzs_YYYY-MM-DD.md)。 - 时间窗口:北京时间 9:00–22:00 产生的内容记当日;22:00 之后归入次日。
(生成日期文件名前,先用 shell 取北京时间:TZ='Asia/Shanghai' date +'%Y-%m-%d %H:%M',
若 ≥22:00 则文件名用次日日期。) - 原始记录 = 对话原文:完整复制对话里写给用户的那段「💡 顺带小知识」,
不做任何精简/润色,原样保留(这是 source of truth)。 - 一条小知识 = 原始记录(对话原文,原样保留)。
标准操作流程
0. 首次初始化(每次执行前先检查,幂等,不报错)
- 检查当前项目目录下是否存在
shun-dai-xiao-zhishi/文件夹: - 不存在 → 用
references/daily-template.md的骨架自动创建该目录,并用references/notes-readme-template.md在该目录下生成一份README.md(纯知识归档版,模板自带,不依赖任何外部文件),
并在回复里轻描淡写提一句"已为你建好顺带小知识笔记目录shun-dai-xiao-zhishi/"。 - 已存在 → 跳过,什么都不做。
- 降级容错原则:任何一步缺前置条件时,走"能做的先做 / 缺的就跳过并说明",而不是中断报错。具体:
- 当天日期文件不存在 → 自动新建(见 A.2),不报错。
- 项目里没有
learning-plan.md→ 跳过索引同步(A.5 标记为可选,缺则不做),不影响主流程。 - 取北京时间失败(无
date命令 / 无 TZ 支持)→ 回退用本地系统时间生成日期文件名,并在该条原始记录旁注明"时间以本地时区为准"。 - 用户未做「首次使用前必做」那一步 → 见上方「首次使用前必做」节,温和提醒而非报错。
A. 追加归档一条新小知识(无需询问)
- 取北京时间判断归属日期(见时间窗口规则)。
- 若当天日期文件不存在,用
references/daily-template.md建立;存在则追加。 - 在文件末尾按
## #N 标题追加,原始记录处原样粘贴对话原文,序号在当天内递增。 - 更新文件头部「今日共 N 条」。
- (可选,缺则跳过)若项目里有
learning-plan.md的「顺带小知识索引」,同步加一行导航。
注:learning-plan.md是可选的进阶学习路线图,与本 skill 核心功能无关,没有也完全不影响使用。
参考文件
references/daily-template.md— 每日文件模板