SuperAPI AI 工具集

capture-learning

写作与研究

查看项目

更新于 10-19 16:19

技能介绍

该技能用于把用户分享的技术领悟、调试根因、工具或系统的实际行为记录到 Logseq 笔记库(路径 /Users/hw/logseq)。

触发条件

手动:用户明确说“document this”“capture this learning”“save this realization”“TIL”或类似表述。

自动:在以下情况下主动捕获(捕获后再确认):用户分享了一个结果并不显而易见的调试根因(例如“turns out ignore_changes doesn't apply to computed attributes”);用户对某事物的运作方式表示惊讶或纠正(“I didn't know”“oh interesting”“huh”“good to know”“wait so X actually…”);用户发现了此前未遇到过的命令行参数、配置项或工具行为;用户的心智模型发生转变;用户解决了一个令人困惑的 Bug,而修复过程揭示了系统的实际行为。此时技能会先捕获学习点,再提示类似“I've saved this to your Logseq vault — let me know if you'd like to adjust the wording.”。

不触发的情况:没有新见解的例行改动(简单重构、拼写修正、直白任务);用户显然早已掌握、只是在向助手解释的信息;二手信息(同事或他人发现的内容);并非针对用户技术栈或项目的通用最佳实践;用户只是在提问而非分享领悟。

执行流程

  1. 概括学习点:形成简洁清晰的说明(是什么、为何如此、相关上下文或代码片段)。条目首行须以描述学习点的有意义文本开头,而非以标签开头;相关标签放在行尾或嵌套块中。
  2. 搜索相关内容(优先命名空间):在新建页面或默认使用日记前,用 grep_search、glob 在 /Users/hw/logseq 中查找已有相关页面,寻找匹配的命名空间(如与主题相关的 learnings___ 或 projects___ 页面)。
  3. 应用 Logseq 约定:必须激活并使用 logseq-organization 技能,根据搜索结果格式化并放置笔记。若存在相关页面,则追加到最相关页面下合适的标题;若无相关页面且学习点较小/孤立,则写入当天日记的 - ## #learnings 标题下;若无相关页面且学习点重要或构成完整新主题,则询问用户是否新建专门的学习页面(如 pages/learnings___<topic-name>.md)。
  4. 关联来源上下文:捕获学习点时始终链接相关项目页面(如 [[projects/personal/saalnaama]]),尤其在日记中,以便保留学习点的来源上下文。
  5. 写入笔记库:使用文件写入工具将格式化条目追加或写入 /Users/hw/logseq 中选定的文件。
  6. 确认:向用户简要确认,并展示所保存内容的片段。

学习点示例

“Terraform write-only resources for secrets don't store state in the clear.”

“Drupal canvas stores its content as base64-encoded strings in a specific database table.”

“Kubernetes VerticalPodAutoscaler evicts pods to apply new resource requests.”