总结：按源码贡献 lark-cli

总结：按源码贡献 lark-cli

这组笔记的主线可以收成一句话：lark-cli 把飞书开放平台包装成三层命令系统，又用 schema、skills、typed errors 和安全门禁把它变成 Agent 可操作的工具面。

源码心智模型

flowchart LR
  User[人 / Agent] --> Root[cmd/root.go]
  Root --> Build[cmd/build.go]
  Build --> Shortcuts[shortcuts/*]
  Build --> Service[cmd/service]
  Build --> Raw[cmd/api]
  Service --> Registry[internal/registry]
  Registry --> Catalog[internal/apicatalog]
  Catalog --> Schema[cmd/schema]
  Shortcuts --> Output[internal/output]
  Service --> Output
  Raw --> Output
  Output --> Errs[errs]
  Skills[skills/lark-*] --> User

贡献时先判断改哪一层

需求优先改哪里
高频任务更好用shortcuts/<domain> + 对应 Skill
某个 OAPI 参数/响应不对metadata / registry / schema 链路
新端点未覆盖先看 typed API command 是否能由 metadata 覆盖，兜底用 api
Agent 调用经常失败Skill、affordance、schema、错误 hint
输出不稳定internal/output 和 errs/ERROR_CONTRACT.md
高风险动作不够安全risk metadata、--dry-run、--yes、qualitygate
事件工作流cmd/event、events/、internal/event

参考链接

全系列导航

  1. 阅读地图
  2. 安装、版本与仓库地图
  3. Root Command：启动时装配了什么
  4. Shortcuts：+ 命令为什么是第一层
  5. API Commands：从 metadata 生成命令树
  6. Raw API 与 Schema：兜底层和自省层
  7. Agent Skills：源码里的操作手册
  8. 鉴权、身份与 Profile
  9. 输出与错误契约
  10. 风险门禁与内容安全
  11. 事件、插件与质量门禁
  12. 总结：按源码贡献 lark-cli