Agent Skills
› supabase/supabase
supabase/supabase
GitHub维护 Supabase API 类型声明，处理 OpenAPI 模式变更及部署漂移。指导通过代码生成和验证生产环境一致性，确保类型文件与生产规格同步。
Install All Skills
npx skills add supabase/supabase --all -g -y
Skills in Collection (37)
维护 Supabase API 类型声明，处理 OpenAPI 模式变更及部署漂移。指导通过代码生成和验证生产环境一致性，确保类型文件与生产规格同步。
修改生成的 API 类型声明
更新 OpenAPI 模式
调查 API 类型部署漂移
npx skills add supabase/supabase --skill api-types -g -y
用于撰写或审核应用内用户界面文案，包括按钮、标签、空状态、错误提示等。在发布或审查前加载，确保文案符合语音语调规范及最佳实践。
需要编写 UI 界面文案
审查现有用户可见文本
npx skills add supabase/supabase --skill copywriting -g -y
提供开发工具栏及特征标志相关的PR代码审查指南，涵盖环境守卫、Cookie覆盖、遥测安全和SSE流防护，确保本地和预发环境的安全性与正确性。
审查涉及 packages/dev-tools/ 的变更
审查 posthog-client.ts 或 feature-flags.tsx 的修改
npx skills add supabase/supabase --skill dev-toolbar-review -g -y
用于重构、重组和优化现有 Supabase 文档页面，提升清晰度与结构。适用于编辑、整理文本或拆分 PR 场景，不涉及新功能创作或 PR 审核。
要求编辑或重组文档
需要精简文本或增加段落衔接
请求将大修改拆分为多个 PR
npx skills add supabase/supabase --skill edit-the-docs -g -y
用于本地审查 Supabase 文档变更，支持开放 PR 的分级验证与自审。涵盖 MDX 内容、构建输出及工具链检查，确保文档质量。
审查文档 PR
本地自审分支
npx skills add supabase/supabase --skill review-the-docs -g -y
指导编写、运行和调试 Supabase Studio 的 Playwright E2E 测试。涵盖环境配置、命令执行、选择器最佳实践及稳定性优化，用于确保前端交互质量。
编写新的 E2E 测试
运行或调试失败的 Playwright 测试
npx skills add supabase/supabase --skill studio-e2e-tests -g -y
定义 Supabase Studio 错误处理模式，涵盖数据层分类、UI 组件展示及故障排查步骤集成。
前端 UI 需要显示 API 请求失败或查询错误
为新的错误类型添加故障排查指南
从错误状态连接 AI 调试助手
npx skills add supabase/supabase --skill studio-error-handling -g -y
提供 Supabase Studio 组件测试的 MSW 网络层 Mock 模板，替代 vi.mock，涵盖 React Query 测试及常见陷阱。
编写涉及 API 调用的 React 组件测试
审查或重构使用 vi.mock 的旧测试
npx skills add supabase/supabase --skill studio-mock-api-tests -g -y
定义 Supabase Studio 中基于 React Query 的数据获取规范，涵盖查询键、查询选项及突变钩子的标准化结构与类型安全实践。
编写或审查数据获取钩子
实现新的 API 端点查询或突变
规范前端数据请求模式
npx skills add supabase/supabase --skill studio-queries -g -y
定义 Supabase Studio 键盘快捷键的开发规范，涵盖注册、冲突检测、UI展示及搜索输入处理，确保快捷键系统的一致性与可发现性。
添加新的键盘快捷键功能
修改或重构现有快捷键逻辑
实现搜索/过滤输入的 Escape 行为
npx skills add supabase/supabase --skill studio-shortcuts -g -y
Supabase Studio 测试策略，指导单元测试、组件及 E2E 测试的选择与编写。核心原则是将逻辑提取为纯函数以便充分测试，仅对复杂 UI 交互使用组件测试，跨平台功能使用 E2E 测试。
编写新测试
决定测试类型
从组件提取可测试逻辑
审查测试覆盖率
npx skills add supabase/supabase --skill studio-testing -g -y
定义 Supabase Studio 前端 UI 设计模式，涵盖布局、表单、表格等组件的使用规范与最佳实践，指导页面构建。
构建或更新页面结构
实现表单逻辑
设计数据表格
选择 UI 组件
npx skills add supabase/supabase --skill studio-ui-patterns -g -y
定义 Supabase Studio 的 PostHog 事件追踪标准，规范事件命名、属性格式及合规审查。
实现新功能的数据埋点
审查涉及追踪代码的 PR
npx skills add supabase/supabase --skill telemetry-standards -g -y
在隔离的 Docker Compose 沙箱中运行文档中的代码片段和示例，验证 CLI、SQL 及代码的正确性，生成 PR 验证报告。
测试文档内容
事实核查代码片段
运行示例以验证
npx skills add supabase/supabase --skill test-the-docs -g -y
提供React组件组合模式指南，用于重构布尔属性泛滥、构建灵活组件库及设计可复用API。涵盖复合组件、渲染属性、上下文提供者及React 19新特性，提升代码可维护性与扩展性。
重构包含大量布尔属性的组件
构建可复用的组件库
审查组件架构设计
使用复合组件或上下文提供者
npx skills add supabase/supabase --skill vercel-composition-patterns -g -y
提供Vitest测试框架的API参考与配置指南，涵盖Jest兼容接口、Mock、断言、快照及覆盖率等核心功能。用于解答单体仓库中关于Vitest使用、配置及最佳实践的问题。
询问Vitest API用法
配置Vitest测试环境
编写单元测试或集成测试
npx skills add supabase/supabase --skill vitest -g -y
为Supabase新功能或发布撰写全新文档内容。基于产品意图（Linear）、代码实现和风格指南，确保内容准确且符合规范。适用于需要从零创建内容的场景，而非修复现有错误或重构页面。
需要为新功能编写全新文档
需要为产品发布准备文档内容
根据Linear工单创建新内容
npx skills add supabase/supabase --skill write-the-docs -g -y
负责编写或审查 Monorepo 中所有 UI 文案（按钮、标签、错误提示等），确保符合设计规范与语气标准，适用于发布前或代码审查阶段。
需要生成或优化用户界面文案时
在代码审查中涉及用户可见文本的变更时
npx skills add supabase/supabase --skill copywriting -g -y
提供开发工具栏及特征标志集成的PR审查清单，涵盖环境守卫、Flag覆盖Cookie和遥测事件订阅的安全检查，确保生产环境安全。
审查涉及 packages/dev-tools/ 的 PR
审查修改 posthog-client.ts 或 feature-flags.tsx 的代码变更
npx skills add supabase/supabase --skill dev-toolbar-review -g -y
用于编写、编辑和组织 Supabase 文档内容，涵盖指南、教程、参考文档及故障排除条目。支持 MDX/TOML 创作、前端配置、术语规范检查及文档验证。
需要撰写或修改 Supabase 技术文档
检查文档格式、术语和链接规范
整理文档导航结构
npx skills add supabase/supabase --skill docs-content -g -y
用于编写、运行和调试 Supabase Studio 的 Playwright E2E 测试。涵盖环境配置、选择器最佳实践及 CI/本地差异处理，旨在提升前端 UI 自动化测试的稳定性和可维护性。
编写新的 E2E 测试用例
运行或调试失败的 Playwright 测试
优化测试选择器策略
npx skills add supabase/supabase --skill studio-e2e-tests -g -y
定义 Supabase Studio 的错误处理与展示模式，涵盖错误分类、UI 渲染及故障排查步骤，指导如何正确集成 ErrorMatcher 组件。
需要显示 API 请求或查询失败的 UI 提示
为新的错误类型添加故障排查步骤
从错误状态接入 AI 助手调试按钮
npx skills add supabase/supabase --skill studio-error-handling -g -y
提供 Supabase Studio 组件测试模板，使用 MSW 在 Network 层拦截 API 请求。指导开发者避免 vi.mock，覆盖 React Query 钩子测试及 jsdom/MSW 常见陷阱。
编写涉及网络请求的 React 组件测试
审查或迁移现有测试至 MSW 模式
npx skills add supabase/supabase --skill studio-mock-api-tests -g -y
定义 Supabase Studio 中基于 React Query 的数据获取规范，涵盖查询键、选项及突变钩子的标准写法与类型安全实践。
编写或审查数据获取相关的 Hook 和查询键
为新的 API 端点添加首次数据获取或突变逻辑
npx skills add supabase/supabase --skill studio-queries -g -y
Supabase Studio测试策略，指导编写单元测试、组件及E2E测试，核心原则是将逻辑提取至纯工具函数进行测试。
编写新测试
决定测试类型
提取组件逻辑
审查测试覆盖率
npx skills add supabase/supabase --skill studio-testing -g -y
提供Supabase Studio的设计系统UI模式指南，涵盖页面布局、表单、表格等组件的选择与规范。
构建或更新页面
设计表单和表格
选择UI组件和布局
npx skills add supabase/supabase --skill studio-ui-patterns -g -y
定义 Supabase Studio 的 PostHog 事件追踪标准，规范事件命名、属性格式及代码实现模式，用于指导新功能追踪开发及 PR 合规审查。
实现新功能的事件追踪
审查涉及追踪逻辑的 PR
npx skills add supabase/supabase --skill telemetry-standards -g -y
提供React组件组合模式指南，用于解决布尔属性泛滥、构建可复用组件库及设计灵活API。涵盖复合组件、状态提升和React 19新特性，旨在提升代码的可维护性和扩展性。
重构包含大量布尔属性的组件
构建可复用的组件库
审查组件架构
设计灵活的组件API
npx skills add supabase/supabase --skill vercel-composition-patterns -g -y
用于构建和修改 Studio Explorer 界面组件，包括笔记本、聊天、SQL 代码片段及查询单元格的 UI 实现。提供工具栏和查询外壳的标准化导入与组合模式，确保 UI 一致性与布局规范。
开发或修改 Studio Explorer 相关 UI 组件
构建笔记本、聊天或 SQL 查询单元格界面
使用 Explorer 工具栏或查询外壳布局
npx skills add supabase/supabase --skill explorer -g -y
针对Supabase docs应用架构、构建管线及MDX流程的咨询助手，提供代码复用与极简主义原则指导，支持生成Mermaid架构图。
询问docs应用架构或行为机制
涉及apps/docs目录的代码编写前检查
LLM/Agent内容消费相关咨询
PR审查时的规范校验
npx skills add supabase/supabase --skill ask-the-docs -g -y
用于编写、审查和迁移 Supabase Logs Explorer 的 ClickHouse SQL 查询，支持从 BigQuery 转换及代码集成。
Logs Explorer SQL 查询
BigQuery 日志查询转 ClickHouse
查询 log source 或 log_attributes
npx skills add supabase/supabase --skill clickhouse-logs-queries -g -y
为文档编写提供决策支持，确定目标受众、产品阶段及跨仓库范围。辅助判断是否需PM审批或自行解决，提升文档策划阶段的准确性与效率。
规划新文档页面或发布前的受众与阶段定义
判断文档问题是否需要PM审批
查询跨多个产品仓库的文档覆盖范围
npx skills add supabase/supabase --skill pm-the-docs -g -y
规范 React Hook Form 在单体仓库中的正确用法，涵盖数据流、订阅机制及状态管理。旨在纠正广泛存在的反模式，确保表单组件性能与逻辑正确性，防止构建失败。
编写或修改任何表单代码
向现有表单添加字段
使用 watch/useWatch/formState/getValues/setValue/reset 等 API
将表单集成到对话框或侧边栏中
构建提交/取消页脚
npx skills add supabase/supabase --skill react-hook-form -g -y
规范 Supabase Studio 中 SQL 执行的安全模型，通过 SafeSqlFragment 类型区分硬编码、用户生成及第三方可控 SQL，防止注入攻击，确保仅执行经证明由用户撰写的 SQL。
编写或编辑涉及 SQL 构建、返回或执行的代码
处理可能受外部输入影响的 SQL 片段
实现 SQL 编辑器或策略应用功能
npx skills add supabase/supabase --skill safe-sql-execution -g -y
用于编写、审查及迁移 Supabase ClickHouse 日志查询的 Skill，支持 Logs Explorer SQL 编写、BigQuery 至 ClickHouse 迁移及 Studio 代码集成。
Logs Explorer SQL 编写与审查
将 BigQuery 日志查询迁移至 ClickHouse
在 Studio 代码中集成分析日志 SQL
npx skills add supabase/supabase --skill clickhouse-logs-queries -g -y
规范 React Hook Form 使用，纠正数据流、订阅及状态管理中的反模式。指导正确读写表单值与状态，避免性能问题与构建失败，适用于任何涉及表单编写或修改的场景。
编写或修改任何表单代码
向现有表单添加字段
使用 watch/useWatch/formState/getValues/setValue/reset 等 API
将表单集成到对话框或抽屉中
npx skills add supabase/supabase --skill react-hook-form -g -y
定义 Supabase Studio 中 SQL 执行的安全模型，通过 provenance tracking 区分硬编码、用户输入及第三方影响的可信度，防止 SQL 注入风险。
构建或执行针对真实数据库的 SQL 查询
处理 URL 参数或 LLM 输出的动态 SQL 拼接
开发 SQL 编辑器、策略应用或片段运行器等涉及 SQL 文本交互的功能
npx skills add supabase/supabase --skill safe-sql-execution -g -y
