用途:将一次对话中的一个洞察沉淀为项目本地(project-local)的结构化 Markdown 文档,存放在仓库的 IDE 目录中,随代码库一起提交,便于该项目后续会话找到。适合调试突破、非显而易见的配置/构建设置、运维流程(部署/回滚)、复盘教训。
边界:项目本地的调试/配置/工作流/教训笔记放这里;全局可复用知识(架构、设计模式、API 集成、参考资料)属于 llm-wiki。KC 的 promote 命令可在文档确有价值时将其移入 wiki。不适用于:跨项目知识、可复用技能、AI 规则,也不用于更新已保存文档(KC 为一次性写入)。
前提:Node.js ≥ 18;项目根目录含 IDE 标记目录 .trae/、.claude/、.cursor/ 或 .windsurf/。
常用命令:node scripts/cli.cjs save
-r <project_root>
-a <ai_type>
-t <type>
-n <kebab-slug>
--title "Short, specific title"
--summary "2-3 sentences readers can stop at"
--details "Body in Markdown."
--takeaways "First actionable insight\nSecond insight"
[--background "<one-line problem context>"]
[--context "<project / version / component>"]
[--related "<links / files>"]
命令返回新文件绝对路径,自动解析按日期排序的文件名、创建目录、填充模板并校验必填字段。-a/--ai-type 可选 trae、trae-cn、claude-code(或 claude)、cursor、windsurf;-t/--type 仅限 debug、config、workflow、lesson;-n/--name 为 kebab-case slug,≤50 字符且具体。输出文件名为 {YYYYMMDD}{NNN}{type}_{slug}.md,位于 <root>/<ide>/knowledges/ 下。
promote:node scripts/cli.cjs promote -p <project>/.trae/knowledges/20260511_001_debug_x.md,会复制到 ~/.learnwy/llm-wiki/raw/notes/<date>-<slug>.md 并带指回原文的 frontmatter;wiki 未初始化时为空操作。另有 path 子命令仅打印解析后的路径。
Stop 钩子:扫描助手最后回复中的解决信号(如 "the bug was…"、"fixed it"、"## Solution"),若同时出现实质性标记且无琐碎标记,则在每会话注入一次提醒,从不自动写入。
写作规则:标题回答"能学到什么";摘要自洽;代码块带语言标签;要点用祈使句;相关链接指向源文件、PR 或 [[wiki-page]]。
限制:本技能仅检测 IDE 标记、解析唯一文档路径、原子写入、推入 llm-wiki 队列、显示一次 Stop 提醒;不更新已有文档,不做索引/校验/策展,不保存跨会话 AI 记忆,也不能搜索历史知识文档。具体安装方式、收费与平台信息暂未提供。