DriftaBot Registry Skill
DriftaBot Registry (https://github.com/DriftaBot/registry) is a public registry that:
- - Tracks 59+ API providers (Stripe, GitHub, Twilio, Slack, Shopify, and many more)
- Crawls specs daily from each provider's canonical GitHub repository
- Generates markdown drift reports when breaking changes are detected
When to use this skill
- - User asks "did X API change?", "what broke in Y's API?", "show me drift for Z"
- User wants to know which providers are tracked in the registry
- User asks about current API spec versions or types (OpenAPI, GraphQL, gRPC)
How to query the registry
Base URL: INLINECODE0
1. List all providers
Fetch
{BASE}/provider.companies.yaml and parse the YAML.
Each entry has:
name (slug),
display_name,
specs[].type,
specs[].repo.
2. Get a drift report for a provider
Fetch
{BASE}/drifts/{org}/{repo}/result.md
- - Find
org/repo from the provider's specs[].repo field in provider.companies.yaml - Example: stripe → repo
stripe/openapi → fetch INLINECODE10 - If the file returns 404 or empty, no breaking changes were detected for that provider.
3. Get the current spec file
Fetch
{BASE}/companies/providers/{name}/{type}/{filename}
Example queries and responses
"Did Stripe's API break anything?"
→ Fetch drifts/stripe/openapi/result.md and summarize the breaking changes.
"What API providers are tracked?"
→ Fetch provider.companies.yaml, list all company names and their spec types.
"What type of spec does Shopify use?"
→ Find shopify in provider.companies.yaml, return specs[].type (graphql).
Tool usage
Use the web tool (or bash with curl) to fetch URLs. Parse YAML with available tools.
Always look up the repo from provider.companies.yaml before constructing drift URLs.
DriftaBot 注册表技能
DriftaBot 注册表（https://github.com/DriftaBot/registry）是一个公共注册表，具备以下功能：
- - 追踪 59 个以上的 API 提供商（Stripe、GitHub、Twilio、Slack、Shopify 等）
- 每天从每个提供商的官方 GitHub 仓库抓取规范文档
- 检测到破坏性变更时生成 Markdown 格式的漂移报告
使用此技能的时机
- - 用户询问X API 是否发生变化？、Y 的 API 中哪些内容被破坏？、显示 Z 的漂移情况
- 用户想知道注册表中追踪了哪些提供商
- 用户询问当前 API 规范版本或类型（OpenAPI、GraphQL、gRPC）
如何查询注册表
基础 URL：https://raw.githubusercontent.com/DriftaBot/registry/main
1. 列出所有提供商
获取 {BASE}/provider.companies.yaml 并解析 YAML 文件。
每个条目包含：name（标识符）、display_name、specs[].type、specs[].repo。
2. 获取提供商的漂移报告
获取 {BASE}/drifts/{org}/{repo}/result.md
- - 从 provider.companies.yaml 中提供商的 specs[].repo 字段查找 org/repo
- 示例：stripe → 仓库 stripe/openapi → 获取 drifts/stripe/openapi/result.md
- 如果文件返回 404 或为空，则表示该提供商未检测到破坏性变更。
3. 获取当前规范文件
获取 {BASE}/companies/providers/{name}/{type}/{filename}
- - 示例：companies/providers/stripe/openapi/stripe.openapi.json
示例查询与响应
Stripe 的 API 是否破坏了任何内容？
→ 获取 drifts/stripe/openapi/result.md 并总结破坏性变更。
追踪了哪些 API 提供商？
→ 获取 provider.companies.yaml，列出所有公司名称及其规范类型。
Shopify 使用什么类型的规范？
→ 在 provider.companies.yaml 中查找 shopify，返回 specs[].type（graphql）。
工具使用
使用 web 工具（或带 curl 的 bash）获取 URL。使用可用工具解析 YAML。
在构建漂移 URL 之前，务必先从 provider.companies.yaml 中查找仓库信息。
