docs(lark-shared): route pin/clear-session-identity intents from eval evidence

Two skill-eval failures on the final acceptance run, both fixed at the
smallest possible surface:

- A pure standing instruction ("run everything as tenant A from now
  on") triggers no tool call, so only the frontmatter description is
  visible — and the main description has no profile/tenant trigger
  words, leaving the body's routing table unloaded (eval case 2, agent
  answered with an unactionable promise). Add one 14-word clause:
  pinning/clearing a profile/tenant identity for a task or session.
  This partially revisits the earlier description revert, now backed by
  a concrete discovery failure rather than speculation.
- The body routing table only routed the SET direction; add the reverse
  entry: clearing the session identity -> unset LARKSUITE_CLI_PROFILE
  (session-scoped, idempotent; never profile use / profile remove)
  (eval case 4).

Skill eval rerun: 7/7 PASS.
This commit is contained in:
luozhixiong
2026-07-15 17:31:37 +08:00
committed by review
parent 16ed51252e
commit 51f3f07f44

View File

@@ -1,7 +1,7 @@
---
name: lark-shared
version: 1.0.0
description: "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."
description: "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, handling _notice JSON, or pinning/clearing a profile/tenant identity for a task or session (--profile, LARKSUITE_CLI_PROFILE)."
---
# lark-cli 共享规则
@@ -128,7 +128,7 @@ lark-cli auth login --device-code <device_code>
## Profile 选择
Profile 选择:查当前实际生效身份 → `whoami --json`;查 OAuth 登录 / token 有效性 → `auth status --json --verify`agent 任务 → 每条 `lark-cli` 命令都加 `--profile <profile-or-appId>`;同一 shell 的脚本 / 批处理 → 用 `LARKSUITE_CLI_PROFILE=<profile-or-appId>` 或 export/unset查已保存的配置非当前生效`config show` / `profile list`;永久改默认 → `profile use`。profile 不明确时先问用户;除非用户提供了直连凭证,否则不要设置 `LARKSUITE_CLI_APP_ID` / `LARKSUITE_CLI_APP_SECRET`
Profile 选择:查当前实际生效身份 → `whoami --json`;查 OAuth 登录 / token 有效性 → `auth status --json --verify`agent 任务 → 每条 `lark-cli` 命令都加 `--profile <profile-or-appId>`;同一 shell 的脚本 / 批处理 → 用 `LARKSUITE_CLI_PROFILE=<profile-or-appId>` 或 export/unset清掉会话临时身份 / 恢复默认 → `unset LARKSUITE_CLI_PROFILE`(会话级、幂等;变量不存在时也向用户点明该机制,不要用 `profile use` / `profile remove`查已保存的配置(非当前生效)→ `config show` / `profile list`;永久改默认 → `profile use`。profile 不明确时先问用户;除非用户提供了直连凭证,否则不要设置 `LARKSUITE_CLI_APP_ID` / `LARKSUITE_CLI_APP_SECRET`
## 更新检查