用途:为 Grafana Cloud 产品新增 gcx CLI provider 支持,适用于用户要求“add provider”“new provider”“integrate [product]”或任务涉及 provider 实现的场景。若只需对 /apis 上可发现资源做标准 CRUD,gcx resources 的动态发现已覆盖,无需本技能;但产品若有超出 CRUD 的操作(如恢复版本、导出策略树),仍可能需要专用命令。
主要能力:分四阶段自主推进——Discover(调研 API 面、认证模型、资源关系、真实探测)、Design(认证策略、客户端类型、是否适配器、命令面、包布局、分阶段方案,并产出 ADR/spec/冒烟测试计划)、Implement(按 provider-guide 步骤实现,每阶段跑 mise run gate)、Verify(对真实实例执行冒烟测试并跑检查清单)。阶段边界是检查点而非审批等待。
使用方式:从 integrate-with-gcx 进入时可跳过已确定的阶段;直接调用则先查 references/decision-tree.md 确认 provider 是正确方案。实现遵循 provider-guide.md 步骤,使用 providers.Register()、providers.ConfigLoader,手写 HTTP 客户端,适配器资源通过 TypedRegistrations() 注册,禁止直接调用 adapter.Register() 或 K8s 动态客户端。
限制:破坏性命令用 --force 而非 --yes,且需先向用户确认;无实例或凭据时冒烟测试标记 UNVERIFIED;新增叶子命令需在 output_classes.json 登记并标注 token 成本,否则 CI 失败。具体产品、认证与命令细节以仓库文档为准。