飞书多维表格 AgentSkills(v2 离线文档转换产物)
本套 Skills 基于 飞书多维表格开发文档-完整参考-v2.md 生成,遵循「渐进式暴露」:
- 先进入系统级 Skill 判断变更范围。
- 再进入对应模块级 Skill 执行实现/改造。
- 叠加横切 Skill 处理契约、鉴权、并发、SDK 接入。
- 最后下钻
reference/读取可溯源设计细节(含 DDS 章节与行号)。
Skill 清单(最终命名)
系统级(1)
developing-feishu-bitable-system
模块级(6)
developing-bitable-app-metadatadeveloping-bitable-table-viewdeveloping-bitable-recorddeveloping-bitable-fielddeveloping-bitable-role-memberdeveloping-bitable-event-callback
横切(4)
designing-bitable-contractsimplementing-bitable-auth-accessmanaging-bitable-write-concurrencyimplementing-bitable-go-sdk
命名候选与选择理由
| Skill | 候选名 | 选择 | 理由 |
|---|---|---|---|
| 系统级 | developing-bitable-system / developing-feishu-bitable-system / developing-lark-bitable-system |
developing-feishu-bitable-system |
同时保留平台域(feishu)和产品域(bitable),检索命中更稳定。 |
| App | developing-bitable-app / developing-bitable-app-metadata / developing-bitable-app-core |
developing-bitable-app-metadata |
文档对 App 主要是元数据与高级权限开关,metadata 语义更准确。 |
| Table/View | developing-bitable-table / developing-bitable-view / developing-bitable-table-view |
developing-bitable-table-view |
视图严格依附数据表,合并后可减少重复规则。 |
| Record | developing-bitable-record / developing-bitable-row / developing-bitable-record-crud |
developing-bitable-record |
与 OpenAPI 资源命名一致,便于映射接口。 |
| Field | developing-bitable-field / developing-bitable-schema-field / developing-bitable-column |
developing-bitable-field |
与文档“字段 Field”章节一致。 |
| Role/Member | developing-bitable-role / developing-bitable-role-member / developing-bitable-advanced-permission |
developing-bitable-role-member |
将角色与协作者放在同一模块,贴合高级权限操作闭环。 |
| Event/Callback | developing-bitable-event / developing-bitable-event-callback / developing-bitable-webhook |
developing-bitable-event-callback |
同时覆盖事件与回调两条接入路径。 |
| 契约 | designing-bitable-contracts / designing-bitable-openapi / managing-bitable-contracts |
designing-bitable-contracts |
以设计导向统一 API/错误码/资源 ID 契约。 |
| 鉴权 | implementing-bitable-auth / implementing-bitable-auth-access / managing-bitable-token-auth |
implementing-bitable-auth-access |
同时包含 token 与权限模型。 |
| 并发 | managing-bitable-concurrency / managing-bitable-write-concurrency / implementing-bitable-retry |
managing-bitable-write-concurrency |
明确聚焦写操作并发与幂等。 |
| Go SDK | implementing-bitable-sdk / implementing-bitable-go-sdk / developing-bitable-sdk-integration |
implementing-bitable-go-sdk |
技术栈指向清晰,避免多语言混淆。 |
目录约定
每个 Skill 目录均包含:
SKILL.mdreference/(按章节分层,含DDS-Section+DDS-Lines)examples/skeleton.mdscripts/verify.sh
渐进式使用建议
- 先读
developing-feishu-bitable-system/SKILL.md。 - 根据变更资源进入对应模块 Skill。
- 若涉及跨模块约束,再叠加横切 Skill。
- 编码或审查时仅按需展开目标
reference/*.md,避免一次性加载全量文档。