- name
SKILL.md
Le fichier du skill reste dans le dépôt de l'éditeur.
Collez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add Pinvou/pinvou-agent --skill lark-shared -a cursor -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add Pinvou/pinvou-agent --skill lark-shared -a claude-code -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add Pinvou/pinvou-agent --skill lark-shared -a codex -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add Pinvou/pinvou-agent --skill lark-shared -a grok -yEnvoyez le message copié dans un chat Grok Bot. Le Bot récupère ce SKILL.md sur GitHub et l'ajoute aux skills que partagent tous vos Bots.
Install this skill: https://github.com/Pinvou/pinvou-agent/tree/HEAD/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-sharedDe l'éditeur
所有 lark-* skill 共享的底座:身份、认证、输出契约与高风险操作。
调用前先确认用法:执行前读对应 reference 或跑 --help,别猜 flag 盲调。
身份决定你代表谁操作:--as user 代表用户本人(能看到、也能操作其日历、云空间/云盘/云存储等个人资源),--as bot 代表应用自己,应用级操作,只能访问bot自己的资源,bot 查用户资源会返回空成功而非报错。动手前先搞清楚身份identity。身份模型和权限管理 → lark-shared-identity-and-permissions.md。
授权 / 配置类 URL 必须配二维码:当命令输出 verification_url、verification_uri_complete、console_url 等 URL 字段时,必须用 lark-cli auth qrcode 生成并在回复中展示,URL 在前二维码在后;优先生成 PNG(--output),仅当用户明确要求时才使用 ASCII(--ascii)。URL 原样转发——不编解码、不加标点、不重拼 query,二维码和链接请一起展示给用户。
--format json(默认)下,判断成功用 ok == true(或进程退出码 0),不要用 code == 0:成功信封没有顶层 code / msg 字段,code 只出现在错误信封的 error 内。按 OpenAPI 老格式 {"code": 0, "msg": "ok"}判断会把所有成功调用误判为失败——封装写入类命令时尤其危险。JSON 输出契约 → lark-shared-output-contract.md。
CLI 未安装 / 未登录时不要自行排障:lark-cli 命令不存在或执行报「找不到命令」时,由品悟应用代管安装——不要自行安装或升级,提示用户在品悟「插件中心 → 飞书(Lark)」卡片重新点「连接」,由应用完成安装/升级后重试。未登录、登录态过期或权限不足时,按 lark-shared-identity-and-permissions.md 的按需授权两段式处理(发起授权的回合只发链接,不在同一轮跑阻塞式登录;后续轮按该 reference 完成 --device-code 登录),也不要因未登录直接断定技能不可用。
限流(rate limit)默认处理:错误码 / 错误消息命中 rate_limit、99991400、HTTP 429,或 hint 提示频率受限时,不要立即重试:按返回的 retry_after_seconds / hint 等待后做指数退避,总尝试次数控制在约 3 次(1 次初始 + 2 次重试)以内;批量 / 分页场景改用更小批次、放慢翻页规避。个别接口有专属限流口径的(如 drive 导出任务的等待与续查规则),以对应 reference 为准。
禁止输出密钥(appSecret、accessToken等)到终端明文。
写入/删除操作前必须确认用户意图。
目标命令支持 --dry-run 时,用 --dry-run 预览危险请求。
退出码 10 是高风险确认门禁(risk: "high-risk-write"),不是错误:停下 → 向用户确认(展示 action、risk 和关键参数)→ 取得用户显式同意后,将 hint 指出的确认 flag 追加到你原始 argv 的末尾后重试;绝不静默加确认 flag 绕过 → lark-shared-high-risk-approval.md。
文件路径只接受相对路径:--file、--output、--output-dir、@file 等路径参数只接受 cwd 下的相对路径,传绝对路径会报 unsafe file path。数据输入(@file、大 JSON)优先用 stdin 传入,避免路径和转义问题。
临时文件一律写 tmp/ 子目录,别落工作目录根:CLI 入参、API 响应、分步数据等中间文件,统一写到 cwd 下的 tmp/ 子目录(如 --data @tmp/params.json、lark-cli ... > tmp/resp.json,相对路径仍合法)。原因:工作目录根的文件会被当作「产出物」展示给用户,过程文件会污染产物列表。能用 stdin 不落文件就别落;必须落就放 tmp/(必要时先 mkdir -p tmp)。
命中任一触发条件时,MUST 在执行下一步前读取对应 reference。命中多条时按表中顺序读取,同一reference只读取一次。
【何时用:在其他 lark-* 技能遇到认证/授权/身份/配置问题、被要求前置读取,或首次使用 lark-cli 时;泛指需求默认走本地工具】lark-cli 共享规则:首次配置(config init)、认证登录(auth login --domain/--scope,split-flow)、登录态查询与撤销(auth status/logout/whoami)、--as user/bot 身份
---name: lark-shareddescription: 【何时用:在其他 lark-* 技能遇到认证/授权/身份/配置问题、被要求前置读取,或首次使用 lark-cli 时;泛指需求默认走本地工具】lark-cli 共享规则:首次配置(config…---# pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-shared/SKILL.mdVue d'ensemble
【何时用:在其他 lark-* 技能遇到认证/授权/身份/配置问题、被要求前置读取,或首次使用 lark-cli 时;泛指需求默认走本地工具】lark-cli 共享规则:首次配置(config init)、认证登录(auth login --domain/--scope,split-flow)、登录态查询与撤销(auth status/logout/whoami)、--as user/bot 身份切换、权限不足/未安装/限流默认处理、JSON 输出契约与 _notice、update 更新、高风险操作审批(exit 10)。
FAQ
Téléchargez pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-shared/SKILL.md auprès de l'éditeur, ou copiez le chemin et ouvrez le dépôt. PlugMCP répertorie le skill et n'héberge pas le fichier.
L'éditeur le maintient sur https://github.com/Pinvou/pinvou-agent.
Claude, Cursor, Codex et Grok Build peuvent lire un SKILL.md que vous ajoutez depuis le dépôt de l'éditeur. Grok Bot l'installe lorsque vous envoyez dans un chat le lien du dossier GitHub du skill.