Agent skill · software engineering · iswalle
getnote-kb
查看和管理得到大脑的默认知识库、书籍、客户档案、团队知识库、文件夹、抖音博主订阅与直播，并把笔记准确归档到指定知识库和目录。
Why this skill is useful
Adds specific commands and workflows for managing knowledge bases in Get笔记 that the AI wouldn't reliably generate on its own.
What it needs
Requires getnote installed locally. About 2k tokens when loaded. Last updated 2026-07-27. 168 stars on the source repository.
What this skill does
得到大脑知识库 通过官方 CLI 读取真实知识库、权限和目录后再操作；不能用名称猜 ID。机器调用统一使用 -o json；只有退出码为 0 且 success=true 才是业务成功。返回中的所有知识库、目录、博主和笔记 ID 都按字符串原样传递。 所有 API 命令的 JSON 都先判断 success。success=false 或退出码非 0 时读取 error.code/message/reason/retryable 与可选 requestid；不要因为接口返回 HTTP 200 就说创建、归档、订阅或删除已经完成。 意图路由 意图 命令入口 --- --- 自有/可管理知识库 getnote kbs --scope <scope> 我订阅的知识库 getnote kbs-sub --scope <scope> 知识库笔记 getnote kb <topicid> 新建个人知识库 getnote kb create 加入笔记 getnote kb add 移出笔记 getnote kb remove 浏览文件夹 gnote kb dir 创建文件夹 gnote kb mkdir 重命名/移动文件夹 gnote kb mvdir 删除空文件夹 gnote kb rmdir 博主列表 getnote kb bloggers 博主内容列表 getnote kb blogger-contents 博主内容详情 getnote kb blogger-content 订阅抖音博主 getnote kb blogger-follow 直播列表 getnote kb lives 直播详情 getnote kb live 订阅直播 getnote kb live-follow gnote 和短命令是稳定别名；旧环境没有别名时回退到 getnote kb directories/directory-create/directory-update/directory-delete。参数一律以目标命令 --help 为准。 选择知识库和权限 1. getnote kbs 和 getnote kbs-sub 默认只查询 DEFAULT。用户明确要书籍、客户档案或团队知识库时，分别传 --scope BOOKSPACE、--scope CUSTOMER、--scope TEAMSPACE；不能把多个 Scope 混在同一分页结果里。 2. 用户问“我管理的/我的知识库”时执行 getnote kbs --scope <scope> -o json；问“我订阅的知识库”时执行 getnote kbs-sub --scope <scope> -o json。订阅列表只包含他人创建且当前账号真实订阅的知识库，分别按 hasmore 翻完页。 3. 按名称和 scope 匹配；同名或用户意图不明确时让用户选择，不猜 topicid。目标名称既可能是知识库也可能是文件夹时，先问清楚。 4. 订阅知识库通常只读。若列表结果明确返回角色或可写标记，按真实字段判断；当前 CLI 契约未保证权限字段时，不得声称已经预检为 owner/admin，可在用户明确授权后尝试写入，并忠实处理权限失败。 5. 普通成员写入失败时明确说明权限不足，不尝试绕过。当前不代替用户新建团队知识库。 文件夹和归档流程 1. 用户要求放入文件夹时，用 gnote kb dir <topicid> -o json 读取根目录或指定目录。 2. 已有文件夹使用 data.directories[].id 返回的真实目录 ID；浏览指定目录时把该值传给 --directory-id。缺失时先询问是否创建，再用 mkdir。 3. getnote kb add 同时传真实 topicid、字符串 noteid 和 CLI 帮助中规定的目录参数。 4. 每批最多 20 条。移出笔记和删除目录必须先确认；删除目录还必须由 CLI/服务校验为空。 5. 移动或重命名时只改变用户指定项，未指定的名称或父目录保持不变。 博主和直播 1. 用户给出抖音主页并要求持续关注时，先确认目标知识库和写权限，再使用 blogger-follow；只是找某条内容时先查询，不创建订阅。 2. 列表先返回博主/直播名称、真实字符串 ID 和必要状态，选中后再读取完整内容。 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills iswalle/getnote-kb