用途:该技能面向 Semantic Link Labs 库的贡献者,指导如何向库中添加新函数,包括新增 API 包装函数、工具函数、扩展现有功能,以及向 admin、report、lakehouse 等子模块添加函数。
主要能力:说明函数分类与对应位置,如顶层函数位于 src/sempy_labs/_*.py,admin 函数位于 src/sempy_labs/admin/,report 函数位于 src/sempy_labs/report/,lakehouse 函数位于 src/sempy_labs/lakehouse/,Direct Lake 函数位于 src/sempy_labs/directlake/,TOM 方法位于 src/sempy_labs/tom/_model.py。提供函数模板、常用导入、修改/删除资源及长时间运行操作的常见模式,并说明导出、测试与文档要求。
使用方式:先查找 API 文档,可运行 cd .claude/skills/rest-api-patterns/scripts 后执行 python search_public_api_doc.py "your search query",例如 python search_public_api_doc.py "workspace users" --source fabric。随后选择合适位置创建函数,使用 @log 装饰器、类型提示、numpydoc 风格文档字符串,并借助 _base_api、resolve_workspace_name_and_id 等辅助函数;在模块或主包的 init.py 中导出,编写测试,提交前检查命名规范、格式与文档构建。
适用场景:为库实现新的 API 包装或工具函数时使用。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分细节需参考官方文档与仓库示例。