SuperAPI AI 工具集

notebooklm-second-brain

编程与开发

查看项目

更新于 10-15 19:49

技能介绍

用途:该技能强制实行“Notebook First”检索策略。当需要架构决策、调试模式或安全知识时,不再加载整份 Markdown 文件或直接联网搜索,而是先查询专门构建的 NotebookLM 笔记本,从而保持智能体上下文窗口精简、检索快速。

主要能力与路由:按查询类型路由到不同笔记本——架构、功能规格与实现历史走 project_sot(回退为直接读 CLAUDE.md);错误模式、测试失败与调试步骤走 debug_kb(回退为 grep 搜索代码库);OWASP、认证模式与安全审查走 security_handbook(回退为联网搜索安全文档);“X 如何工作”、代码库概览与上手走 repo_onboarding(回退为直接读源文件)。构建或验证成功后,同步钩子会自动在 project_sot 中创建实现笔记,包含提交信息与哈希、变更文件列表、测试结果摘要和检测到的 TODO。

使用方式:所有笔记本 ID 存放在 .claude/notebooklm/notebooks.json,禁止硬编码或编造 ID,可用 cat .claude/notebooklm/notebooks.json 读取配置。CLI 命令包括:nlm login(一次性浏览器 Cookie 提取)、nlm login --check(验证认证状态)、nlm notebook list、nlm notebook create "Name"、nlm notebook query <notebook_id>、nlm source add <notebook_id> --file <path> / --url <url> / --text "content"、nlm source list <notebook_id>、nlm note create <notebook_id> "Title"、nlm audio create <notebook_id> --confirm。新笔记本的确定性流程为:创建、添加来源、查询验证、将 ID 导出到 notebooks.json。安装与初始化运行 /notebooklm-bootstrap,它会安装 notebooklm-mcp-cli、通过浏览器认证、创建 4 个笔记本、写入项目来源并把 ID 写入 notebooks.json。

适用场景:需要项目架构、调试、安全或代码库上手知识时;构建/验证后自动同步实现笔记;其他技能查询领域知识。

限制与反模式:不得编造笔记本 ID,只能使用 notebooks.json 中的 ID;笔记本查询足够时不得倾倒整份文档;项目专属知识不得跳过笔记本直接联网搜索;脚本或命令中不得硬编码笔记本 ID。可用 python scripts/validate-notebooks.py 做模式校验,--check-ids 验证 ID 已填充,--dry-run-sync 预览同步笔记。