lark-shared SKILL.md skillA
lark-shared from pinvou/pinvou-agent is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add pinvou/pinvou-agent/lark-shared@v1.1.0Pins v1.1.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- pinvou/pinvou-agent
- Path
pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-shared/SKILL.md- Versions recorded
- 3
- Latest version
- v1.1.0, committed Oct 19, 2026
- First version recorded
- Aug 21, 2026
- Size
- 5,051 bytes
- Repository stars
- 2,770
- License
- MIT
【何时用:在其他 lark-* 技能遇到认证/授权/身份/配置问题、被要求前置读取,或首次使用 lark-cli 时;泛指需求默认走本地工具】lark-cli 共享规则:首次配置(config init)、认证登录(auth login --domain/--scope,split-flow)、登录态查询与撤销(auth status/logout/whoami)、--as user/bot 身份切换、权限不足与 missing_scope 处理、JSON 输出契约与 _notice、update 更新、高风险操作审批(exit 10)。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# lark-cli 共享规则
所有 `lark-*` skill 共享的底座：身份、认证、输出契约与高风险操作。
## 通用准则
1. **调用前先确认用法**：执行前读对应 reference 或跑 `--help`，别猜 flag 盲调。
2. **身份决定你代表谁操作**：`--as user` 代表用户本人（能看到、也能操作其日历、云空间/云盘/云存储等个人资源），`--as bot` 代表应用自己，应用级操作，只能访问bot自己的资源，bot 查用户资源会返回空成功而非报错。动手前先搞清楚身份`identity`。身份模型和权限管理 → [`lark-shared-identity-and-permissions.md`](references/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`](references/lark-shared-output-contract.md)。
## 安全规则
1. **禁止输出密钥**（appSecret、accessToken等）到终端明文。
2. **写入/删除操作前必须确认用户意图**。
3. 目标命令支持 `--dry-run` 时，用 `--dry-run` 预览危险请求。
…Read the whole file at its exact version.
How to install
mdr add pinvou/pinvou-agent/lark-shared@sha256:be31328ecef91e2cThe line at the top of this page pins the label v1.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_sinksydy72yv7qpw)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Aug 21, 2026 and Oct 19, 2026, about one every 29 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.1.0 latest | 2026-10-19 | 18f8dd9 | 5,051 B | A | view · diff |
| v1.1.0 | 2026-09-16 | 0f50a98 | 5,033 B | A | view · diff |
| v1.0.0 | 2026-08-21 | c75f2fb | 14,332 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5051 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
pinvou/pinvou-agent · 2,770 stars · license MIT · pushed 2026-10-31 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_sinksydy72yv7qpw GET https://markdownregistry.com/api/v1/resolve?ref=pinvou/pinvou-agent/lark-shared GET https://markdownregistry.com/api/v1/blob/be31328ecef91e2c8087fa1e338069216288b0c22edd65c2250de8f92b7433b5
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from pinvou/pinvou-agent
Every file in pinvou/pinvou-agent