SuperAPI AI 工具集

capture-knowledge

通用与其它

查看项目

更新于 10-15 17:18

技能介绍

用途:在某个软件项目中把学到的可复用、跨项目技术知识(代码、对话或调查所得)提炼成一篇 Obsidian 笔记,供以后在其他项目中使用。

主要能力:解析本机 Obsidian 库路径(库名为 Main,路径因机器而异,绝不硬编码);缓存路径于 ~/.config/capture-knowledge/config.json;笔记统一写入 <VAULT_PATH>/03-Notes/Generated/,用标签而非子文件夹分类;写入固定 frontmatter(created/updated/type/tags/source-project/source-repo),tags 中 generated 必为首项,后接 1–4 个小写主题标签;标题按用户会搜索的方式命名,正文须泛化、不绑定单一项目,源项目只记入 frontmatter;遇同名笔记时显式选择扩展、取代(旧笔记改名加 superseded 日期)或跳过。

使用方式:解析路径顺序为「读缓存 → 一次性调用 Obsidian CLI 并询问确认 → 直接询问用户」;确认后写入缓存: VAULT_PATH=$(python3 -c "import json,os,sys; p=os.path.expanduser('~/.config/capture-knowledge/config.json'); print(json.load(open(p))['vault_path']) if os.path.exists(p) else None" 2>/dev/null) mkdir -p ~/.config/capture-knowledge python3 -c "import json,os; p=os.path.expanduser('~/.config/capture-knowledge/config.json'); json.dump({'vault_path': '$VAULT_PATH'}, open(p, 'w'), indent=2)" 时间戳用:python3 -c "from datetime import datetime; print(datetime.now().astimezone().isoformat(timespec='seconds'))" 写文件推荐直接用 Write 工具写绝对路径,不依赖 Obsidian 在运行;仅当需要打开、全库搜索或触发模板时才用 CLI(二进制 /usr/local/bin/obsidian,须 Obsidian 运行并启用 Shortcut Launcher)。

适用场景:跨项目复用的技术做法、配置、集成经验与坑点。限制:CLI 报 no instance found 时退回文件系统写入;缓存按机器保存、不跨机同步;不编造代码或链接;正文不放行内标签,不覆盖既有笔记。