本文へ移動
cccskills
無料GitHub で公開

lark-shared

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON.

larksuite/cli
インストール方法を見る

含まれるファイル（7）

  • SKILL.md4.2 KB
  • references/lark-shared-config-init.md980 B
  • references/lark-shared-high-risk-approval.md2.0 KB
  • references/lark-shared-identity-and-permissions.md5.7 KB
  • references/lark-shared-output-contract.md933 B
  • references/lark-shared-update-notice.md1.0 KB
  • references/lark-wiki-token-routing.md2.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

lark-cli 共享规则

所有 lark-* skill 共享的底座：身份、认证、输出契约与高风险操作。

通用准则

  1. 调用前先确认用法：执行前读对应 reference 或跑 --help，别猜 flag 盲调。

  2. 身份决定你代表谁操作：--as user 代表用户本人（能看到、也能操作其日历、云空间/云盘/云存储等个人资源），--as bot 代表应用自己，应用级操作，只能访问bot自己的资源，bot 查用户资源会返回空成功而非报错。动手前先搞清楚身份identity。身份模型和权限管理 → lark-shared-identity-and-permissions.md。

  3. 授权 / 配置类 URL 必须配二维码：当命令输出 verification_url、verification_uri_complete、console_url 等 URL 字段时，必须用 lark-cli auth qrcode 生成并在回复中展示，URL 在前二维码在后；优先生成 PNG（--output），仅当用户明确要求时才使用 ASCII（--ascii）。URL 原样转发——不编解码、不加标点、不重拼 query，二维码和链接请一起展示给用户。

  4. --format json（默认）下，判断成功用 ok == true（或进程退出码 0），不要用 code == 0：成功信封没有顶层 code / msg 字段，code 只出现在错误信封的 error 内。按 OpenAPI 老格式 {"code": 0, "msg": "ok"}判断会把所有成功调用误判为失败——封装写入类命令时尤其危险。JSON 输出契约 → lark-shared-output-contract.md。

安全规则

  1. 禁止输出密钥（appSecret、accessToken等）到终端明文。

  2. 写入/删除操作前必须确认用户意图。

  3. 目标命令支持 --dry-run 时，用 --dry-run 预览危险请求。

  4. 退出码 10 是高风险确认门禁（risk: "high-risk-write"），不是错误：停下 → 向用户确认（展示 action、risk 和关键参数）→ 取得用户显式同意后，将 hint 指出的确认 flag 追加到你原始 argv 的末尾后重试；绝不静默加确认 flag 绕过 → lark-shared-high-risk-approval.md。

  5. 文件路径只接受相对路径：--file、--output、--output-dir、@file 等路径参数只接受 cwd 下的相对路径，传绝对路径会报 unsafe file path。数据输入（@file、大 JSON）优先用 stdin 传入，避免路径和转义问题。

Reference 强触发索引

命中任一触发条件时，MUST 在执行下一步前读取对应 reference。命中多条时按表中顺序读取，同一reference只读取一次。

强触发条件（命中任一即必读）Reference
查看自己是谁(user/bot)、获取当前身份详细字段信息、身份诊断、--as选择逻辑、身份延续、登录态、认证、scope、授权和权限管理、missing_scopes 或 console_url、Agent 准备发起或完成 auth loginlark-shared-identity-and-permissions.md
需要依赖 JSON 输出契约判断成功 / 失败、读取 stdout / stderr，或为命令编写脚本与封装lark-shared-output-contract.md
准备执行high-risk-write(高风险操作)、判断命令风险等级、遇到退出码 exit 10、confirmation_required、确认后重试lark-shared-high-risk-approval.md
首次使用CLI需运行 lark-cli config init 完成应用配置、或 CLI 明确提示 config init --newlark-shared-config-init.md
用户询问 notice、CLI版本更新、或输出含 _notice（升级 / skills 落后 / 废弃命令提示）lark-shared-update-notice.md

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

lark-approval

無料

飞书审批：查询和处理审批待办/已办/实例，搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务；非审批类待办走 lark-task。不负责创建审批定义；三方审批定义不走原生提单。

日本語の概要は準備中です。原文の説明を表示しています。

larksuite/cli1.8万2026年10月9日 更新

lark-apps

無料

妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用协作者与协作权限设置、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要开发/新建一个系统·工具·平台·应用，或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接，或用 HTML 做页面·网站·部署到妙搭，或要设计 / design / mockup / prototype / wireframe / 做 PPT / deck / 视觉探索，或提到妙搭/Spark/Miaoda（应用运行时域名形如 *.aiforce.cloud）、应用数据库、应用文件存储、开放 API Key、可见范围、应用协作者/开发权限、应用角色/角色成员、线上日志、接口请求量、错误量、延迟、访问量、环境变量、给妙搭应用配自动化任务/定时触发/审批通过后自动触发时使用。不负责普通云盘文件上传（lark-drive）、飞书文档编辑（lark-doc）、原生幻灯片创建（lark-slides）。

日本語の概要は準備中です。原文の説明を表示しています。

larksuite/cli1.8万2026年10月9日 更新

lark-attendance

無料

飞书考勤打卡：查询自己的考勤打卡记录

日本語の概要は準備中です。原文の説明を表示しています。

larksuite/cli1.8万2026年10月9日 更新

lark-base

無料

飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限、模板中心（多维表格模板分类/列表/搜索）；遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入/导出转 lark-drive，认证/授权转 lark-shared。

日本語の概要は準備中です。原文の説明を表示しています。

larksuite/cli1.8万2026年10月9日 更新

lark-calendar

無料

飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-meeting）、待办任务（走 lark-task）。

日本語の概要は準備中です。原文の説明を表示しています。

larksuite/cli1.8万2026年10月9日 更新

lark-contact

無料

飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名,以及按关键词搜索当前用户可见的机器人 / 智能体(agent)。当用户提到一个名字要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部门树遍历、按部门列员工、组织架构图,这类需求走原生 OpenAPI。

日本語の概要は準備中です。原文の説明を表示しています。

larksuite/cli1.8万2026年10月9日 更新

larksuite のスキルをすべて見る

このスキルの問題を報告する