Agent Skills：源码里的操作手册

Agent Skills：源码里的操作手册

skills/ 是 lark-cli 的 Agent-Native 证据。它不是把 README 交给模型，而是为不同业务域准备独立 SKILL.md、references、脚本和资产。

当前 Skill 列表

当前 checkout 下有 27 个 SKILL.md：

类型Skills
基础lark-shared
业务域lark-calendar、lark-im、lark-doc、lark-drive、lark-markdown、lark-sheets、lark-slides、lark-base、lark-task、lark-mail、lark-contact、lark-wiki、lark-vc、lark-minutes、lark-note、lark-attendance、lark-approval、lark-okr、lark-apps、lark-whiteboard、lark-event
Agent 工具lark-openapi-explorer、lark-skill-maker、lark-vc-agent
Workflowlark-workflow-meeting-summary、lark-workflow-standup-report

README 文案里同时出现过“24 structured Skills”和“26 AI Agent Skills”的说法，而源码当前可数到 27 个 SKILL.md。这类差异很正常：仓库迭代快，笔记应以源码目录为准。

lark-shared 的位置

lark-shared 是基础 Skill：配置、鉴权、身份切换、scope、安全规则都应在这里集中。其他领域 Skill 只需要描述自己的业务任务和命令模式，避免每个文件重复解释登录和风险规则。

这和 Go 代码里的 Factory 很像：一个为人和模型读，一个为命令执行注入依赖。

Skills 和命令如何互相约束

一个好的领域 Skill 应该和三层命令对应：

  1. 优先告诉 Agent 用 +shortcut；
  2. shortcut 不覆盖时，指向 typed API command；
  3. 新端点或预览端点才建议 lark-cli api ...；
  4. 写入或删除必须提醒 --dry-run、--yes、scope 和身份。

源码里还配了 internal/qualitygate/skillscan 和 workflow skill-format-check.yml，说明 Skills 被当作可测试资产，而不是仓库附属文档。

下一篇：鉴权、身份与 Profile。