Files
larksuite-cli/skill-template/skill-template.md
huangmengxuan 575bcc407b feat(skill): add CRITICAL instruction to enforce reference reading before shortcut execution
Evaluation data shows AI call failure rate <1% when reference docs are
read vs ~29% when not. Add a CRITICAL line to the Shortcuts section of
14 SKILL.md files and the skill template, requiring agents to read the
linked reference doc (or run -h for commands without one) before
invoking any shortcut.

Change-Id: Ia4204518eb43a9f6c8295b95633ee5d9cf2f5352
2026-06-03 13:59:06 +08:00

1.3 KiB
Raw Permalink Blame History

name, version, description, metadata
name version description metadata
lark-{{project}}
meta_version
{{meta_description}}
requires cliHelp
bins
lark-cli
lark-cli {{service}} --help

{{service}} ({{version}})

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

{{introduction}} {{#shortcuts}}

Shortcuts推荐优先使用

Shortcut 是对常用操作的高级封装(lark-cli {{service}} +<verb> [flags])。有 Shortcut 的操作优先使用。

CRITICAL — 执行任何 Shortcut 之前MUST 先用 Read 工具读取下表中对应的说明文档;没有文档链接的命令须执行 -h 了解用法。禁止盲调。

Shortcut 说明 Reference
{{shortcut_rows}}
{{/shortcuts}}
{{#actions}}

API Resources

lark-cli schema {{service}}.<resource>.<method>   # 调用 API 前必须先查看参数结构
lark-cli {{service}} <resource> <method> [flags] # 调用 API

重要:使用原生 API 时,必须先运行 schema 查看 --data / --params 参数结构,不要猜测字段格式。

{{resource_sections}}

权限表

方法 所需 scope
{{permission_rows}}
{{/actions}}