lark-wiki

Installation
SKILL.md

wiki (v2)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理

成员管理硬限制:

  • 如果目标是“部门”,先判断身份,再决定是否继续。
  • --as bot 对应 tenant_access_token。官方限制:这种身份下不能使用部门 ID (opendepartmentid) 添加知识空间成员。
  • 遇到“部门 + --as bot”时,禁止先调用 lark-cli wiki members create 试错;直接说明该路径不可行。
  • 如果用户明确要求“以 bot 身份运行”,且目标是部门,必须停下说明 bot 路径无法完成,不要静默切到 --as user

快速决策

  • 用户给的是知识库 URL(.../wiki/<token>),且后续要查成员/加成员/删成员:先调用 lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}' 获取 space_id,后续成员接口统一使用 space_id
  • 用户要删除知识空间(wiki +delete-space)但只给了名称或 URL:不能把名称 / URL 原样传给 --space-id,必须先解析出真实 space_id。解析方式:
    • URL(.../wiki/<token>):lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}' --format json,读 data.node.space_id
    • 只知名称:lark-cli wiki spaces list --format json,边翻页边收集 items 并按 name 精确匹配;一旦任一页累计到至少 1 条精确匹配就停止翻页。只有当翻完所有页(has_more=false)仍无精确匹配时,才对已收集的全量 items 做宽松匹配(name trim 空格、大小写不敏感、子串包含)。
    • 关键安全约束:无论精确还是模糊,无论命中 1 条还是多条,发起删除前都必须把候选(name + space_id + description + space_type)列给用户,由用户明确选定一个 space_id 再执行。不要因为"只命中一条"就自动执行删除。
    • 命中 0 条:停下来问用户是名称拼错了还是调用方无权限;不要自行改名字重试。
    • 用户明确选定后再执行 lark-cli wiki +delete-space --space-id <ID> --yes(高风险写操作,必须显式 --yes)。
Related skills

More from larksuite/cli

Installs
117.4K
Repository
larksuite/cli
GitHub Stars
9.7K
First Seen
Mar 28, 2026